AnKing-VIP / advanced-browser

Anki add-on with card browser enhancements.
GNU General Public License v3.0
58 stars 13 forks source link
note to future maintainers

To build an .ankiaddon file that's suitable for uploading to ankiweb run python3 release.py.

On Ankiweb in 2023-10 there are 6 different versions of the Advanced Browser add-on for different Anki versions:

Ankiweb version corresponding branch in this repo
2.1.0-2.1.22 maintenance_for_00-22
2.1.24-2.1.34 maintenance_for_24-34
2.1.35-2.1.40 maintenance_for_35-40
2.1.41-2.1.44 maintenance_for_41-44
2.1.45-2.1.66 maintenance_for_45-66
23.10 or newer master

Up to 2022-09 this repo only used the master branch for fixing bugs in AB and adjustments to newer Anki versions. This made it hard to fix bugs in AB for older Anki versions. So ijgnd created the branches outlined in the table above in 2022-09. In each branch there's the file release.py to create an .ankiaddon file.

 

Advanced Browser

Link to add-on on AnkiWeb.

Advanced Browser is an Anki add-on that adds more features to the browser. It allows you to add a variety of new, sortable columns to the card browser. These columns range from:

Note fields

Feature notice

The note browser mode (show a single card per note) for Anki versions 2.1.24-2.1.44 has been moved to a separate add-on maintained by another developer (@Arthur-Milchior). If you rely on this feature, you can download the add-on Browser have one line by note from ankiweb (GitHub: anki-browser-for-note). A "notes only" mode is built into Anki 2.1.45 or newer.

How to use

Right click on any of the currently visible columns and a menu will appear. Some new menu items will now appear in the list.

Copying table content

By setting "Table content" to "Selectable", you'll be able to select table content by double clicking on it. This way, you can copy it. Note that editing the content has no effect.

Editing the table

By setting "Table content" to "Editable" you can edit the content of some elements of the tables. You need to activate this feature in the configuration before being able to use it. It can be dangerous if you don't really know what you're doing and this feature is not widely used and tested. Please see the document [edition in table](edition in table.md) to see what editing each column does.

Internal fields

You can also show some fields used internally by Anki but probably aren't very useful for the typical user. These are disabled by default, but you can enable them in the add-on config by setting "Show internal fields" to true.

Help and suggestions

New column?

If you have a good idea for a new column, please open a new issue on GitHub. If you are a developer and would like to add it yourself, please see advanced_fields.py as it's the most likely place you'd want to put it. Contributions are more than welcome!

Add-on author?

If you are an add-on author and would like to add a new column in your own add-on, then doing so is easy through Advanced Browser. Advanced Browser is designed to let add-ons add their own columns through a standard Anki hook. In fact, Advanced Browser uses this same hook to offer its own columns, so you already have a working example to look at. Your own add-on can easily add its own columns provided your user also has Advanced Browser installed.