diff --git a/resources/catalog/debug/META-INF/container.xml b/resources/catalog/debug/META-INF/container.xml
new file mode 100644
index 0000000000..6ebe7b2ea2
--- /dev/null
+++ b/resources/catalog/debug/META-INF/container.xml
@@ -0,0 +1,6 @@
+
+
If you want all of your library cataloged, remove any search or filtering criteria by clearing the Search: field 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 Excluded genres section below for more information.
@@ -107,117 +107,8 @@ h3 {Extra note specifies a custom column's contents to be inserted into the Description, opposite the cover. For example, you might want to display the date you last read a book using a Last Read custom column. For advanced use of the Description note feature, see this post in the calibre forum.
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 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. Eligible custom column types include text, comments, and composite.
If you wish to change the default appearance of the Description pages or Section lists, you can do so by modifying a local copy of the catalog's template and CSS files, overriding the default layout. This requires familiarity with HTML and CSS.
-
Customizing the Description page. Available fields in template.xhtml:
-
Example: Changing year of publication in Description header
-
Customizing the Section lists. Templates controlling the display of book titles in the various Section lists (Books by Author, Books by Title, etc) may be edited to taste.
- Available fields in section_list_templates.py:
-
Example: Changing Books by Author to remove year of publication:
- Default:
<img>
-Code:
-
by_authors_normal_title_template = '{title} {pubyear_parens}'
-
by_authors_series_title_template = '[{series_index}] {title} {pubyear_parens}'
-
Year of publication removed:
-Code:
- by_authors_normal_title_template = '{title}'
- by_authors_series_title_template = '[{series_index}] {title}'
- Rating added:
Code:
- by_authors_normal_title_template = '{title} {rating}'
- by_authors_series_title_template = '[{series_index}] {title} {rating}'
Tips for experimenting with customization:
- Work with a small subset of your catalog, 5-10 books
- If you are experimenting with Section list templates, disable Descriptions in E-book options - catalog generation will be much faster.
- If you are experimenting with CSS, build an EPUB version of your catalog, explode it with the Tweak EPUB feature to find the class of the element you want to change.
-
+
For more information on calibre's Catalog feature, see the MobileRead forum sticky Creating Catalogs - Start here, where you can also find information on how to submit a bug report.
+To ask questions or discuss calibre's Catalog feature with other users, visit the MobileRead forum Calibre Catalogs.