The main idea of this plugin is to enable the users to tag items (authors, tags, series, publisher ... etc) in the same way they can tag the books, by making use of user categories. There are two ways to do this in the plugin:
- The plugin offers a dialog based on calibre's tag editor that enables you to tag items the same way you tag books. (see attached screenshot)
The dialog is accessed by right clicking on an item in calibre's tag browser and choosing the category tags action. The plugin will apply the user categories to the selected item. If the user category is not present in calibre it will created by the plugin, this also applies to hierarchical.
- The plugin offers import/export functionality that enables mass tagging of items as well as transferring user categories between libraries. More on this below.
Import/Export user categories- The plugin offers import/export functionality. This allows the user to export his user categories into csv file, edit them as he wants, and re-import them back again into calibre
- In the csv file you can tag your items (authors, series, tags, .... etc) with whatever user categories you want.
- The action currently offers two different csv formats:
- The first format is "Items for category". This format allows you to apply a certain tag (i.e user category) for multiple items at once. Say for example you have a list of Nobel Laureates and want to use it to create a user category "Awards.Nobel", this is illustrated below
Code:
---------------------------------------------------------------------------------------------------
category item_type items
---------------------------------------------------------------------------------------------------
Awards.Nobel authors Gabriel Garcia Marquez & Naguib Mahfouz & ....
Genre.Fantasy series discworld ::: Wheel of Time ::: .....
Quote:
Note: when using "Items for category" format, you should use the following to separate different items:- "&" for authors and author like columns.
- ", " for tags and tag-like columns.
- ":::" for series and text columns.
|
- The Second format is "Categories for item". This format allows you to apply a multiple tags (i.e user categories) to an item as illustrated below:
Code:
---------------------------------------------------------------------------------------------------
item item_type categories
---------------------------------------------------------------------------------------------------
Naguib Mahfouz authors Awards.Nobel, Nationality.Egyptian, .....
Gabriel Garcia Marquez authors Awards.Nobel, Nationality.Colombian, .....
- The plugin will create the categories for you even if they are not already in calibre.
- The items (authors, series, ... etc) in the csv file are matched to items in your calibre library based on criteria you define. By default, identical matching (case insensitive) is used. But you can configure different match criteria for each item_type. Matching is based on advanced mode of the Find Duplicates plugin, so you have the option to choose from: similar, fuzzy, soundex as well as custom match algorithms by using template match.
- After the items are matched, a dialog for manual match resolution is popped up to allow the user to modify any matches. It is based on code from the Import List plugin (Thanks to kiwidude for his awesome code).
- The default for items that have multiple matches (e.g Gabriel Garcia Marquez, Gabriel García Márquez) is to apply the categories to all the matches. There is an option to turn this off.
- As of version 0.3.0, you can export/import both links and notes, only for categories_for_item format.
Credits- User category editor is based on calibre's Tag Editor by Kovid Goyal.
- The manual resolution wizard page is based on code from the Import List plugin by kiwidude.
- Special thanks for chaley and Kovid for adding the code that add plugins to the tag browser context menu.
Installation Notes:
Special Notes:- Requires Calibre 5.24.0 or later.
Paypal Donations:- If you find this useful please feel free to show your appreciation.
Version History: