home *** CD-ROM | disk | FTP | other *** search
/ Maximum CD 2011 January / maximum-cd-2011-01.iso / DiscContents / calibre-0.7.26.msi / file_3154 < prev    next >
Encoding:
Text File  |  2010-10-26  |  10.8 KB  |  214 lines
  1. #!/usr/bin/env python
  2. # vim:fileencoding=UTF-8:ts=4:sw=4:sta:et:sts=4:ai
  3. __license__   = 'GPL v3'
  4. __copyright__ = '2010, Kovid Goyal <kovid@kovidgoyal.net>'
  5. __docformat__ = 'restructuredtext en'
  6.  
  7. '''
  8. Contains various tweaks that affect calibre behavior. Only edit this file if
  9. you know what you are doing. If you delete this file, it will be recreated from
  10. defaults.
  11. '''
  12.  
  13.  
  14. # The algorithm used to assign a new book in an existing series a series number.
  15. # Possible values are:
  16. # next - Next available number
  17. # const - Assign the number 1 always
  18. series_index_auto_increment = 'next'
  19.  
  20.  
  21.  
  22. # The algorithm used to copy author to author_sort
  23. # Possible values are:
  24. #  invert: use "fn ln" -> "ln, fn" (the original algorithm)
  25. #  copy  : copy author to author_sort without modification
  26. #  comma : use 'copy' if there is a ',' in the name, otherwise use 'invert'
  27. #  nocomma : "fn ln" -> "ln fn" (without the comma)
  28. # When this tweak is changed, the author_sort values stored with each author
  29. # must be recomputed by right-clicking on an author in the left-hand tags pane,
  30. # selecting 'manage authors', and pressing 'Recalculate all author sort values'.
  31. author_sort_copy_method = 'invert'
  32.  
  33.  
  34. # Set whether boolean custom columns are two- or three-valued.
  35. #  Two-values for true booleans
  36. #  three-values for yes/no/unknown
  37. # Set to 'yes' for three-values, 'no' for two-values
  38. bool_custom_columns_are_tristate = 'yes'
  39.  
  40.  
  41. # Provide a set of columns to be sorted on when calibre starts
  42. #  The argument is None if saved sort history is to be used
  43. #  otherwise it is a list of column,order pairs. Column is the
  44. #  lookup/search name, found using the tooltip for the column
  45. #  Order is 0 for ascending, 1 for descending
  46. # For example, set it to [('authors',0),('title',0)] to sort by
  47. # title within authors.
  48. sort_columns_at_startup = None
  49.  
  50. # Format to be used for publication date and the timestamp (date).
  51. #  A string controlling how the publication date is displayed in the GUI
  52. #  d    the day as number without a leading zero (1 to 31)
  53. #  dd    the day as number with a leading zero (01 to 31)
  54. #  ddd    the abbreviated localized day name (e.g. 'Mon' to 'Sun').
  55. #  dddd    the long localized day name (e.g. 'Monday' to 'Qt::Sunday').
  56. #  M    the month as number without a leading zero (1-12)
  57. #  MM    the month as number with a leading zero (01-12)
  58. #  MMM    the abbreviated localized month name (e.g. 'Jan' to 'Dec').
  59. #  MMMM    the long localized month name (e.g. 'January' to 'December').
  60. #  yy    the year as two digit number (00-99)
  61. #  yyyy    the year as four digit number
  62. #  For example, given the date of 9 Jan 2010, the following formats show
  63. #  MMM yyyy ==> Jan 2010    yyyy ==> 2010       dd MMM yyyy ==> 09 Jan 2010
  64. #  MM/yyyy ==> 01/2010      d/M/yy ==> 9/1/10   yy ==> 10
  65. # publication default if not set: MMM yyyy
  66. # timestamp default if not set: dd MMM yyyy
  67. gui_pubdate_display_format = 'MMM yyyy'
  68. gui_timestamp_display_format = 'dd MMM yyyy'
  69.  
  70. # Control title and series sorting in the library view.
  71. # If set to 'library_order', Leading articles such as The and A will be ignored.
  72. # If set to 'strictly_alphabetic', the titles will be sorted without processing
  73. # For example, with library_order, The Client will sort under 'C'. With
  74. # strictly_alphabetic, the book will sort under 'T'.
  75. # This flag affects Calibre's library display. It has no effect on devices. In
  76. # addition, titles for books added before changing the flag will retain their
  77. # order until the title is edited. Double-clicking on a title and hitting return
  78. # without changing anything is sufficient to change the sort.
  79. title_series_sorting = 'library_order'
  80.  
  81. # Control how title and series names are formatted when saving to disk/sending
  82. # to device. If set to library_order, leading articles such as The and A will
  83. # be put at the end
  84. # If set to 'strictly_alphabetic', the titles will be sorted without processing
  85. # For example, with library_order, "The Client" will become "Client, The". With
  86. # strictly_alphabetic, it would remain "The Client".
  87. save_template_title_series_sorting = 'library_order'
  88.  
  89. # Set the list of words that are to be considered 'articles' when computing the
  90. # title sort strings. The list is a regular expression, with the articles
  91. # separated by 'or' bars. Comparisons are case insensitive, and that cannot be
  92. # changed. Changes to this tweak won't have an effect until the book is modified
  93. # in some way. If you enter an invalid pattern, it is silently ignored.
  94. # To disable use the expression: '^$'
  95. # Default: '^(A|The|An)\s+'
  96. title_sort_articles=r'^(A|The|An)\s+'
  97.  
  98.  
  99. # Specify a folder that calibre should connect to at startup using
  100. # connect_to_folder. This must be a full path to the folder. If the folder does
  101. # not exist when calibre starts, it is ignored. If there are '\' characters in
  102. # the path (such as in Windows paths), you must double them.
  103. # Examples:
  104. #     auto_connect_to_folder = 'C:\\Users\\someone\\Desktop\\testlib'
  105. #     auto_connect_to_folder = '/home/dropbox/My Dropbox/someone/library'
  106. auto_connect_to_folder = ''
  107.  
  108.  
  109. # Specify renaming rules for sony collections. This tweak is only applicable if
  110. # metadata management is set to automatic. Collections on Sonys are named
  111. # depending upon whether the field is standard or custom. A collection derived
  112. # from a standard field is named for the value in that field. For example, if
  113. # the standard 'series' column contains the name 'Darkover', then the series
  114. # will be named 'Darkover'. A collection derived from a custom field will have
  115. # the name of the field added to the value. For example, if a custom series
  116. # column named 'My Series' contains the name 'Darkover', then the collection
  117. # will be named 'Darkover (My Series)'. If two books have fields that generate
  118. # the same collection name, then both books will be in that collection. This
  119. # tweak lets you specify for a standard or custom field the value to be put
  120. # inside the parentheses. You can use it to add a parenthetical description to a
  121. # standard field, for example 'Foo (Tag)' instead of the 'Foo'. You can also use
  122. # it to force multiple fields to end up in the same collection. For example, you
  123. # could force the values in 'series', '#my_series_1', and '#my_series_2' to
  124. # appear in collections named 'some_value (Series)', thereby merging all of the
  125. # fields into one set of collections. The syntax of this tweak is
  126. # {'field_lookup_name':'name_to_use', 'lookup_name':'name', ...}
  127. # Example 1: I want three series columns to be merged into one set of
  128. # collections. If the column lookup names are 'series', '#series_1' and
  129. # '#series_2', and if I want nothing in the parenthesis, then the value to use
  130. # in the tweak value would be:
  131. # sony_collection_renaming_rules={'series':'', '#series_1':'', '#series_2':''}
  132. # Example 2: I want the word '(Series)' to appear on collections made from
  133. # series, and the word '(Tag)' to appear on collections made from tags. Use:
  134. # sony_collection_renaming_rules={'series':'Series', 'tags':'Tag'}
  135. # Example 3: I want 'series' and '#myseries' to be merged, and for the
  136. # collection name to have '(Series)' appended. The renaming rule is:
  137. # sony_collection_renaming_rules={'series':'Series', '#myseries':'Series'}
  138. sony_collection_renaming_rules={}
  139.  
  140.  
  141. # Specify how sony collections are sorted. This tweak is only applicable if
  142. # metadata management is set to automatic. You can indicate which metadata is to
  143. # be used to sort on a collection-by-collection basis. The format of the tweak
  144. # is a list of metadata fields from which collections are made, followed by the
  145. # name of the metadata field containing the sort value.
  146. # Example: The following indicates that collections built from pubdate and tags
  147. # are to be sorted by the value in the custom column '#mydate', that collections
  148. # built from 'series' are to be sorted by 'series_index', and that all other
  149. # collections are to be sorted by title. If a collection metadata field is not
  150. # named, then if it is a series- based collection it is sorted by series order,
  151. # otherwise it is sorted by title order.
  152. # [(['pubdate', 'tags'],'#mydate'), (['series'],'series_index'), (['*'], 'title')]
  153. # Note that the bracketing and parentheses are required. The syntax is
  154. # [ ( [list of fields], sort field ) , ( [ list of fields ] , sort field ) ]
  155. # Default: empty (no rules), so no collection attributes are named.
  156. sony_collection_sorting_rules = []
  157.  
  158.  
  159. # Create search terms to apply a query across several built-in search terms.
  160. # Syntax: {'new term':['existing term 1', 'term 2', ...], 'new':['old'...] ...}
  161. # Example: create the term 'myseries' that when used as myseries:foo would
  162. # search all of the search categories 'series', '#myseries', and '#myseries2':
  163. # grouped_search_terms={'myseries':['series','#myseries', '#myseries2']}
  164. # Example: two search terms 'a' and 'b' both that search 'tags' and '#mytags':
  165. # grouped_search_terms={'a':['tags','#mytags'], 'b':['tags','#mytags']}
  166. # Note: You cannot create a search term that is a duplicate of an existing term.
  167. # Such duplicates will be silently ignored. Also note that search terms ignore
  168. # case. 'MySearch' and 'mysearch' are the same term.
  169. grouped_search_terms = {}
  170.  
  171.  
  172. # Set this to True (not 'True') to ensure that tags in 'Tags to add when adding
  173. # a book' are added when copying books to another library
  174. add_new_book_tags_when_importing_books = False
  175.  
  176.  
  177. # Set the maximum number of tags to show per book in the content server
  178. max_content_server_tags_shown=5
  179.  
  180. # Set custom metadata fields that the content server will or will not display.
  181. # content_server_will_display is a list of custom fields to be displayed.
  182. # content_server_wont_display is a list of custom fields not to be displayed.
  183. # wont_display has priority over will_display.
  184. # The special value '*' means all custom fields.
  185. # Defaults:
  186. #    content_server_will_display = ['*']
  187. #    content_server_wont_display = ['']
  188. # Examples:
  189. # To display only the custom fields #mytags and #genre:
  190. #   content_server_will_display = ['#mytags', '#genre']
  191. #   content_server_wont_display = ['']
  192. # To display all fields except #mycomments:
  193. #   content_server_will_display = ['*']
  194. #   content_server_wont_display['#mycomments']
  195. content_server_will_display = ['*']
  196. content_server_wont_display = ['']
  197.  
  198.  
  199. # Set the maximum number of sort 'levels' that calibre will use to resort the
  200. # library after certain operations such as searches or device insertion. Each
  201. # sort level adds a performance penalty. If the database is large (thousands of
  202. # books) the penalty might be noticeable. If you are not concerned about multi-
  203. # level sorts, and if you are seeing a slowdown, reduce the value of this tweak.
  204. maximum_resort_levels = 5
  205.  
  206. # Absolute path to a TTF font file to use as the font for the title and author
  207. # when generating a default cover. Useful if the default font (Liberation
  208. # Serif) does not contain glyphs for the language of the books in your library.
  209. generate_cover_title_font = None
  210.  
  211. # Absolute path to a TTF font file to use as the font for the footer in the
  212. # default cover
  213. generate_cover_foot_font = None
  214.