Debian Codegraph @

translations/manual/he/db_api.po

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