Debian Codegraph @

manual/catalogs.rst

raw
1 .. _catalog_tut:
2
3 Creating AZW3 • EPUB • MOBI catalogs
4 =====================================
5
6 calibre's Create catalog feature enables you to create a catalog of your library in a variety of formats. This help file describes cataloging options when generating a catalog in AZW3, EPUB and MOBI formats.
7
8 .. contents::
9 :depth: 1
10 :local:
11
12 Selecting books to catalog
13 -------------------------------
14
15 If you want *all* of your library cataloged, remove any search or filtering criteria in the main window. With a single book selected, all books in your library will be candidates for inclusion in the generated catalog. Individual books may be excluded by various criteria; see the :ref:`excluded_genres` section below for more information.
16
17 If you want only *some* of your library cataloged, you have two options:
18
19 * Create a multiple selection of the books you want cataloged. With more than one book selected in calibre's main window, only the selected books will be cataloged.
20 * Use the Search field or the Tag browser to filter the displayed books. Only the displayed books will be cataloged.
21
22 To begin catalog generation, select the menu item :guilabel:`Convert books > Create a catalog of the books in your calibre library`. You may also add a :guilabel:`Create catalog` button to a toolbar in :guilabel:`Preferences > Interface > Toolbars & menus` for easier access to the Generate catalog dialog.
23
24 .. image:: images/catalog_options.png
25 :alt: Catalog options
26 :align: center
27
28 In :guilabel:`Catalog options`, select **AZW3, EPUB or MOBI** as the Catalog format. In the :guilabel:`Catalog title` field, provide a name that will be used for the generated catalog. If a catalog of the same name and format already exists, it will be replaced with the newly-generated catalog.
29
30 .. image:: images/catalog_send_to_device.png
31 :alt: Catalog: send to device automatically option
32 :align: center
33
34 Enabling :guilabel:`Send catalog to device automatically` will download the generated catalog to a connected device upon completion.
35
36 Included sections
37 -------------------
38
39 .. image:: images/included_sections.png
40 :alt: Included sections in catalog
41 :align: center
42
43 Sections enabled by a checkmark will be included in the generated catalog:
44
45 * :guilabel:`Authors` - all books, sorted by author, presented in a list format. Non-series books are listed before series books.
46 * :guilabel:`Titles` - all books, sorted by title, presented in a list format.
47 * :guilabel:`Series` - all books that are part of a series, sorted by series, presented in a list format.
48 * :guilabel:`Genres` - individual genres presented in a list, sorted by Author and Series.
49 * :guilabel:`Recently Added` - all books, sorted in reverse chronological order. List includes books added in the last 30 days, then a month-by-month listing of added books.
50 * :guilabel:`Descriptions` - detailed description page for each book, including a cover thumbnail and comments. Sorted by author, with non-series books listed before series books.
51
52 Prefixes
53 ---------
54
55 .. image:: images/prefix_rules.png
56 :alt: Prefix rules
57 :align: center
58
59 Prefix rules allow you to add a prefix to book listings when certain criteria are met. For example, you might want to mark books you've read with a checkmark, or books on your wishlist with an X.
60
61 The checkbox in the first column enables the rule. :guilabel:`Name` is a rule name that you provide. :guilabel:`Field` is either :guilabel:`Tags` or a custom column from your library. :guilabel:`Value` is the content of :guilabel:`Field` to match. When a prefix rule is satisfied, the book will be marked with the selected :guilabel:`Prefix`.
62
63 Three prefix rules have been specified in the example above:
64
65 1. :guilabel:`Read book` specifies that a book with any date in a custom column named :guilabel:`Last read` will be prefixed with a checkmark symbol.
66 2. :guilabel:`Wishlist` item specifies that any book with a :guilabel:`Wishlist` tag will be prefixed with an X symbol.
67 3. :guilabel:`Library` books specifies that any book with a value of True (or Yes) in a custom column :guilabel:`Available in Library` will be prefixed with a double arrow symbol.
68
69 The first matching rule supplies the prefix. Disabled or incomplete rules are ignored.
70
71 Excluded books
72 -----------------
73
74 .. image:: images/excluded_books.png
75 :alt: Excluded books in catalog
76 :align: center
77
78 Exclusion rules allow you to specify books that will not be cataloged.
79
80 The checkbox in the first column enables the rule. :guilabel:`Name` is a rule name that you provide. :guilabel:`Field` is either :guilabel:`Tags` or a custom column in your library. :guilabel:`Value` is the content of :guilabel:`Field` to match. When an exclusion rule is satisfied, the book will be excluded from the generated catalog.
81
82 Two exclusion rules have been specified in the example above:
83
84 1. The :guilabel:`Catalogs` rule specifies that any book with a :guilabel:`Catalog` tag will be excluded from the generated catalog.
85 2. The :guilabel:`Archived` Books rule specifies that any book with a value of :guilabel:`Archived` in the custom column :guilabel:`Status` will be excluded from the generated catalog.
86
87 All rules are evaluated for every book. Disabled or incomplete rules are ignored.
88
89 .. _excluded_genres:
90
91 Excluded genres
92 ---------------
93
94 .. image:: images/excluded_genres.png
95 :alt: Excluded genres in catalog
96 :align: center
97
98 When the catalog is generated, tags in your database are used as genres. For example, you may use the tags ``Fiction`` and ``Nonfiction``. These tags become genres in the generated catalog, with books listed under their respective genre lists based on their assigned tags. A book will be listed in every genre section for which it has a corresponding tag.
99
100 You may be using certain tags for other purposes, perhaps a + to indicate a read book, or a bracketed tag like ``[Amazon Freebie]`` to indicate a book's source. The :guilabel:`Excluded genres` regex allows you to specify tags that you don't want used as genres in the generated catalog. The default exclusion regex pattern ``\[.+\]\+`` excludes any tags of the form ``[tag]``, as well as excluding ``+``, the default tag for read books, from being used as genres in the generated catalog.
101
102 You can also use an exact tag name in a regex. For example, ``[Amazon Freebie]`` or ``[Project Gutenberg]``. If you want to list multiple exact tags for exclusion, put a pipe (vertical bar) character between them: ``[Amazon Freebie]|[Project Gutenberg]``.
103
104 :guilabel:`Results of regex` shows you which tags will be excluded when the catalog is built, based on the tags in your database and the regex pattern you enter. The results are updated as you modify the regex pattern.
105
106 Other options
107 --------------
108
109 .. image:: images/other_options.png
110 :alt: Other options for catalog
111 :align: center
112
113 :guilabel:`Catalog cover` specifies whether to generate a new cover or use an existing cover. It is possible to create a custom cover for your catalogs - see :ref:`custom_catalog_covers` for more information. If you have created a custom cover that you want to reuse, select :guilabel:`Use existing cover`. Otherwise, select :guilabel:`Generate new cover`.
114
115 :guilabel:`Extra Description note` specifies a custom column's contents to be inserted into the Description page, next to the cover thumbnail. For example, you might want to display the date you last read a book using a :guilabel:`Last Read` custom column. For advanced use of the Description note feature, see `this post in the calibre forum <https://www.mobileread.com/forums/showpost.php?p=1335767&postcount=395>`_.
116
117 :guilabel:`Thumb width` specifies a width preference for cover thumbnails included with Descriptions pages. Thumbnails are cached to improve performance. To experiment with different widths, try generating a catalog with just a few books until you've determined your preferred width, then generate your full catalog. The first time a catalog is generated with a new thumbnail width, performance will be slower, but subsequent builds of the catalog will take advantage of the thumbnail cache.
118
119 :guilabel:`Merge with comments` specifies a custom column whose content will be non-destructively merged with the comments metadata during catalog generation. For example, you might have a custom column :guilabel:`Author bio` that you'd like to append to the comments metadata. You can choose to insert the custom column contents *before or after* the comments section, and optionally separate the appended content with a horizontal rule separator. Eligible custom column types include ``text, comments, and composite``.
120
121 .. _custom_catalog_covers:
122
123 Custom catalog covers
124 -----------------------
125
126 .. |cc| image:: images/custom_cover.png
127
128 |cc| With the `Generate Cover plugin <https://www.mobileread.com/forums/showthread.php?t=124219>`_ installed, you can create custom covers for your catalog.
129 To install the plugin, go to :guilabel:`Preferences > Advanced > Plugins > Get new plugins`.
130
131 Additional help resources
132 ---------------------------
133
134 For more information on calibre's Catalog feature, see the MobileRead forum sticky `Creating Catalogs - Start here <https://www.mobileread.com/forums/showthread.php?t=118556>`_, where you can find information on how to customize the catalog templates, and how to submit a bug report.
135
136 To ask questions or discuss calibre's Catalog feature with other users, visit the MobileRead forum `Library Management <https://www.mobileread.com/forums/forumdisplay.php?f=236>`_.