| 1 |
# SOME DESCRIPTIVE TITLE. |
| 2 |
# Copyright (C) Kovid Goyal |
| 3 |
# This file is distributed under the same license as the calibre package. |
| 4 |
# |
| 5 |
# Translators: |
| 6 |
msgid "" |
| 7 |
msgstr "" |
| 8 |
"Project-Id-Version: calibre\n" |
| 9 |
"Report-Msgid-Bugs-To: \n" |
| 10 |
"POT-Creation-Date: 2021-12-01 12:56+0000\n" |
| 11 |
"PO-Revision-Date: 2021-11-23 15:49+0000\n" |
| 12 |
"Last-Translator: Kovid Goyal <[email protected]>\n" |
| 13 |
"Language-Team: Afrikaans (http://www.transifex.com/calibre/calibre/language/af/)\n" |
| 14 |
"MIME-Version: 1.0\n" |
| 15 |
"Content-Type: text/plain; charset=UTF-8\n" |
| 16 |
"Content-Transfer-Encoding: 8bit\n" |
| 17 |
"Language: af\n" |
| 18 |
"Plural-Forms: nplurals=2; plural=(n != 1);\n" |
| 19 |
|
| 20 |
#: ../../__w/calibre/calibre/manual/db_api.rst:4 |
| 21 |
msgid "API documentation for the database interface" |
| 22 |
msgstr "" |
| 23 |
|
| 24 |
#: ../../__w/calibre/calibre/manual/db_api.rst:9 |
| 25 |
msgid "" |
| 26 |
"This API is thread safe (it uses a multiple reader, single writer locking " |
| 27 |
"scheme). You can access this API like this::" |
| 28 |
msgstr "" |
| 29 |
|
| 30 |
#: ../../__w/calibre/calibre/manual/db_api.rst:14 |
| 31 |
msgid "" |
| 32 |
"If you are in a calibre plugin that is part of the main calibre GUI, you get" |
| 33 |
" access to it like this instead::" |
| 34 |
msgstr "" |
| 35 |
|
| 36 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 37 |
#: calibre.db.cache.Cache:1 |
| 38 |
msgid "" |
| 39 |
"An in-memory cache of the metadata.db file from a calibre library. This " |
| 40 |
"class also serves as a threadsafe API for accessing the database. The in-" |
| 41 |
"memory cache is maintained in normal form for maximum performance." |
| 42 |
msgstr "" |
| 43 |
|
| 44 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 45 |
#: calibre.db.cache.Cache:5 |
| 46 |
msgid "" |
| 47 |
"SQLITE is simply used as a way to read and write from metadata.db robustly. " |
| 48 |
"All table reading/sorting/searching/caching logic is re-implemented. This " |
| 49 |
"was necessary for maximum performance and flexibility." |
| 50 |
msgstr "" |
| 51 |
|
| 52 |
#: ../../__w/calibre/calibre/src/calibre/db/listeners.pydocstring of |
| 53 |
#: calibre.db.listeners.EventType:1 |
| 54 |
msgid "An enumeration." |
| 55 |
msgstr "" |
| 56 |
|
| 57 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 58 |
#: calibre.db.cache.Cache.add_books:1 |
| 59 |
msgid "" |
| 60 |
"Add the specified books to the library. Books should be an iterable of " |
| 61 |
"2-tuples, each 2-tuple of the form :code:`(mi, format_map)` where mi is a " |
| 62 |
"Metadata object and format_map is a dictionary of the form :code:`{fmt: " |
| 63 |
"path_or_stream}`, for example: :code:`{'EPUB': '/path/to/file.epub'}`." |
| 64 |
msgstr "" |
| 65 |
|
| 66 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 67 |
#: calibre.db.cache.Cache.add_books:6 |
| 68 |
msgid "" |
| 69 |
"Returns a pair of lists: :code:`ids, duplicates`. ``ids`` contains the book " |
| 70 |
"ids for all newly created books in the database. ``duplicates`` contains the" |
| 71 |
" :code:`(mi, format_map)` for all books that already exist in the database " |
| 72 |
"as per the simple duplicate detection heuristic used by :meth:`has_book`." |
| 73 |
msgstr "" |
| 74 |
|
| 75 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 76 |
#: calibre.db.cache.Cache.add_custom_book_data:1 |
| 77 |
msgid "" |
| 78 |
"Add data for name where val_map is a map of book_ids to values. If " |
| 79 |
"delete_first is True, all previously stored data for name will be removed." |
| 80 |
msgstr "" |
| 81 |
|
| 82 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 83 |
#: calibre.db.cache.Cache.add_format:1 |
| 84 |
msgid "" |
| 85 |
"Add a format to the specified book. Return True if the format was added " |
| 86 |
"successfully." |
| 87 |
msgstr "" |
| 88 |
|
| 89 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 90 |
#: calibre.db.cache.Cache.add_format:0 |
| 91 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 92 |
#: calibre.db.cache.Cache.cover:0 |
| 93 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 94 |
#: calibre.db.cache.Cache.format:0 |
| 95 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 96 |
#: calibre.db.cache.Cache.format_metadata:0 |
| 97 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 98 |
#: calibre.db.cache.Cache.get_next_series_num_for:0 |
| 99 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 100 |
#: calibre.db.cache.Cache.remove_formats:0 |
| 101 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 102 |
#: calibre.db.cache.Cache.rename_items:0 |
| 103 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 104 |
#: calibre.db.cache.Cache.search:0 |
| 105 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 106 |
#: calibre.db.cache.Cache.set_field:0 |
| 107 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 108 |
#: calibre.db.cache.Cache.tags_older_than:0 |
| 109 |
msgid "Parameters" |
| 110 |
msgstr "" |
| 111 |
|
| 112 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 113 |
#: calibre.db.cache.Cache.add_format:3 |
| 114 |
msgid "" |
| 115 |
"If True replace existing format, otherwise if the format already exists, " |
| 116 |
"return False." |
| 117 |
msgstr "" |
| 118 |
|
| 119 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 120 |
#: calibre.db.cache.Cache.add_format:4 |
| 121 |
msgid "" |
| 122 |
"If True, file type plugins are run on the format before and after being " |
| 123 |
"added." |
| 124 |
msgstr "" |
| 125 |
|
| 126 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 127 |
#: calibre.db.cache.Cache.add_format:5 |
| 128 |
msgid "Internal use only." |
| 129 |
msgstr "" |
| 130 |
|
| 131 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 132 |
#: calibre.db.cache.Cache.add_listener:1 |
| 133 |
msgid "" |
| 134 |
"Register a callback function that will be called after certain actions are " |
| 135 |
"taken on this database. The function must take three arguments: " |
| 136 |
"(:class:`EventType`, library_id, event_type_specific_data)" |
| 137 |
msgstr "" |
| 138 |
|
| 139 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 140 |
#: calibre.db.cache.Cache.all_book_ids:1 |
| 141 |
msgid "Frozen set of all known book ids." |
| 142 |
msgstr "" |
| 143 |
|
| 144 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 145 |
#: calibre.db.cache.Cache.all_field_for:1 |
| 146 |
msgid "Same as field_for, except that it operates on multiple books at once" |
| 147 |
msgstr "" |
| 148 |
|
| 149 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 150 |
#: calibre.db.cache.Cache.all_field_ids:1 |
| 151 |
msgid "Frozen set of ids for all values in the field ``name``." |
| 152 |
msgstr "" |
| 153 |
|
| 154 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 155 |
#: calibre.db.cache.Cache.all_field_names:1 |
| 156 |
msgid "" |
| 157 |
"Frozen set of all fields names (should only be used for many-one and many-" |
| 158 |
"many fields)" |
| 159 |
msgstr "" |
| 160 |
|
| 161 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 162 |
#: calibre.db.cache.Cache.author_data:1 |
| 163 |
msgid "Return author data as a dictionary with keys: name, sort, link" |
| 164 |
msgstr "" |
| 165 |
|
| 166 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 167 |
#: calibre.db.cache.Cache.author_data:3 |
| 168 |
msgid "" |
| 169 |
"If no authors with the specified ids are found an empty dictionary is " |
| 170 |
"returned. If author_ids is None, data for all authors is returned." |
| 171 |
msgstr "" |
| 172 |
|
| 173 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 174 |
#: calibre.db.cache.Cache.author_sort_from_authors:1 |
| 175 |
msgid "" |
| 176 |
"Given a list of authors, return the author_sort string for the authors, " |
| 177 |
"preferring the author sort associated with the author over the computed " |
| 178 |
"string." |
| 179 |
msgstr "" |
| 180 |
|
| 181 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 182 |
#: calibre.db.cache.Cache.books_for_field:1 |
| 183 |
msgid "" |
| 184 |
"Return all the books associated with the item identified by ``item_id``, " |
| 185 |
"where the item belongs to the field ``name``." |
| 186 |
msgstr "" |
| 187 |
|
| 188 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 189 |
#: calibre.db.cache.Cache.books_for_field:4 |
| 190 |
msgid "" |
| 191 |
"Returned value is a set of book ids, or the empty set if the item or the " |
| 192 |
"field does not exist." |
| 193 |
msgstr "" |
| 194 |
|
| 195 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 196 |
#: calibre.db.cache.Cache.books_in_virtual_library:1 |
| 197 |
msgid "Return the set of books in the specified virtual library" |
| 198 |
msgstr "" |
| 199 |
|
| 200 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 201 |
#: calibre.db.cache.Cache.compress_covers:1 |
| 202 |
msgid "" |
| 203 |
"Compress the cover images for the specified books. A compression quality of " |
| 204 |
"100 will perform lossless compression, otherwise lossy compression." |
| 205 |
msgstr "" |
| 206 |
|
| 207 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 208 |
#: calibre.db.cache.Cache.compress_covers:4 |
| 209 |
msgid "" |
| 210 |
"The progress callback will be called with the book_id and the old and new " |
| 211 |
"sizes for each book that has been processed. If an error occurs, the new " |
| 212 |
"size will be a string with the error details." |
| 213 |
msgstr "" |
| 214 |
|
| 215 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 216 |
#: calibre.db.cache.Cache.copy_cover_to:1 |
| 217 |
msgid "" |
| 218 |
"Copy the cover to the file like object ``dest``. Returns False if no cover " |
| 219 |
"exists or dest is the same file as the current cover. dest can also be a " |
| 220 |
"path in which case the cover is copied to it if and only if the path is " |
| 221 |
"different from the current path (taking case sensitivity into account)." |
| 222 |
msgstr "" |
| 223 |
|
| 224 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 225 |
#: calibre.db.cache.Cache.copy_format_to:1 |
| 226 |
msgid "" |
| 227 |
"Copy the format ``fmt`` to the file like object ``dest``. If the specified " |
| 228 |
"format does not exist, raises :class:`NoSuchFormat` error. dest can also be " |
| 229 |
"a path (to a file), in which case the format is copied to it, iff the path " |
| 230 |
"is different from the current path (taking case sensitivity into account)." |
| 231 |
msgstr "" |
| 232 |
|
| 233 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 234 |
#: calibre.db.cache.Cache.cover:1 |
| 235 |
msgid "" |
| 236 |
"Return the cover image or None. By default, returns the cover as a " |
| 237 |
"bytestring." |
| 238 |
msgstr "" |
| 239 |
|
| 240 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 241 |
#: calibre.db.cache.Cache.cover:4 |
| 242 |
msgid "" |
| 243 |
"WARNING: Using as_path will copy the cover to a temp file and return the " |
| 244 |
"path to the temp file. You should delete the temp file when you are done " |
| 245 |
"with it." |
| 246 |
msgstr "" |
| 247 |
|
| 248 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 249 |
#: calibre.db.cache.Cache.cover:8 |
| 250 |
msgid "" |
| 251 |
"If True return the image as an open file object (a SpooledTemporaryFile)" |
| 252 |
msgstr "" |
| 253 |
|
| 254 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 255 |
#: calibre.db.cache.Cache.cover:9 |
| 256 |
msgid "If True return the image as a QImage object" |
| 257 |
msgstr "" |
| 258 |
|
| 259 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 260 |
#: calibre.db.cache.Cache.cover:10 |
| 261 |
msgid "If True return the image as a path pointing to a temporary file" |
| 262 |
msgstr "" |
| 263 |
|
| 264 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 265 |
#: calibre.db.cache.Cache.data_for_find_identical_books:1 |
| 266 |
msgid "" |
| 267 |
"Return data that can be used to implement :meth:`find_identical_books` in a " |
| 268 |
"worker process without access to the db. See db.utils for an implementation." |
| 269 |
msgstr "" |
| 270 |
|
| 271 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 272 |
#: calibre.db.cache.Cache.data_for_has_book:1 |
| 273 |
msgid "" |
| 274 |
"Return data suitable for use in :meth:`has_book`. This can be used for an " |
| 275 |
"implementation of :meth:`has_book` in a worker process without access to the" |
| 276 |
" db." |
| 277 |
msgstr "" |
| 278 |
|
| 279 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 280 |
#: calibre.db.cache.Cache.delete_custom_book_data:1 |
| 281 |
msgid "" |
| 282 |
"Delete data for name. By default deletes all data, if you only want to " |
| 283 |
"delete data for some book ids, pass in a list of book ids." |
| 284 |
msgstr "" |
| 285 |
|
| 286 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 287 |
#: calibre.db.cache.Cache.embed_metadata:1 |
| 288 |
msgid "" |
| 289 |
"Update metadata in all formats of the specified book_ids to current metadata" |
| 290 |
" in the database." |
| 291 |
msgstr "" |
| 292 |
|
| 293 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 294 |
#: calibre.db.cache.Cache.fast_field_for:1 |
| 295 |
msgid "" |
| 296 |
"Same as field_for, except that it avoids the extra lookup to get the field " |
| 297 |
"object" |
| 298 |
msgstr "" |
| 299 |
|
| 300 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 301 |
#: calibre.db.cache.Cache.field_for:1 |
| 302 |
msgid "" |
| 303 |
"Return the value of the field ``name`` for the book identified by " |
| 304 |
"``book_id``. If no such book exists or it has no defined value for the field" |
| 305 |
" ``name`` or no such field exists, then ``default_value`` is returned." |
| 306 |
msgstr "" |
| 307 |
|
| 308 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 309 |
#: calibre.db.cache.Cache.field_for:6 |
| 310 |
msgid "" |
| 311 |
"``default_value`` is not used for title, title_sort, authors, author_sort " |
| 312 |
"and series_index. This is because these always have values in the db. " |
| 313 |
"``default_value`` is used for all custom columns." |
| 314 |
msgstr "" |
| 315 |
|
| 316 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 317 |
#: calibre.db.cache.Cache.field_for:10 |
| 318 |
msgid "" |
| 319 |
"The returned value for is_multiple fields are always tuples, even when no " |
| 320 |
"values are found (in other words, default_value is ignored). The exception " |
| 321 |
"is identifiers for which the returned value is always a dict. The returned " |
| 322 |
"tuples are always in link order, that is, the order in which they were " |
| 323 |
"created." |
| 324 |
msgstr "" |
| 325 |
|
| 326 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 327 |
#: calibre.db.cache.Cache.field_ids_for:1 |
| 328 |
msgid "" |
| 329 |
"Return the ids (as a tuple) for the values that the field ``name`` has on " |
| 330 |
"the book identified by ``book_id``. If there are no values, or no such book," |
| 331 |
" or no such field, an empty tuple is returned." |
| 332 |
msgstr "" |
| 333 |
|
| 334 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 335 |
#: calibre.db.cache.Cache.find_identical_books:1 |
| 336 |
msgid "" |
| 337 |
"Finds books that have a superset of the authors in mi and the same title " |
| 338 |
"(title is fuzzy matched). See also :meth:`data_for_find_identical_books`." |
| 339 |
msgstr "" |
| 340 |
|
| 341 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 342 |
#: calibre.db.cache.Cache.format:1 |
| 343 |
msgid "" |
| 344 |
"Return the e-book format as a bytestring or `None` if the format doesn't " |
| 345 |
"exist, or we don't have permission to write to the e-book file." |
| 346 |
msgstr "" |
| 347 |
|
| 348 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 349 |
#: calibre.db.cache.Cache.format:4 |
| 350 |
msgid "" |
| 351 |
"If True the e-book format is returned as a file object. Note that the file " |
| 352 |
"object is a SpooledTemporaryFile, so if what you want to do is copy the " |
| 353 |
"format to another file, use :meth:`copy_format_to` instead for performance." |
| 354 |
msgstr "" |
| 355 |
|
| 356 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 357 |
#: calibre.db.cache.Cache.format:8 |
| 358 |
msgid "" |
| 359 |
"Copies the format file to a temp file and returns the path to the temp file" |
| 360 |
msgstr "" |
| 361 |
|
| 362 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 363 |
#: calibre.db.cache.Cache.format:10 |
| 364 |
msgid "" |
| 365 |
"If True and returning a path the filename is the same as that used in the " |
| 366 |
"library. Note that using this means that repeated calls yield the same temp " |
| 367 |
"file (which is re-created each time)" |
| 368 |
msgstr "" |
| 369 |
|
| 370 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 371 |
#: calibre.db.cache.Cache.format_abspath:1 |
| 372 |
msgid "" |
| 373 |
"Return absolute path to the e-book file of format `format`. You should " |
| 374 |
"almost never use this, as it breaks the threadsafe promise of this API. " |
| 375 |
"Instead use, :meth:`copy_format_to`." |
| 376 |
msgstr "" |
| 377 |
|
| 378 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 379 |
#: calibre.db.cache.Cache.format_abspath:5 |
| 380 |
msgid "" |
| 381 |
"Currently used only in calibredb list, the viewer, edit book, compare_format" |
| 382 |
" to original format, open with, bulk metadata edit and the catalogs (via " |
| 383 |
"get_data_as_dict())." |
| 384 |
msgstr "" |
| 385 |
|
| 386 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 387 |
#: calibre.db.cache.Cache.format_abspath:9 |
| 388 |
msgid "" |
| 389 |
"Apart from the viewer, open with and edit book, I don't believe any of the " |
| 390 |
"others do any file write I/O with the results of this call." |
| 391 |
msgstr "" |
| 392 |
|
| 393 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 394 |
#: calibre.db.cache.Cache.format_hash:1 |
| 395 |
msgid "" |
| 396 |
"Return the hash of the specified format for the specified book. The kind of " |
| 397 |
"hash is backend dependent, but is usually SHA-256." |
| 398 |
msgstr "" |
| 399 |
|
| 400 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 401 |
#: calibre.db.cache.Cache.format_metadata:1 |
| 402 |
msgid "" |
| 403 |
"Return the path, size and mtime for the specified format for the specified " |
| 404 |
"book. You should not use path unless you absolutely have to, since accessing" |
| 405 |
" it directly breaks the threadsafe guarantees of this API. Instead use the " |
| 406 |
":meth:`copy_format_to` method." |
| 407 |
msgstr "" |
| 408 |
|
| 409 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 410 |
#: calibre.db.cache.Cache.format_metadata:6 |
| 411 |
msgid "" |
| 412 |
"If ``True`` cached values are used, otherwise a slow filesystem access is " |
| 413 |
"done. The cache values could be out of date if access was performed to the " |
| 414 |
"filesystem outside of this API." |
| 415 |
msgstr "" |
| 416 |
|
| 417 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 418 |
#: calibre.db.cache.Cache.format_metadata:10 |
| 419 |
msgid "" |
| 420 |
"If ``True`` The max_size field of the database is updated for this book." |
| 421 |
msgstr "" |
| 422 |
|
| 423 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 424 |
#: calibre.db.cache.Cache.formats:1 |
| 425 |
msgid "" |
| 426 |
"Return tuple of all formats for the specified book. If verify_formats is " |
| 427 |
"True, verifies that the files exist on disk." |
| 428 |
msgstr "" |
| 429 |
|
| 430 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 431 |
#: calibre.db.cache.Cache.get_categories:1 |
| 432 |
msgid "Used internally to implement the Tag Browser" |
| 433 |
msgstr "" |
| 434 |
|
| 435 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 436 |
#: calibre.db.cache.Cache.get_custom_book_data:1 |
| 437 |
msgid "" |
| 438 |
"Get data for name. By default returns data for all book_ids, pass in a list " |
| 439 |
"of book ids if you only want some data. Returns a map of book_id to values. " |
| 440 |
"If a particular value could not be decoded, uses default for it." |
| 441 |
msgstr "" |
| 442 |
|
| 443 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 444 |
#: calibre.db.cache.Cache.get_id_map:1 |
| 445 |
msgid "" |
| 446 |
"Return a mapping of id numbers to values for the specified field. The field " |
| 447 |
"must be a many-one or many-many field, otherwise a ValueError is raised." |
| 448 |
msgstr "" |
| 449 |
|
| 450 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 451 |
#: calibre.db.cache.Cache.get_ids_for_custom_book_data:1 |
| 452 |
msgid "Return the set of book ids for which name has data." |
| 453 |
msgstr "" |
| 454 |
|
| 455 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 456 |
#: calibre.db.cache.Cache.get_item_id:1 |
| 457 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 458 |
#: calibre.db.cache.Cache.get_item_ids:1 |
| 459 |
msgid "Return the item id for item_name (case-insensitive)" |
| 460 |
msgstr "" |
| 461 |
|
| 462 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 463 |
#: calibre.db.cache.Cache.get_item_name:1 |
| 464 |
msgid "" |
| 465 |
"Return the item name for the item specified by item_id in the specified " |
| 466 |
"field. See also :meth:`get_id_map`." |
| 467 |
msgstr "" |
| 468 |
|
| 469 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 470 |
#: calibre.db.cache.Cache.get_metadata:1 |
| 471 |
msgid "" |
| 472 |
"Return metadata for the book identified by book_id as a " |
| 473 |
":class:`calibre.ebooks.metadata.book.base.Metadata` object. Note that the " |
| 474 |
"list of formats is not verified. If get_cover is True, the cover is " |
| 475 |
"returned, either a path to temp file as mi.cover or if cover_as_data is True" |
| 476 |
" then as mi.cover_data." |
| 477 |
msgstr "" |
| 478 |
|
| 479 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 480 |
#: calibre.db.cache.Cache.get_next_series_num_for:1 |
| 481 |
msgid "" |
| 482 |
"Return the next series index for the specified series, taking into account " |
| 483 |
"the various preferences that control next series number generation." |
| 484 |
msgstr "" |
| 485 |
|
| 486 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 487 |
#: calibre.db.cache.Cache.get_next_series_num_for:4 |
| 488 |
msgid "The series-like field (defaults to the builtin series column)" |
| 489 |
msgstr "" |
| 490 |
|
| 491 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 492 |
#: calibre.db.cache.Cache.get_next_series_num_for:5 |
| 493 |
msgid "" |
| 494 |
"If True, returns a mapping of book_id to current series_index value instead." |
| 495 |
msgstr "" |
| 496 |
|
| 497 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 498 |
#: calibre.db.cache.Cache.get_proxy_metadata:1 |
| 499 |
msgid "" |
| 500 |
"Like :meth:`get_metadata` except that it returns a ProxyMetadata object that" |
| 501 |
" only reads values from the database on demand. This is much faster than " |
| 502 |
"get_metadata when only a small number of fields need to be accessed from the" |
| 503 |
" returned metadata object." |
| 504 |
msgstr "" |
| 505 |
|
| 506 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 507 |
#: calibre.db.cache.Cache.get_usage_count_by_id:1 |
| 508 |
msgid "" |
| 509 |
"Return a mapping of id to usage count for all values of the specified field," |
| 510 |
" which must be a many-one or many-many field." |
| 511 |
msgstr "" |
| 512 |
|
| 513 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 514 |
#: calibre.db.cache.Cache.has_book:1 |
| 515 |
msgid "" |
| 516 |
"Return True iff the database contains an entry with the same title as the " |
| 517 |
"passed in Metadata object. The comparison is case-insensitive. See also " |
| 518 |
":meth:`data_for_has_book`." |
| 519 |
msgstr "" |
| 520 |
|
| 521 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 522 |
#: calibre.db.cache.Cache.has_format:1 |
| 523 |
msgid "Return True iff the format exists on disk" |
| 524 |
msgstr "" |
| 525 |
|
| 526 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 527 |
#: calibre.db.cache.Cache.has_id:1 |
| 528 |
msgid "Return True iff the specified book_id exists in the db" |
| 529 |
msgstr "" |
| 530 |
|
| 531 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 532 |
#: calibre.db.cache.Cache.init:1 |
| 533 |
msgid "Initialize this cache with data from the backend." |
| 534 |
msgstr "" |
| 535 |
|
| 536 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 537 |
#: calibre.db.cache.Cache.multisort:1 |
| 538 |
msgid "" |
| 539 |
"Return a list of sorted book ids. If ids_to_sort is None, all book ids are " |
| 540 |
"returned." |
| 541 |
msgstr "" |
| 542 |
|
| 543 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 544 |
#: calibre.db.cache.Cache.multisort:4 |
| 545 |
msgid "" |
| 546 |
"fields must be a list of 2-tuples of the form (field_name, ascending=True or" |
| 547 |
" False). The most significant field is the first 2-tuple." |
| 548 |
msgstr "" |
| 549 |
|
| 550 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 551 |
#: calibre.db.cache.Cache.pref:1 |
| 552 |
msgid "" |
| 553 |
"Return the value for the specified preference or the value specified as " |
| 554 |
"``default`` if the preference is not set." |
| 555 |
msgstr "" |
| 556 |
|
| 557 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 558 |
#: calibre.db.cache.Cache.read_backup:1 |
| 559 |
msgid "" |
| 560 |
"Return the OPF metadata backup for the book as a bytestring or None if no " |
| 561 |
"such backup exists." |
| 562 |
msgstr "" |
| 563 |
|
| 564 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 565 |
#: calibre.db.cache.Cache.remove_books:1 |
| 566 |
msgid "" |
| 567 |
"Remove the books specified by the book_ids from the database and delete " |
| 568 |
"their format files. If ``permanent`` is False, then the format files are " |
| 569 |
"placed in the recycle bin." |
| 570 |
msgstr "" |
| 571 |
|
| 572 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 573 |
#: calibre.db.cache.Cache.remove_formats:1 |
| 574 |
msgid "Remove the specified formats from the specified books." |
| 575 |
msgstr "" |
| 576 |
|
| 577 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 578 |
#: calibre.db.cache.Cache.remove_formats:3 |
| 579 |
msgid "A mapping of book_id to a list of formats to be removed from the book." |
| 580 |
msgstr "" |
| 581 |
|
| 582 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 583 |
#: calibre.db.cache.Cache.remove_formats:4 |
| 584 |
msgid "" |
| 585 |
"If True, only remove the record for the format from the db, do not delete " |
| 586 |
"the actual format file from the filesystem." |
| 587 |
msgstr "" |
| 588 |
|
| 589 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 590 |
#: calibre.db.cache.Cache.remove_items:1 |
| 591 |
msgid "" |
| 592 |
"Delete all items in the specified field with the specified ids. Returns the " |
| 593 |
"set of affected book ids. ``restrict_to_book_ids`` is an optional set of " |
| 594 |
"books ids. If specified the items will only be removed from those books." |
| 595 |
msgstr "" |
| 596 |
|
| 597 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 598 |
#: calibre.db.cache.Cache.rename_items:1 |
| 599 |
msgid "" |
| 600 |
"Rename items from a many-one or many-many field such as tags or series." |
| 601 |
msgstr "" |
| 602 |
|
| 603 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 604 |
#: calibre.db.cache.Cache.rename_items:3 |
| 605 |
msgid "" |
| 606 |
"When renaming in a series-like field also change the series_index values." |
| 607 |
msgstr "" |
| 608 |
|
| 609 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 610 |
#: calibre.db.cache.Cache.rename_items:4 |
| 611 |
msgid "" |
| 612 |
"An optional set of book ids for which the rename is to be performed, " |
| 613 |
"defaults to all books." |
| 614 |
msgstr "" |
| 615 |
|
| 616 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 617 |
#: calibre.db.cache.Cache.restore_book:1 |
| 618 |
msgid "" |
| 619 |
"Restore the book entry in the database for a book that already exists on the" |
| 620 |
" filesystem" |
| 621 |
msgstr "" |
| 622 |
|
| 623 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 624 |
#: calibre.db.cache.Cache.restore_original_format:1 |
| 625 |
msgid "" |
| 626 |
"Restore the specified format from the previously saved ORIGINAL_FORMAT, if " |
| 627 |
"any. Return True on success. The ORIGINAL_FORMAT is deleted after a " |
| 628 |
"successful restore." |
| 629 |
msgstr "" |
| 630 |
|
| 631 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 632 |
#: calibre.db.cache.Cache.safe_read_lock:1 |
| 633 |
msgid "" |
| 634 |
"A safe read lock is a lock that does nothing if the thread already has a " |
| 635 |
"write lock, otherwise it acquires a read lock. This is necessary to prevent " |
| 636 |
"DowngradeLockErrors, which can happen when updating the search cache in the " |
| 637 |
"presence of composite columns. Updating the search cache holds an exclusive " |
| 638 |
"lock, but searching a composite column involves reading field values via " |
| 639 |
"ProxyMetadata which tries to get a shared lock. There may be other scenarios" |
| 640 |
" that trigger this as well." |
| 641 |
msgstr "" |
| 642 |
|
| 643 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 644 |
#: calibre.db.cache.Cache.safe_read_lock:9 |
| 645 |
msgid "" |
| 646 |
"This property returns a new lock object on every access. This lock object is" |
| 647 |
" not recursive (for performance) and must only be used in a with statement " |
| 648 |
"as ``with cache.safe_read_lock:`` otherwise bad things will happen." |
| 649 |
msgstr "" |
| 650 |
|
| 651 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 652 |
#: calibre.db.cache.Cache.save_original_format:1 |
| 653 |
msgid "" |
| 654 |
"Save a copy of the specified format as ORIGINAL_FORMAT, overwriting any " |
| 655 |
"existing ORIGINAL_FORMAT." |
| 656 |
msgstr "" |
| 657 |
|
| 658 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 659 |
#: calibre.db.cache.Cache.search:1 |
| 660 |
msgid "" |
| 661 |
"Search the database for the specified query, returning a set of matched book" |
| 662 |
" ids." |
| 663 |
msgstr "" |
| 664 |
|
| 665 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 666 |
#: calibre.db.cache.Cache.search:3 |
| 667 |
msgid "" |
| 668 |
"A restriction that is ANDed to the specified query. Note that restrictions " |
| 669 |
"are cached, therefore the search for a AND b will be slower than a with " |
| 670 |
"restriction b." |
| 671 |
msgstr "" |
| 672 |
|
| 673 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 674 |
#: calibre.db.cache.Cache.search:6 |
| 675 |
msgid "Used internally (virtual fields such as on_device to search over)." |
| 676 |
msgstr "" |
| 677 |
|
| 678 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 679 |
#: calibre.db.cache.Cache.search:8 |
| 680 |
msgid "" |
| 681 |
"If not None, a set of book ids for which books will be searched instead of " |
| 682 |
"searching all books." |
| 683 |
msgstr "" |
| 684 |
|
| 685 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 686 |
#: calibre.db.cache.Cache.set_conversion_options:1 |
| 687 |
msgid "options must be a map of the form {book_id:conversion_options}" |
| 688 |
msgstr "" |
| 689 |
|
| 690 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 691 |
#: calibre.db.cache.Cache.set_cover:1 |
| 692 |
msgid "" |
| 693 |
"Set the cover for this book. The data can be either a QImage, QPixmap, file " |
| 694 |
"object or bytestring. It can also be None, in which case any existing cover " |
| 695 |
"is removed." |
| 696 |
msgstr "" |
| 697 |
|
| 698 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 699 |
#: calibre.db.cache.Cache.set_field:1 |
| 700 |
msgid "" |
| 701 |
"Set the values of the field specified by ``name``. Returns the set of all " |
| 702 |
"book ids that were affected by the change." |
| 703 |
msgstr "" |
| 704 |
|
| 705 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 706 |
#: calibre.db.cache.Cache.set_field:3 |
| 707 |
msgid "Mapping of book_ids to values that should be applied." |
| 708 |
msgstr "" |
| 709 |
|
| 710 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 711 |
#: calibre.db.cache.Cache.set_field:4 |
| 712 |
msgid "" |
| 713 |
"If True, the case of many-one or many-many fields will be changed. For " |
| 714 |
"example, if a book has the tag ``tag1`` and you set the tag for another " |
| 715 |
"book to ``Tag1`` then the both books will have the tag ``Tag1`` if " |
| 716 |
"allow_case_change is True, otherwise they will both have the tag ``tag1``." |
| 717 |
msgstr "" |
| 718 |
|
| 719 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 720 |
#: calibre.db.cache.Cache.set_field:8 |
| 721 |
msgid "Used internally, you should never change it." |
| 722 |
msgstr "" |
| 723 |
|
| 724 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 725 |
#: calibre.db.cache.Cache.set_metadata:1 |
| 726 |
msgid "Set metadata for the book `id` from the `Metadata` object `mi`" |
| 727 |
msgstr "" |
| 728 |
|
| 729 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 730 |
#: calibre.db.cache.Cache.set_metadata:3 |
| 731 |
msgid "" |
| 732 |
"Setting force_changes=True will force set_metadata to update fields even if " |
| 733 |
"mi contains empty values. In this case, 'None' is distinguished from " |
| 734 |
"'empty'. If mi.XXX is None, the XXX is not replaced, otherwise it is. The " |
| 735 |
"tags, identifiers, and cover attributes are special cases. Tags and " |
| 736 |
"identifiers cannot be set to None so they will always be replaced if " |
| 737 |
"force_changes is true. You must ensure that mi contains the values you want " |
| 738 |
"the book to have. Covers are always changed if a new cover is provided, but " |
| 739 |
"are never deleted. Also note that force_changes has no effect on setting " |
| 740 |
"title or authors." |
| 741 |
msgstr "" |
| 742 |
|
| 743 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 744 |
#: calibre.db.cache.Cache.set_pref:1 |
| 745 |
msgid "" |
| 746 |
"Set the specified preference to the specified value. See also :meth:`pref`." |
| 747 |
msgstr "" |
| 748 |
|
| 749 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 750 |
#: calibre.db.cache.Cache.tags_older_than:1 |
| 751 |
msgid "" |
| 752 |
"Return the ids of all books having the tag ``tag`` that are older than the " |
| 753 |
"specified time. tag comparison is case insensitive." |
| 754 |
msgstr "" |
| 755 |
|
| 756 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 757 |
#: calibre.db.cache.Cache.tags_older_than:4 |
| 758 |
msgid "" |
| 759 |
"A timedelta object or None. If None, then all ids with the tag are returned." |
| 760 |
msgstr "" |
| 761 |
|
| 762 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 763 |
#: calibre.db.cache.Cache.tags_older_than:7 |
| 764 |
msgid "" |
| 765 |
"If not None the list of matches will be restricted to books that have this " |
| 766 |
"tag" |
| 767 |
msgstr "" |
| 768 |
|
| 769 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 770 |
#: calibre.db.cache.Cache.tags_older_than:10 |
| 771 |
msgid "" |
| 772 |
"A list of authors. If not None the list of matches will be restricted to " |
| 773 |
"books that have these authors (case insensitive)." |
| 774 |
msgstr "" |
| 775 |
|
| 776 |
#: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of |
| 777 |
#: calibre.db.cache.Cache.user_categories_for_books:1 |
| 778 |
msgid "" |
| 779 |
"Return the user categories for the specified books. proxy_metadata_map is " |
| 780 |
"optional and is useful for a performance boost, in contexts where a " |
| 781 |
"ProxyMetadata object for the books already exists. It should be a mapping of" |
| 782 |
" book_ids to their corresponding ProxyMetadata objects." |
| 783 |
msgstr "" |