Debian Codegraph @

translations/manual/pt/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 # Eduardo Lopes <[email protected]>, 2019,2021
7 # Manuela Silva <[email protected]>, 2016
8 # Paulo Pereira <[email protected]>, 2019-2021,2023-2024
9 msgid ""
10 msgstr ""
11 "Project-Id-Version: calibre\n"
12 "Report-Msgid-Bugs-To: \n"
13 "POT-Creation-Date: 2025-01-02 13:56+0000\n"
14 "PO-Revision-Date: 2014-07-05 16:49+0000\n"
15 "Last-Translator: Paulo Pereira <[email protected]>, 2019-2021,2023-2024\n"
16 "Language-Team: Portuguese (http://app.transifex.com/calibre/calibre/language/pt/)\n"
17 "MIME-Version: 1.0\n"
18 "Content-Type: text/plain; charset=UTF-8\n"
19 "Content-Transfer-Encoding: 8bit\n"
20 "Language: pt\n"
21 "Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n"
22
23 #: ../../__w/calibre/calibre/manual/db_api.rst:4
24 msgid "API documentation for the database interface"
25 msgstr "Documentação da API para a interface da base de dados"
26
27 #: ../../__w/calibre/calibre/manual/db_api.rst:9
28 msgid ""
29 "This API is thread safe (it uses a multiple reader, single writer locking "
30 "scheme). You can access this API like this::"
31 msgstr "Esta API é thread-safe (ela usa um esquema de bloqueio de múltiplos leitores e gravador único). É possível acessar esta API assim:"
32
33 #: ../../__w/calibre/calibre/manual/db_api.rst:14
34 msgid ""
35 "If you are in a calibre plugin that is part of the main calibre GUI, you get"
36 " access to it like this instead::"
37 msgstr "Se estiver num plugin do *Calibre* que faça parte da IGU principal do Calibre, terá acesso a ele desta forma:"
38
39 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
40 #: calibre.db.cache.Cache:1
41 msgid ""
42 "An in-memory cache of the metadata.db file from a calibre library. This "
43 "class also serves as a threadsafe API for accessing the database. The in-"
44 "memory cache is maintained in normal form for maximum performance."
45 msgstr "Um in-memory cache do arquivo metadata.db da biblioteca calibre. Essa classe também serve como um threadsafe API para acessar o banco de dados. O in-memory cache é mantido na forma normal para o máximo desempenho"
46
47 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
48 #: calibre.db.cache.Cache:5
49 msgid ""
50 "SQLITE is simply used as a way to read and write from metadata.db robustly. "
51 "All table reading/sorting/searching/caching logic is re-implemented. This "
52 "was necessary for maximum performance and flexibility."
53 msgstr ""
54
55 #: ../../__w/calibre/calibre/manual/docstring of
56 #: calibre.db.cache.Cache.EventType.book_created:1
57 msgid ""
58 "When a new book record is created in the database, with the book id as the "
59 "only argument"
60 msgstr ""
61
62 #: ../../__w/calibre/calibre/manual/docstring of
63 #: calibre.db.cache.Cache.EventType.book_edited:1
64 msgid "When a book format is edited, with arguments: (book_id, fmt)"
65 msgstr ""
66
67 #: ../../__w/calibre/calibre/manual/docstring of
68 #: calibre.db.cache.Cache.EventType.books_removed:1
69 msgid ""
70 "When books are removed from the database with the list of book ids as the "
71 "only argument"
72 msgstr ""
73
74 #: ../../__w/calibre/calibre/manual/docstring of
75 #: calibre.db.cache.Cache.EventType.format_added:1
76 msgid "When a format is added to a book, with arguments: (book_id, format)"
77 msgstr ""
78
79 #: ../../__w/calibre/calibre/manual/docstring of
80 #: calibre.db.cache.Cache.EventType.formats_removed:1
81 msgid ""
82 "When formats are removed from a book, with arguments: (mapping of book id to"
83 " set of formats removed from the book)"
84 msgstr ""
85
86 #: ../../__w/calibre/calibre/manual/docstring of
87 #: calibre.db.cache.Cache.EventType.indexing_progress_changed:1
88 msgid "When the indexing progress changes"
89 msgstr ""
90
91 #: ../../__w/calibre/calibre/manual/docstring of
92 #: calibre.db.cache.Cache.EventType.items_removed:1
93 msgid ""
94 "When items such as tags or authors are removed from some books. Arguments: "
95 "(field_name, affected book ids, ids of removed items)"
96 msgstr ""
97
98 #: ../../__w/calibre/calibre/manual/docstring of
99 #: calibre.db.cache.Cache.EventType.items_renamed:1
100 msgid ""
101 "When items such as tags or authors are renamed in some or all books. "
102 "Arguments: (field_name, affected book ids, map of old item id to new item "
103 "id)"
104 msgstr ""
105
106 #: ../../__w/calibre/calibre/manual/docstring of
107 #: calibre.db.cache.Cache.EventType.metadata_changed:1
108 msgid ""
109 "When some metadata is changed for some books, with arguments: (name of "
110 "changed field, set of affected book ids)"
111 msgstr ""
112
113 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
114 #: calibre.db.cache.Cache.add_books:1
115 msgid ""
116 "Add the specified books to the library. Books should be an iterable of "
117 "2-tuples, each 2-tuple of the form :code:`(mi, format_map)` where mi is a "
118 "Metadata object and format_map is a dictionary of the form :code:`{fmt: "
119 "path_or_stream}`, for example: :code:`{'EPUB': '/path/to/file.epub'}`."
120 msgstr ""
121
122 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
123 #: calibre.db.cache.Cache.add_books:6
124 msgid ""
125 "Returns a pair of lists: :code:`ids, duplicates`. ``ids`` contains the book "
126 "ids for all newly created books in the database. ``duplicates`` contains the"
127 " :code:`(mi, format_map)` for all books that already exist in the database "
128 "as per the simple duplicate detection heuristic used by :meth:`has_book`."
129 msgstr ""
130
131 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
132 #: calibre.db.cache.Cache.add_custom_book_data:1
133 msgid ""
134 "Add data for name where val_map is a map of book_ids to values. If "
135 "delete_first is True, all previously stored data for name will be removed."
136 msgstr "Adicionar dado para nome onde val_map é um mapa de valores de book_ids. Se delete_first é verdadeiro, todos o dados de anteriores para o nome serão removidos"
137
138 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
139 #: calibre.db.cache.Cache.add_extra_files:1
140 msgid "Add extra data files"
141 msgstr ""
142
143 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
144 #: calibre.db.cache.Cache.add_format:1
145 msgid ""
146 "Add a format to the specified book. Return True if the format was added "
147 "successfully."
148 msgstr ""
149
150 #: ../../__w/calibre/calibre/manual/db_api.rst:0
151 msgid "Parameters"
152 msgstr "Parâmetros"
153
154 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
155 #: calibre.db.cache.Cache.add_format:3
156 msgid ""
157 "If True replace existing format, otherwise if the format already exists, "
158 "return False."
159 msgstr "Se Verdadeiro substitui o formato existente; se não, se o formato já existe, devolve False."
160
161 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
162 #: calibre.db.cache.Cache.add_format:4
163 msgid ""
164 "If True, file type plugins are run on the format before and after being "
165 "added."
166 msgstr "Se verdadeiro, os plugins de tipo de ficheiro são executados no formato antes e depois de serem adicionados."
167
168 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
169 #: calibre.db.cache.Cache.add_format:5
170 msgid "Internal use only."
171 msgstr "Apenas para utilização interna."
172
173 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
174 #: calibre.db.cache.Cache.add_listener:1
175 msgid ""
176 "Register a callback function that will be called after certain actions are "
177 "taken on this database. The function must take three arguments: "
178 "(:class:`EventType`, library_id, event_type_specific_data)"
179 msgstr ""
180
181 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
182 #: calibre.db.cache.Cache.add_notes_resource:1
183 msgid ""
184 "Add the specified resource so it can be referenced by notes and return its "
185 "content hash"
186 msgstr ""
187
188 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
189 #: calibre.db.cache.Cache.all_annotation_types:1
190 msgid "Return a tuple of all annotation types in the database."
191 msgstr ""
192
193 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
194 #: calibre.db.cache.Cache.all_annotation_users:1
195 msgid "Return a tuple of all (user_type, user name) that have annotations."
196 msgstr ""
197
198 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
199 #: calibre.db.cache.Cache.all_annotations:1
200 msgid ""
201 "Return a tuple of all annotations matching the specified criteria. "
202 "`ignore_removed` controls whether removed (deleted) annotations are also "
203 "returned. Removed annotations are just a skeleton used for merging of "
204 "annotations."
205 msgstr ""
206
207 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
208 #: calibre.db.cache.Cache.all_annotations_for_book:1
209 msgid ""
210 "Return a tuple containing all annotations for the specified book_id as a "
211 "dict with keys: `format`, `user_type`, `user`, `annotation`. Here, "
212 "annotation is the annotation data."
213 msgstr ""
214
215 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
216 #: calibre.db.cache.Cache.all_book_ids:1
217 msgid "Frozen set of all known book ids."
218 msgstr ""
219
220 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
221 #: calibre.db.cache.Cache.all_field_for:1
222 msgid "Same as field_for, except that it operates on multiple books at once"
223 msgstr "O mesmo que field_for, exceto que opera em múltiplos livros de uma só vez"
224
225 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
226 #: calibre.db.cache.Cache.all_field_ids:1
227 msgid "Frozen set of ids for all values in the field ``name``."
228 msgstr ""
229
230 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
231 #: calibre.db.cache.Cache.all_field_names:1
232 msgid ""
233 "Frozen set of all fields names (should only be used for many-one and many-"
234 "many fields)"
235 msgstr ""
236
237 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
238 #: calibre.db.cache.Cache.annotation_count_for_book:1
239 msgid ""
240 "Return the number of annotations for the specified book available in the "
241 "database."
242 msgstr ""
243
244 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
245 #: calibre.db.cache.Cache.annotations_map_for_book:1
246 msgid ""
247 "Return a map of annotation type -> annotation data for the specified "
248 "book_id, format, user and user_type."
249 msgstr ""
250
251 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
252 #: calibre.db.cache.Cache.author_data:1
253 msgid "Return author data as a dictionary with keys: name, sort, link"
254 msgstr "Devolve os dados do autor como um dicionário com chaves: nome, ordenação, hiperligação"
255
256 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
257 #: calibre.db.cache.Cache.author_data:3
258 msgid ""
259 "If no authors with the specified ids are found an empty dictionary is "
260 "returned. If author_ids is None, data for all authors is returned."
261 msgstr ""
262
263 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
264 #: calibre.db.cache.Cache.author_sort_from_authors:1
265 msgid ""
266 "Given a list of authors, return the author_sort string for the authors, "
267 "preferring the author sort associated with the author over the computed "
268 "string."
269 msgstr ""
270
271 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
272 #: calibre.db.cache.Cache.books_for_field:1
273 msgid ""
274 "Return all the books associated with the item identified by ``item_id``, "
275 "where the item belongs to the field ``name``."
276 msgstr ""
277
278 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
279 #: calibre.db.cache.Cache.books_for_field:4
280 msgid ""
281 "Returned value is a set of book ids, or the empty set if the item or the "
282 "field does not exist."
283 msgstr ""
284
285 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
286 #: calibre.db.cache.Cache.books_in_virtual_library:1
287 msgid "Return the set of books in the specified virtual library"
288 msgstr "Devolver o conjunto de livros na biblioteca virtual especificada"
289
290 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
291 #: calibre.db.cache.Cache.compress_covers:1
292 msgid ""
293 "Compress the cover images for the specified books. A compression quality of "
294 "100 will perform lossless compression, otherwise lossy compression."
295 msgstr "Comprime as imagens de capa dos livros especificados. Uma qualidade de compressão de 100 executará uma compressão sem perdas, caso contrário, terá perdas."
296
297 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
298 #: calibre.db.cache.Cache.compress_covers:4
299 msgid ""
300 "The progress callback will be called with the book_id and the old and new "
301 "sizes for each book that has been processed. If an error occurs, the new "
302 "size will be a string with the error details."
303 msgstr ""
304
305 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
306 #: calibre.db.cache.Cache.copy_cover_to:1
307 msgid ""
308 "Copy the cover to the file like object ``dest``. Returns False if no cover "
309 "exists or dest is the same file as the current cover. dest can also be a "
310 "path in which case the cover is copied to it if and only if the path is "
311 "different from the current path (taking case sensitivity into account)."
312 msgstr ""
313
314 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
315 #: calibre.db.cache.Cache.copy_format_to:1
316 msgid ""
317 "Copy the format ``fmt`` to the file like object ``dest``. If the specified "
318 "format does not exist, raises :class:`NoSuchFormat` error. dest can also be "
319 "a path (to a file), in which case the format is copied to it, iff the path "
320 "is different from the current path (taking case sensitivity into account)."
321 msgstr ""
322
323 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
324 #: calibre.db.cache.Cache.cover:1
325 msgid ""
326 "Return the cover image or None. By default, returns the cover as a "
327 "bytestring."
328 msgstr "Devolve a imagem de capa ou nada. Por predefinição, devolve a capa como um bytestring."
329
330 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
331 #: calibre.db.cache.Cache.cover:4
332 msgid ""
333 "WARNING: Using as_path will copy the cover to a temp file and return the "
334 "path to the temp file. You should delete the temp file when you are done "
335 "with it."
336 msgstr ""
337
338 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
339 #: calibre.db.cache.Cache.cover:8
340 msgid ""
341 "If True return the image as an open file object (a SpooledTemporaryFile)"
342 msgstr ""
343
344 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
345 #: calibre.db.cache.Cache.cover:9
346 msgid "If True return the image as a QImage object"
347 msgstr "Se verdadeiro devolve a imagem como um objeto QImage."
348
349 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
350 #: calibre.db.cache.Cache.cover:10
351 msgid "If True return the image as a QPixmap object"
352 msgstr ""
353
354 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
355 #: calibre.db.cache.Cache.cover:11
356 msgid "If True return the image as a path pointing to a temporary file"
357 msgstr "Se verdadeiro devolve a imagem como um caminho apontando para um ficheiro temporário."
358
359 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
360 #: calibre.db.cache.Cache.data_for_find_identical_books:1
361 msgid ""
362 "Return data that can be used to implement :meth:`find_identical_books` in a "
363 "worker process without access to the db. See db.utils for an implementation."
364 msgstr "Dados de retorno que podem ser usados para implementar :meth:`find_identical_books` num processo sem acesso à BD. Veja db.utils para uma implementação."
365
366 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
367 #: calibre.db.cache.Cache.data_for_has_book:1
368 msgid ""
369 "Return data suitable for use in :meth:`has_book`. This can be used for an "
370 "implementation of :meth:`has_book` in a worker process without access to the"
371 " db."
372 msgstr ""
373
374 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
375 #: calibre.db.cache.Cache.delete_annotations:1
376 msgid "Delete annotations with the specified ids."
377 msgstr ""
378
379 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
380 #: calibre.db.cache.Cache.delete_custom_book_data:1
381 msgid ""
382 "Delete data for name. By default deletes all data, if you only want to "
383 "delete data for some book ids, pass in a list of book ids."
384 msgstr ""
385
386 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
387 #: calibre.db.cache.Cache.delete_trash_entry:1
388 msgid ""
389 "Delete an entry from the trash. Here category is 'b' for books and 'f' for "
390 "formats."
391 msgstr ""
392
393 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
394 #: calibre.db.cache.Cache.embed_metadata:1
395 msgid ""
396 "Update metadata in all formats of the specified book_ids to current metadata"
397 " in the database."
398 msgstr ""
399
400 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
401 #: calibre.db.cache.Cache.expire_old_trash:1
402 msgid "Expire entries from the trash that are too old"
403 msgstr ""
404
405 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
406 #: calibre.db.cache.Cache.export_note:1
407 msgid ""
408 "Export the note as a single HTML document with embedded images as data: URLs"
409 msgstr ""
410
411 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
412 #: calibre.db.cache.Cache.fast_field_for:1
413 msgid ""
414 "Same as field_for, except that it avoids the extra lookup to get the field "
415 "object"
416 msgstr ""
417
418 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
419 #: calibre.db.cache.Cache.field_for:1
420 msgid ""
421 "Return the value of the field ``name`` for the book identified by "
422 "``book_id``. If no such book exists or it has no defined value for the field"
423 " ``name`` or no such field exists, then ``default_value`` is returned."
424 msgstr ""
425
426 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
427 #: calibre.db.cache.Cache.field_for:6
428 msgid ""
429 "``default_value`` is not used for title, title_sort, authors, author_sort "
430 "and series_index. This is because these always have values in the db. "
431 "``default_value`` is used for all custom columns."
432 msgstr ""
433
434 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
435 #: calibre.db.cache.Cache.field_for:10
436 msgid ""
437 "The returned value for is_multiple fields are always tuples, even when no "
438 "values are found (in other words, default_value is ignored). The exception "
439 "is identifiers for which the returned value is always a dictionary. The "
440 "returned tuples are always in link order, that is, the order in which they "
441 "were created."
442 msgstr ""
443
444 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
445 #: calibre.db.cache.Cache.field_ids_for:1
446 msgid ""
447 "Return the ids (as a tuple) for the values that the field ``name`` has on "
448 "the book identified by ``book_id``. If there are no values, or no such book,"
449 " or no such field, an empty tuple is returned."
450 msgstr ""
451
452 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
453 #: calibre.db.cache.Cache.field_supports_notes:1
454 msgid ""
455 "Return True iff the specified field supports notes. If field is None return "
456 "frozenset of all fields that support notes."
457 msgstr ""
458
459 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
460 #: calibre.db.cache.Cache.find_identical_books:1
461 msgid ""
462 "Finds books that have a superset of the authors in mi and the same title "
463 "(title is fuzzy matched). See also :meth:`data_for_find_identical_books`."
464 msgstr ""
465
466 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
467 #: calibre.db.cache.Cache.format:1
468 msgid ""
469 "Return the e-book format as a bytestring or `None` if the format doesn't "
470 "exist, or we don't have permission to write to the e-book file."
471 msgstr ""
472
473 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
474 #: calibre.db.cache.Cache.format:4
475 msgid ""
476 "If True the e-book format is returned as a file object. Note that the file "
477 "object is a SpooledTemporaryFile, so if what you want to do is copy the "
478 "format to another file, use :meth:`copy_format_to` instead for performance."
479 msgstr ""
480
481 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
482 #: calibre.db.cache.Cache.format:8
483 msgid ""
484 "Copies the format file to a temp file and returns the path to the temp file"
485 msgstr ""
486
487 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
488 #: calibre.db.cache.Cache.format:10
489 msgid ""
490 "If True and returning a path the filename is the same as that used in the "
491 "library. Note that using this means that repeated calls yield the same temp "
492 "file (which is re-created each time)"
493 msgstr ""
494
495 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
496 #: calibre.db.cache.Cache.format_abspath:1
497 msgid ""
498 "Return absolute path to the e-book file of format `format`. You should "
499 "almost never use this, as it breaks the threadsafe promise of this API. "
500 "Instead use, :meth:`copy_format_to`."
501 msgstr ""
502
503 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
504 #: calibre.db.cache.Cache.format_abspath:5
505 msgid ""
506 "Currently used only in calibredb list, the viewer, edit book, compare_format"
507 " to original format, open with, bulk metadata edit and the catalogs (via "
508 "get_data_as_dict())."
509 msgstr ""
510
511 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
512 #: calibre.db.cache.Cache.format_abspath:9
513 msgid ""
514 "Apart from the viewer, open with and edit book, I don't believe any of the "
515 "others do any file write I/O with the results of this call."
516 msgstr ""
517
518 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
519 #: calibre.db.cache.Cache.format_hash:1
520 msgid ""
521 "Return the hash of the specified format for the specified book. The kind of "
522 "hash is backend dependent, but is usually SHA-256."
523 msgstr ""
524
525 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
526 #: calibre.db.cache.Cache.format_metadata:1
527 msgid ""
528 "Return the path, size and mtime for the specified format for the specified "
529 "book. You should not use path unless you absolutely have to, since accessing"
530 " it directly breaks the threadsafe guarantees of this API. Instead use the "
531 ":meth:`copy_format_to` method."
532 msgstr ""
533
534 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
535 #: calibre.db.cache.Cache.format_metadata:6
536 msgid ""
537 "If ``True`` cached values are used, otherwise a slow filesystem access is "
538 "done. The cache values could be out of date if access was performed to the "
539 "filesystem outside of this API."
540 msgstr ""
541
542 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
543 #: calibre.db.cache.Cache.format_metadata:10
544 msgid ""
545 "If ``True`` The max_size field of the database is updated for this book."
546 msgstr ""
547
548 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
549 #: calibre.db.cache.Cache.formats:1
550 msgid ""
551 "Return tuple of all formats for the specified book. If verify_formats is "
552 "True, verifies that the files exist on disk."
553 msgstr ""
554
555 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
556 #: calibre.db.cache.Cache.get_all_items_that_have_notes:1
557 msgid ""
558 "Return all item_ids for items that have notes in the specified field or all "
559 "fields if field_name is None"
560 msgstr ""
561
562 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
563 #: calibre.db.cache.Cache.get_all_link_maps_for_book:1
564 msgid ""
565 "Returns all links for all fields referenced by book identified by book_id. "
566 "If book_id doesn't exist then the method returns {}."
567 msgstr ""
568
569 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
570 #: calibre.db.cache.Cache.get_all_link_maps_for_book:4
571 msgid ""
572 "Example: Assume author A has link X, author B has link Y, tag S has link F, "
573 "and tag T has link G. If book 1 has author A and tag T, this method returns "
574 "{'authors':{'A':'X'}, 'tags':{'T', 'G'}}. If book 2's author is neither A "
575 "nor B and has no tags, this method returns {}."
576 msgstr ""
577
578 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
579 #: calibre.db.cache.Cache.get_all_link_maps_for_book:9
580 msgid "the book id in question."
581 msgstr ""
582
583 #: ../../__w/calibre/calibre/manual/db_api.rst:0
584 msgid "Returns"
585 msgstr ""
586
587 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
588 #: calibre.db.cache.Cache.get_all_link_maps_for_book:11
589 msgid ""
590 "{field: {field_value, link_value}, ... for all fields with a field_value "
591 "having a non-empty link value for that book"
592 msgstr ""
593
594 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
595 #: calibre.db.cache.Cache.get_categories:1
596 msgid "Used internally to implement the Tag Browser"
597 msgstr ""
598
599 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
600 #: calibre.db.cache.Cache.get_custom_book_data:1
601 msgid ""
602 "Get data for name. By default returns data for all book_ids, pass in a list "
603 "of book ids if you only want some data. Returns a map of book_id to values. "
604 "If a particular value could not be decoded, uses default for it."
605 msgstr ""
606
607 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
608 #: calibre.db.cache.Cache.get_id_map:1
609 msgid ""
610 "Return a mapping of id numbers to values for the specified field. The field "
611 "must be a many-one or many-many field, otherwise a ValueError is raised."
612 msgstr ""
613
614 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
615 #: calibre.db.cache.Cache.get_ids_for_custom_book_data:1
616 msgid "Return the set of book ids for which name has data."
617 msgstr ""
618
619 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
620 #: calibre.db.cache.Cache.get_item_id:1
621 msgid ""
622 "Return the item id for item_name or None if not found. This function is very"
623 " slow if doing lookups for multiple names use either get_item_ids() or "
624 "get_item_name_map(). Similarly, case sensitive lookups are faster than case "
625 "insensitive ones."
626 msgstr ""
627
628 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
629 #: calibre.db.cache.Cache.get_item_ids:1
630 msgid "Return a dict mapping item_name to the item id or None"
631 msgstr ""
632
633 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
634 #: calibre.db.cache.Cache.get_item_name:1
635 msgid ""
636 "Return the item name for the item specified by item_id in the specified "
637 "field. See also :meth:`get_id_map`."
638 msgstr ""
639
640 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
641 #: calibre.db.cache.Cache.get_item_name_map:1
642 msgid "Return mapping of item values to ids"
643 msgstr ""
644
645 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
646 #: calibre.db.cache.Cache.get_link_map:1
647 msgid "Return a dictionary of links for the supplied field."
648 msgstr ""
649
650 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
651 #: calibre.db.cache.Cache.get_link_map:3
652 msgid "the lookup name of the field for which the link map is desired"
653 msgstr ""
654
655 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
656 #: calibre.db.cache.Cache.get_link_map:5
657 msgid "{field_value:link_value, ...} for non-empty links"
658 msgstr ""
659
660 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
661 #: calibre.db.cache.Cache.get_metadata:1
662 msgid ""
663 "Return metadata for the book identified by book_id as a "
664 ":class:`calibre.ebooks.metadata.book.base.Metadata` object. Note that the "
665 "list of formats is not verified. If get_cover is True, the cover is "
666 "returned, either a path to temp file as mi.cover or if cover_as_data is True"
667 " then as mi.cover_data."
668 msgstr ""
669
670 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
671 #: calibre.db.cache.Cache.get_next_series_num_for:1
672 msgid ""
673 "Return the next series index for the specified series, taking into account "
674 "the various preferences that control next series number generation."
675 msgstr ""
676
677 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
678 #: calibre.db.cache.Cache.get_next_series_num_for:4
679 msgid "The series-like field (defaults to the builtin series column)"
680 msgstr ""
681
682 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
683 #: calibre.db.cache.Cache.get_next_series_num_for:5
684 msgid ""
685 "If True, returns a mapping of book_id to current series_index value instead."
686 msgstr ""
687
688 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
689 #: calibre.db.cache.Cache.get_notes_resource:1
690 msgid ""
691 "Return a dict containing the resource data and name or None if no resource "
692 "with the specified hash is found"
693 msgstr ""
694
695 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
696 #: calibre.db.cache.Cache.get_proxy_metadata:1
697 msgid ""
698 "Like :meth:`get_metadata` except that it returns a ProxyMetadata object that"
699 " only reads values from the database on demand. This is much faster than "
700 "get_metadata when only a small number of fields need to be accessed from the"
701 " returned metadata object."
702 msgstr ""
703
704 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
705 #: calibre.db.cache.Cache.get_usage_count_by_id:1
706 msgid ""
707 "Return a mapping of id to usage count for all values of the specified field,"
708 " which must be a many-one or many-many field."
709 msgstr ""
710
711 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
712 #: calibre.db.cache.Cache.has_book:1
713 msgid ""
714 "Return True iff the database contains an entry with the same title as the "
715 "passed in Metadata object. The comparison is case-insensitive. See also "
716 ":meth:`data_for_has_book`."
717 msgstr ""
718
719 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
720 #: calibre.db.cache.Cache.has_format:1
721 msgid "Return True iff the format exists on disk"
722 msgstr "Devolve Verdadeiro se o formato existir no disco. "
723
724 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
725 #: calibre.db.cache.Cache.has_id:1
726 msgid "Return True iff the specified book_id exists in the db"
727 msgstr "Devolve Verdadeiro se o ID do livro especificado existir na base de dados."
728
729 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
730 #: calibre.db.cache.Cache.import_note:1
731 msgid ""
732 "Import a previously exported note or an arbitrary HTML file as the note for "
733 "the specified item"
734 msgstr ""
735
736 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
737 #: calibre.db.cache.Cache.init:1
738 msgid "Initialize this cache with data from the backend."
739 msgstr ""
740
741 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
742 #: calibre.db.cache.Cache.items_with_notes_in_book:1
743 msgid ""
744 "Return a dict of field to items that have associated notes for that field "
745 "for the specified book"
746 msgstr ""
747
748 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
749 #: calibre.db.cache.Cache.link_for:1
750 msgid ""
751 "Return the link, if any, for the specified item or None if no link is found"
752 msgstr ""
753
754 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
755 #: calibre.db.cache.Cache.list_extra_files:1
756 msgid "Get information about extra files in the book's directory."
757 msgstr ""
758
759 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
760 #: calibre.db.cache.Cache.list_extra_files:3
761 msgid "the database book id for the book"
762 msgstr ""
763
764 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
765 #: calibre.db.cache.Cache.list_extra_files:4
766 msgid ""
767 "the pattern of filenames to search for. Empty pattern matches all extra "
768 "files. Patterns must use / as separator. Use the DATA_FILE_PATTERN constant "
769 "to match files inside the data directory."
770 msgstr ""
771
772 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
773 #: calibre.db.cache.Cache.list_extra_files:7
774 msgid ""
775 "A tuple of all extra files matching the specified pattern. Each element of "
776 "the tuple is ExtraFile(relpath, file_path, stat_result). Where relpath is "
777 "the relative path of the file to the book directory using / as a separator. "
778 "stat_result is the result of calling os.stat() on the file."
779 msgstr ""
780
781 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
782 #: calibre.db.cache.Cache.merge_annotations_for_book:1
783 msgid ""
784 "Merge the specified annotations into the existing annotations for book_id, "
785 "fm, user_type, and user."
786 msgstr ""
787
788 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
789 #: calibre.db.cache.Cache.merge_extra_files:1
790 msgid ""
791 "Merge the extra files from src_ids into dest_id. Conflicting files are auto-"
792 "renamed unless replace=True in which case they are replaced."
793 msgstr ""
794
795 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
796 #: calibre.db.cache.Cache.move_book_from_trash:1
797 msgid "Undelete a book from the trash directory"
798 msgstr ""
799
800 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
801 #: calibre.db.cache.Cache.move_format_from_trash:1
802 msgid "Undelete a format from the trash directory"
803 msgstr ""
804
805 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
806 #: calibre.db.cache.Cache.multisort:1
807 msgid ""
808 "Return a list of sorted book ids. If ids_to_sort is None, all book ids are "
809 "returned."
810 msgstr ""
811
812 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
813 #: calibre.db.cache.Cache.multisort:4
814 msgid ""
815 "fields must be a list of 2-tuples of the form (field_name, ascending=True or"
816 " False). The most significant field is the first 2-tuple."
817 msgstr ""
818
819 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
820 #: calibre.db.cache.Cache.notes_data_for:1
821 msgid "Return all notes data as a dict or None if note does not exist"
822 msgstr ""
823
824 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
825 #: calibre.db.cache.Cache.notes_for:1
826 msgid "Return the notes document or an empty string if not found"
827 msgstr ""
828
829 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
830 #: calibre.db.cache.Cache.notes_resources_used_by:1
831 msgid ""
832 "Return the set of resource hashes of all resources used by the note for the "
833 "specified item"
834 msgstr ""
835
836 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
837 #: calibre.db.cache.Cache.pref:1
838 msgid ""
839 "Return the value for the specified preference or the value specified as "
840 "``default`` if the preference is not set."
841 msgstr ""
842
843 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
844 #: calibre.db.cache.Cache.read_backup:1
845 msgid ""
846 "Return the OPF metadata backup for the book as a bytestring or None if no "
847 "such backup exists."
848 msgstr ""
849
850 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
851 #: calibre.db.cache.Cache.remove_books:1
852 msgid ""
853 "Remove the books specified by the book_ids from the database and delete "
854 "their format files. If ``permanent`` is False, then the format files are "
855 "placed in the per-library trash directory."
856 msgstr ""
857
858 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
859 #: calibre.db.cache.Cache.remove_extra_files:1
860 msgid ""
861 "Delete the specified extra files, either to Recycle Bin or permanently."
862 msgstr ""
863
864 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
865 #: calibre.db.cache.Cache.remove_formats:1
866 msgid "Remove the specified formats from the specified books."
867 msgstr "Remover os formatos especificados dos livros indicados."
868
869 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
870 #: calibre.db.cache.Cache.remove_formats:3
871 msgid "A mapping of book_id to a list of formats to be removed from the book."
872 msgstr ""
873
874 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
875 #: calibre.db.cache.Cache.remove_formats:4
876 msgid ""
877 "If True, only remove the record for the format from the db, do not delete "
878 "the actual format file from the filesystem."
879 msgstr ""
880
881 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
882 #: calibre.db.cache.Cache.remove_formats:5
883 msgid ""
884 "A map of book id to set of formats actually deleted from the filesystem for "
885 "that book"
886 msgstr ""
887
888 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
889 #: calibre.db.cache.Cache.remove_items:1
890 msgid ""
891 "Delete all items in the specified field with the specified ids. Returns the "
892 "set of affected book ids. ``restrict_to_book_ids`` is an optional set of "
893 "books ids. If specified the items will only be removed from those books."
894 msgstr ""
895
896 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
897 #: calibre.db.cache.Cache.rename_extra_files:1
898 msgid "Rename extra data files"
899 msgstr ""
900
901 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
902 #: calibre.db.cache.Cache.rename_items:1
903 msgid ""
904 "Rename items from a many-one or many-many field such as tags or series."
905 msgstr ""
906
907 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
908 #: calibre.db.cache.Cache.rename_items:3
909 msgid ""
910 "When renaming in a series-like field also change the series_index values."
911 msgstr ""
912
913 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
914 #: calibre.db.cache.Cache.rename_items:4
915 msgid ""
916 "An optional set of book ids for which the rename is to be performed, "
917 "defaults to all books."
918 msgstr ""
919
920 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
921 #: calibre.db.cache.Cache.restore_book:1
922 msgid ""
923 "Restore the book entry in the database for a book that already exists on the"
924 " filesystem"
925 msgstr ""
926
927 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
928 #: calibre.db.cache.Cache.restore_original_format:1
929 msgid ""
930 "Restore the specified format from the previously saved ORIGINAL_FORMAT, if "
931 "any. Return True on success. The ORIGINAL_FORMAT is deleted after a "
932 "successful restore."
933 msgstr ""
934
935 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
936 #: calibre.db.cache.Cache.safe_read_lock:1
937 msgid ""
938 "A safe read lock is a lock that does nothing if the thread already has a "
939 "write lock, otherwise it acquires a read lock. This is necessary to prevent "
940 "DowngradeLockErrors, which can happen when updating the search cache in the "
941 "presence of composite columns. Updating the search cache holds an exclusive "
942 "lock, but searching a composite column involves reading field values via "
943 "ProxyMetadata which tries to get a shared lock. There may be other scenarios"
944 " that trigger this as well."
945 msgstr ""
946
947 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
948 #: calibre.db.cache.Cache.safe_read_lock:9
949 msgid ""
950 "This property returns a new lock object on every access. This lock object is"
951 " not recursive (for performance) and must only be used in a with statement "
952 "as ``with cache.safe_read_lock:`` otherwise bad things will happen."
953 msgstr ""
954
955 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
956 #: calibre.db.cache.Cache.save_original_format:1
957 msgid ""
958 "Save a copy of the specified format as ORIGINAL_FORMAT, overwriting any "
959 "existing ORIGINAL_FORMAT."
960 msgstr ""
961
962 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
963 #: calibre.db.cache.Cache.search:1
964 msgid ""
965 "Search the database for the specified query, returning a set of matched book"
966 " ids."
967 msgstr ""
968
969 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
970 #: calibre.db.cache.Cache.search:3
971 msgid ""
972 "A restriction that is ANDed to the specified query. Note that restrictions "
973 "are cached, therefore the search for a AND b will be slower than a with "
974 "restriction b."
975 msgstr ""
976
977 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
978 #: calibre.db.cache.Cache.search:6
979 msgid "Used internally (virtual fields such as on_device to search over)."
980 msgstr ""
981
982 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
983 #: calibre.db.cache.Cache.search:8
984 msgid ""
985 "If not None, a set of book ids for which books will be searched instead of "
986 "searching all books."
987 msgstr ""
988
989 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
990 #: calibre.db.cache.Cache.search_annotations:1
991 msgid ""
992 "Return of a tuple of annotations matching the specified Full-text query."
993 msgstr ""
994
995 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
996 #: calibre.db.cache.Cache.search_notes:1
997 msgid ""
998 "Search the text of notes using an FTS index. If the query is empty return "
999 "all notes."
1000 msgstr ""
1001
1002 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1003 #: calibre.db.cache.Cache.set_annotations_for_book:1
1004 msgid ""
1005 "Set all annotations for the specified book_id, fmt, user_type and user."
1006 msgstr ""
1007
1008 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1009 #: calibre.db.cache.Cache.set_conversion_options:1
1010 msgid "options must be a map of the form {book_id:conversion_options}"
1011 msgstr ""
1012
1013 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1014 #: calibre.db.cache.Cache.set_cover:1
1015 msgid ""
1016 "Set the cover for this book. The data can be either a QImage, QPixmap, file "
1017 "object or bytestring. It can also be None, in which case any existing cover "
1018 "is removed."
1019 msgstr ""
1020
1021 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1022 #: calibre.db.cache.Cache.set_field:1
1023 msgid ""
1024 "Set the values of the field specified by ``name``. Returns the set of all "
1025 "book ids that were affected by the change."
1026 msgstr ""
1027
1028 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1029 #: calibre.db.cache.Cache.set_field:3
1030 msgid "Mapping of book_ids to values that should be applied."
1031 msgstr ""
1032
1033 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1034 #: calibre.db.cache.Cache.set_field:4
1035 msgid ""
1036 "If True, the case of many-one or many-many fields will be changed. For "
1037 "example, if a book has the tag ``tag1`` and you set the tag for another "
1038 "book to ``Tag1`` then the both books will have the tag ``Tag1`` if "
1039 "allow_case_change is True, otherwise they will both have the tag ``tag1``."
1040 msgstr ""
1041
1042 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1043 #: calibre.db.cache.Cache.set_field:8
1044 msgid "Used internally, you should never change it."
1045 msgstr "Usado internamente. Nunca deve ser alterado. "
1046
1047 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1048 #: calibre.db.cache.Cache.set_link_map:1
1049 msgid ""
1050 "Sets links for item values in field. Note: this method doesn't change values"
1051 " not in the value_to_link_map"
1052 msgstr ""
1053
1054 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1055 #: calibre.db.cache.Cache.set_link_map:4
1056 msgid "the lookup name"
1057 msgstr ""
1058
1059 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1060 #: calibre.db.cache.Cache.set_link_map:5
1061 msgid ""
1062 "dict(field_value:link, ...). Note that these are values, not field ids."
1063 msgstr ""
1064
1065 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1066 #: calibre.db.cache.Cache.set_link_map:7
1067 msgid "books changed by setting the link"
1068 msgstr ""
1069
1070 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1071 #: calibre.db.cache.Cache.set_metadata:1
1072 msgid "Set metadata for the book `id` from the `Metadata` object `mi`"
1073 msgstr ""
1074
1075 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1076 #: calibre.db.cache.Cache.set_metadata:3
1077 msgid ""
1078 "Setting force_changes=True will force set_metadata to update fields even if "
1079 "mi contains empty values. In this case, 'None' is distinguished from "
1080 "'empty'. If mi.XXX is None, the XXX is not replaced, otherwise it is. The "
1081 "tags, identifiers, and cover attributes are special cases. Tags and "
1082 "identifiers cannot be set to None so they will always be replaced if "
1083 "force_changes is true. You must ensure that mi contains the values you want "
1084 "the book to have. Covers are always changed if a new cover is provided, but "
1085 "are never deleted. Also note that force_changes has no effect on setting "
1086 "title or authors."
1087 msgstr ""
1088
1089 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1090 #: calibre.db.cache.Cache.set_notes_for:1
1091 msgid ""
1092 "Set the notes document. If the searchable text is different from the "
1093 "document, specify it as searchable_text. If the document references "
1094 "resources their hashes must be present in resource_hashes. Set "
1095 "remove_unused_resources to True to cleanup unused resources, note that "
1096 "updating a note automatically cleans up resources pertaining to that note "
1097 "anyway."
1098 msgstr ""
1099
1100 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1101 #: calibre.db.cache.Cache.set_pref:1
1102 msgid ""
1103 "Set the specified preference to the specified value. See also :meth:`pref`."
1104 msgstr ""
1105
1106 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1107 #: calibre.db.cache.Cache.split_if_is_multiple_composite:1
1108 msgid ""
1109 "If f is a composite column lookup key and the column is is_multiple then "
1110 "split v into unique non-empty values. The comparison is case sensitive. "
1111 "Order is not preserved. Return a list() for compatibility with proxy "
1112 "metadata field getters, for example tags."
1113 msgstr ""
1114
1115 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1116 #: calibre.db.cache.Cache.tags_older_than:1
1117 msgid ""
1118 "Return the ids of all books having the tag ``tag`` that are older than the "
1119 "specified time. tag comparison is case insensitive."
1120 msgstr ""
1121
1122 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1123 #: calibre.db.cache.Cache.tags_older_than:4
1124 msgid ""
1125 "A timedelta object or None. If None, then all ids with the tag are returned."
1126 msgstr ""
1127
1128 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1129 #: calibre.db.cache.Cache.tags_older_than:7
1130 msgid ""
1131 "If not None the list of matches will be restricted to books that have this "
1132 "tag"
1133 msgstr ""
1134
1135 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1136 #: calibre.db.cache.Cache.tags_older_than:10
1137 msgid ""
1138 "A list of authors. If not None the list of matches will be restricted to "
1139 "books that have these authors (case insensitive)."
1140 msgstr ""
1141
1142 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1143 #: calibre.db.cache.Cache.unretire_note_for:1
1144 msgid ""
1145 "Unretire a previously retired note for the specified item. Notes are retired"
1146 " when an item is removed from the database"
1147 msgstr ""
1148
1149 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1150 #: calibre.db.cache.Cache.update_annotations:1
1151 msgid "Update annotations."
1152 msgstr ""
1153
1154 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
1155 #: calibre.db.cache.Cache.user_categories_for_books:1
1156 msgid ""
1157 "Return the user categories for the specified books. proxy_metadata_map is "
1158 "optional and is useful for a performance boost, in contexts where a "
1159 "ProxyMetadata object for the books already exists. It should be a mapping of"
1160 " book_ids to their corresponding ProxyMetadata objects."
1161 msgstr ""