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.
+If you want only some of your library cataloged, you have two options:
+<img>
+Sections enabled by a checkmark will be included in the generated catalog:
+<img>
+Prefix rules specify matching criteria and a prefix to use when the criteria is matched.
+The checkbox in the first column enables the rule. Name is a rule name that you provide. Field is either Tags or a custom column in your library. Value is the content of Field to match. When a prefix rule is satisfied, the book will be marked with the selected symbol in the Prefix column.
+Three prefix rules have been specified in the example above:
+The first matching rule supplies the prefix. Disabled or incomplete rules are ignored.
+<img>
+Exclusion rules specify matching criteria for books that will not be cataloged.
+The checkbox in the first column enables the rule. Name is a rule name that you provide. Field is either Tags or a custom column in your library. Value is the content of Field to match. When an exclusion rule is satisfied, the book will be excluded from the generated catalog.
+Two exclusion rules have been specified in the example above:
+All rules are evaluated for every book. Disabled or incomplete rules are ignored.
+<img>
+When the catalog is generated, tags in your database are used as genres. For example, you may have the tags Fiction and Nonfiction applied to books in your library. These tags become genres in the generated catalog, with all tagged books showing up in their respective genre lists.
+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 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.
+You can also use the exact tag name in a regex. For example, [Amazon Freebie] will exclude that tag from the generated catalog. If you want to list multiple exact tags for exclusion, put a pipe character between them: [Amazon Freebie]|[Project Gutenberg].
+The Results field shows you which tags will be excluded when the catalog is built, based on the tags in your database and the regex you enter.
+Thumb width specifies a width preference for cover thumbnails included in the Descriptions section. Thumbnails are cached to improve performance. If you want to experiment with different widths, try generating a catalog with just a few books until you've found your optimal width, then generate your full catalog. The first time a catalog is generated with a new thumbnail width, performance will be slower, but subsequent runs will take advantage of the cache.
+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
+ Default: <td class="date">{pubyear}</td>
+ Removed: <td class="date"></td>
+ Augmented: <td class="date">Year of publication: {pubyear}</td>
+Modified: <td class="date">{pubmonth} {pubyear}</td>
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:
+ {title} - Title of the book
+ {series} - Series name
+ {series_index} - Number of the book in the series
+ {rating} - 0-5 stars
+ {rating_parens} - (0-5 stars)
+ {pubyear} - Year the book was published
+ {pubyear_parens} - (Year the book was published)
+ Example: Changing Books by Author to remove year of publication:
+Default:
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.
+
+ + diff --git a/src/calibre/devices/apple/driver.py b/src/calibre/devices/apple/driver.py index 838edb4e69..8b05fb5b8f 100644 --- a/src/calibre/devices/apple/driver.py +++ b/src/calibre/devices/apple/driver.py @@ -13,7 +13,8 @@ from calibre.constants import isosx, iswindows from calibre.devices.errors import OpenFeedback, UserFeedback from calibre.devices.usbms.deviceconfig import DeviceConfig from calibre.devices.interface import DevicePlugin -from calibre.ebooks.metadata import authors_to_string, MetaInformation, title_sort +from calibre.ebooks.metadata import (author_to_author_sort, authors_to_string, + MetaInformation, title_sort) from calibre.ebooks.metadata.book.base import Metadata from calibre.utils.config import config_dir, dynamic, prefs from calibre.utils.date import now, parse_date @@ -405,9 +406,9 @@ class ITUNES(DriverBase): @return: A BookList. Implementation notes: - iTunes does not sync purchased books, they are only on the device. They are visible, but - they are not backed up to iTunes. Since calibre can't manage them, don't show them in the - list of device books. + iTunes does not sync purchased books, they are only on the device. They are + visible, but they are not backed up to iTunes. Since calibre can't manage them, + don't show them in the list of device books. """ if not oncard: @@ -1637,9 +1638,19 @@ class ITUNES(DriverBase): logger().info('%s%s' % (' '*indent,'-' * len(msg))) for book in booklist: + tl = [i.title for i in booklist] + lt = max(tl, key=len) + al = [i.author for i in booklist] + la = max(al, key=len) + asl = [i.author_sort for i in booklist] + las = max(asl, key=len) if isosx: - logger().info("%s%-40.40s %-30.30s %-10.10s %s" % - (' '*indent,book.title, book.author, str(book.library_id)[-9:], book.uuid)) + fs = '{!s}{:<%d} {:<%d} {:<%d} {:<10} {!s}' % (' ' * indent, len(lt), + len(la), len(las)) + logger.info(fs.format(book.title, book.author, book.author_sort, + str(book.library_id)[-9:], book.uuid)) + #logger().info("%s%-40.40s %-30.30s %-10.10s %s" % + # (' '*indent,book.title, book.author, str(book.library_id)[-9:], book.uuid)) elif iswindows: logger().info("%s%-40.40s %-30.30s" % (' '*indent,book.title, book.author)) @@ -3478,6 +3489,7 @@ class Book(Metadata): ''' def __init__(self,title,author): Metadata.__init__(self, title, authors=author.split(' & ')) + self.author_sort = author_to_author_sort(author) @property def title_sorter(self): diff --git a/src/calibre/gui2/catalog/catalog_epub_mobi.py b/src/calibre/gui2/catalog/catalog_epub_mobi.py index 7c89d3e0dd..4dc42b73bd 100644 --- a/src/calibre/gui2/catalog/catalog_epub_mobi.py +++ b/src/calibre/gui2/catalog/catalog_epub_mobi.py @@ -11,13 +11,14 @@ import re, sys from functools import partial from calibre.ebooks.conversion.config import load_defaults -from calibre.gui2 import gprefs, info_dialog, question_dialog +from calibre.gui2 import gprefs, info_dialog, open_url, question_dialog from calibre.utils.icu import sort_key from catalog_epub_mobi_ui import Ui_Form from PyQt4.Qt import (Qt, QAbstractItemView, QCheckBox, QComboBox, QDoubleSpinBox, QIcon, QLineEdit, QObject, QRadioButton, QSize, QSizePolicy, - QTableWidget, QTableWidgetItem, QTextEdit, QToolButton, QVBoxLayout, QWidget, + QTableWidget, QTableWidgetItem, QTextEdit, QToolButton, QUrl, + QVBoxLayout, QWidget, SIGNAL) class PluginWidget(QWidget,Ui_Form): @@ -440,6 +441,13 @@ class PluginWidget(QWidget,Ui_Form): self.merge_after.setEnabled(False) self.include_hr.setEnabled(False) + def show_help(self): + ''' + Display help file + ''' + url = 'file:///' + P('catalog/help_epub_mobi.html') + open_url(QUrl(url)) + class CheckableTableWidgetItem(QTableWidgetItem): ''' Borrowed from kiwidude diff --git a/src/calibre/gui2/catalog/catalog_epub_mobi.ui b/src/calibre/gui2/catalog/catalog_epub_mobi.ui index f3bffb4930..28a17725df 100644 --- a/src/calibre/gui2/catalog/catalog_epub_mobi.ui +++ b/src/calibre/gui2/catalog/catalog_epub_mobi.ui @@ -268,7 +268,7 @@ The default pattern \[.+\]|\+ excludes tags of the form [tag], e.g., [Test book]