Debian Codegraph @

translations/manual/it/plugins.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 # Leonardo Armando Iarrusso <[email protected]>, 2015
7 # Maurizio Malagoli <[email protected]>, 2014
8 # Maurizio Malagoli <[email protected]>, 2014
9 # Marta Mingolla <[email protected]>, 2017
10 # demetrio <[email protected]>, 2020
11 # Michele Galimberti <[email protected]>, 2021-2022,2025
12 # SKAL <[email protected]>, 2015
13 # Vincenzo Reale <[email protected]>, 2014
14 msgid ""
15 msgstr ""
16 "Project-Id-Version: calibre\n"
17 "Report-Msgid-Bugs-To: \n"
18 "POT-Creation-Date: 2026-03-12 02:31+0000\n"
19 "PO-Revision-Date: 2014-06-17 08:35+0000\n"
20 "Last-Translator: Michele Galimberti <[email protected]>, 2021-2022,2025\n"
21 "Language-Team: Italian (http://app.transifex.com/calibre/calibre/language/it/)\n"
22 "MIME-Version: 1.0\n"
23 "Content-Type: text/plain; charset=UTF-8\n"
24 "Content-Transfer-Encoding: 8bit\n"
25 "Language: it\n"
26 "Plural-Forms: nplurals=3; plural=n == 1 ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n"
27
28 #: ../../../__w/calibre/calibre/manual/plugins.rst:4
29 msgid "API documentation for plugins"
30 msgstr "Documentazione API per i plugin"
31
32 #: ../../../__w/calibre/calibre/manual/plugins.rst:9
33 msgid ""
34 "Defines various abstract base classes that can be subclassed to create "
35 "powerful plugins. The useful classes are:"
36 msgstr "Definisce diverse classi astratte di base che possono essere utilizzate con sottoclassi per creare potenti plugin. Le classi utili sono:"
37
38 #: ../../../__w/calibre/calibre/manual/plugins.rst:19
39 msgid "Plugin"
40 msgstr "Plugin"
41
42 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
43 #: calibre.customize.Plugin:1
44 msgid "A calibre plugin. Useful members include:"
45 msgstr "Un plugin calibre. Membri utili:"
46
47 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
48 #: calibre.customize.Plugin:3
49 msgid "``self.installation_type``: Stores how the plugin was installed."
50 msgstr "``self.installation_type``: conserva la modalità di installazione del plugin."
51
52 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
53 #: calibre.customize.Plugin:4
54 msgid "``self.plugin_path``: Stores path to the ZIP file that contains"
55 msgstr "``self.plugin_path``: Contiene il percorso al file ZIP contenente"
56
57 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
58 #: calibre.customize.Plugin:5
59 msgid "this plugin or None if it is a builtin plugin"
60 msgstr "questo plugin o None se è un plugin interno"
61
62 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
63 #: calibre.customize.Plugin:7
64 msgid "``self.site_customization``: Stores a customization string entered"
65 msgstr "``self.site_customization``: Contiene una stringa di personalizzazione inserita"
66
67 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
68 #: calibre.customize.Plugin:8
69 msgid "by the user."
70 msgstr "dall'utente."
71
72 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
73 #: calibre.customize.Plugin:10
74 msgid "Methods that should be overridden in sub classes:"
75 msgstr "Metodi che dovrebbero essere sostituiti nelle sottoclassi:"
76
77 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
78 #: calibre.customize.Plugin:12
79 msgid ":meth:`initialize`"
80 msgstr ":meth:`initialize`"
81
82 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
83 #: calibre.customize.Plugin:13
84 msgid ":meth:`customization_help`"
85 msgstr ":meth:`customization_help`"
86
87 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
88 #: calibre.customize.Plugin:15
89 msgid "Useful methods:"
90 msgstr "Metodi utili:"
91
92 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
93 #: calibre.customize.Plugin:17
94 msgid ":meth:`temporary_file`"
95 msgstr ":meth:`temporary_file`"
96
97 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
98 #: calibre.customize.Plugin:18
99 msgid ":meth:`__enter__`"
100 msgstr ":meth:`__enter__`"
101
102 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
103 #: calibre.customize.Plugin:19
104 msgid ":meth:`load_resources`"
105 msgstr ":meth:`load_resources`"
106
107 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
108 #: calibre.customize.InterfaceActionBase.supported_platforms:1
109 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
110 #: calibre.customize.MetadataReaderPlugin.supported_platforms:1
111 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
112 #: calibre.customize.MetadataWriterPlugin.supported_platforms:1
113 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
114 #: calibre.customize.Plugin.supported_platforms:1
115 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
116 #: calibre.customize.PreferencesPlugin.supported_platforms:1
117 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
118 #: of calibre.customize.conversion.InputFormatPlugin.supported_platforms:1
119 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
120 #: of calibre.customize.conversion.OutputFormatPlugin.supported_platforms:1
121 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
122 #: of calibre.devices.usbms.driver.USBMS.supported_platforms:1
123 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
124 #: of calibre.ebooks.metadata.sources.base.Source.supported_platforms:1
125 msgid ""
126 "List of platforms this plugin works on. For example: ``['windows', 'osx', "
127 "'linux']``"
128 msgstr "Elenco delle piattaforme sulle quali questo plugin funziona. Ad esempio: ``['windows', 'osx', 'linux']``"
129
130 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
131 #: calibre.customize.Plugin.name:1
132 msgid ""
133 "The name of this plugin. You must set it something other than Trivial Plugin"
134 " for it to work."
135 msgstr "Il nome di questo plugin. Devi impostarlo su un valore diverso da Trivial Plugin perché funzioni."
136
137 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
138 #: calibre.customize.MetadataReaderPlugin.version:1
139 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
140 #: calibre.customize.MetadataWriterPlugin.version:1
141 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
142 #: calibre.customize.Plugin.version:1
143 msgid "The version of this plugin as a 3-tuple (major, minor, revision)"
144 msgstr "La versione di questo plugin come tupla a 3 valori (maggiore, minore, revisione)"
145
146 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
147 #: calibre.customize.Plugin.description:1
148 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
149 #: of calibre.devices.usbms.driver.USBMS.description:1
150 msgid "A short string describing what this plugin does"
151 msgstr "Una breve stringa che descrive cosa fa questo plugin"
152
153 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
154 #: calibre.customize.InterfaceActionBase.author:1
155 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
156 #: calibre.customize.MetadataReaderPlugin.author:1
157 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
158 #: calibre.customize.MetadataWriterPlugin.author:1
159 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
160 #: calibre.customize.Plugin.author:1
161 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
162 #: calibre.customize.PreferencesPlugin.author:1
163 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
164 #: of calibre.devices.usbms.driver.USBMS.author:1
165 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
166 #: of calibre.ebooks.metadata.sources.base.Source.author:1
167 msgid "The author of this plugin"
168 msgstr "L'autore di questo plugin"
169
170 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
171 #: calibre.customize.Plugin.priority:1
172 msgid ""
173 "When more than one plugin exists for a filetype, the plugins are run in "
174 "order of decreasing priority. Plugins with higher priority will be run "
175 "first. The highest possible priority is ``sys.maxsize``. Default priority is"
176 " 1."
177 msgstr "Quando più di un plugin esiste per un tipo di file, i plugin vengono eseguiti in ordine di priorità decrescente. Plugin con priorità maggiore verranno eseguiti per primi. La più alta priorità possibile è ``sys.maxsize``. La priorità predefinita è 1."
178
179 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
180 #: calibre.customize.Plugin.minimum_calibre_version:1
181 msgid "The earliest version of calibre this plugin requires"
182 msgstr "La verisione piu' recente di calibre che questo plugin richiede"
183
184 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
185 #: calibre.customize.Plugin.installation_type:1
186 msgid "The way this plugin is installed"
187 msgstr "La modalità di installazione di questo plugin"
188
189 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
190 #: calibre.customize.Plugin.can_be_disabled:1
191 msgid ""
192 "If False, the user will not be able to disable this plugin. Use with care."
193 msgstr "Se False, l'utente non potrà disabilitare questo plugin. Usa con attenzione."
194
195 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
196 #: calibre.customize.CatalogPlugin.type:1
197 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
198 #: calibre.customize.FileTypePlugin.type:1
199 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
200 #: calibre.customize.InterfaceActionBase.type:1
201 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
202 #: calibre.customize.MetadataReaderPlugin.type:1
203 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
204 #: calibre.customize.MetadataWriterPlugin.type:1
205 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
206 #: calibre.customize.Plugin.type:1
207 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
208 #: calibre.customize.PreferencesPlugin.type:1
209 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
210 #: of calibre.customize.conversion.InputFormatPlugin.type:1
211 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
212 #: of calibre.customize.conversion.OutputFormatPlugin.type:1
213 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
214 #: calibre.devices.interface.DevicePlugin.type:1
215 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
216 #: of calibre.ebooks.metadata.sources.base.Source.type:1
217 msgid "The type of this plugin. Used for categorizing plugins in the GUI"
218 msgstr "Il tipo di questo plugin. Usato per categorizzare i plugin nell'interfaccia utente"
219
220 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
221 #: calibre.customize.Plugin.initialize:1
222 msgid ""
223 "Called once when calibre plugins are initialized. Plugins are re-"
224 "initialized every time a new plugin is added. Also note that if the plugin "
225 "is run in a worker process, such as for adding books, then the plugin will "
226 "be initialized for every new worker process."
227 msgstr "Chiamata una volta sola quando i plugin di calibre sono inizializzati. I plugin sono reinizializzati ogni volta che un nuovo plugin è aggiunto. Tieni anche presente che se il plugin viene eseguito in un processo di lavoro, come all'aggiunta di libri, il plugin verrà inizializzato per ogni nuovo processo di lavoro."
228
229 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
230 #: calibre.customize.Plugin.initialize:6
231 msgid ""
232 "Perform any plugin specific initialization here, such as extracting "
233 "resources from the plugin ZIP file. The path to the ZIP file is available as"
234 " ``self.plugin_path``."
235 msgstr "Esegui qui le inizializzazioni specifiche del plugin, se ce ne sono, come l'estrazione di risorse dal file ZIP del plugin. Il percorso del file ZIP è disponibile come ``self.plugin_path``."
236
237 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
238 #: calibre.customize.Plugin.initialize:10
239 msgid ""
240 "Note that ``self.site_customization`` is **not** available at this point."
241 msgstr "Tieni presente che ``self.site_customization`` **non** è disponibile a questo punto."
242
243 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
244 #: calibre.customize.Plugin.config_widget:1
245 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
246 #: of calibre.ebooks.metadata.sources.base.Source.config_widget:1
247 msgid ""
248 "Implement this method and :meth:`save_settings` in your plugin to use a "
249 "custom configuration dialog, rather then relying on the simple string based "
250 "default customization."
251 msgstr ""
252
253 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
254 #: calibre.customize.Plugin.config_widget:5
255 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
256 #: of calibre.ebooks.metadata.sources.base.Source.config_widget:5
257 msgid ""
258 "This method, if implemented, must return a QWidget. The widget can have an "
259 "optional method validate() that takes no arguments and is called immediately"
260 " after the user clicks OK. Changes are applied if and only if the method "
261 "returns True."
262 msgstr ""
263
264 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
265 #: calibre.customize.Plugin.config_widget:10
266 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
267 #: of calibre.ebooks.metadata.sources.base.Source.config_widget:10
268 msgid ""
269 "If for some reason you cannot perform the configuration at this time, return"
270 " a tuple of two strings (message, details), these will be displayed as a "
271 "warning dialog to the user and the process will be aborted."
272 msgstr ""
273
274 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
275 #: calibre.customize.Plugin.save_settings:1
276 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
277 #: of calibre.ebooks.metadata.sources.base.Source.save_settings:1
278 msgid "Save the settings specified by the user with config_widget."
279 msgstr ""
280
281 #: ../../../__w/calibre/calibre/manual/plugins.rst:0
282 msgid "Parameters"
283 msgstr "Parametri"
284
285 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
286 #: calibre.customize.Plugin.save_settings:3
287 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
288 #: of calibre.ebooks.metadata.sources.base.Source.save_settings:3
289 msgid "The widget returned by :meth:`config_widget`."
290 msgstr ""
291
292 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
293 #: calibre.customize.Plugin.do_user_config:1
294 msgid ""
295 "This method shows a configuration dialog for this plugin. It returns True if"
296 " the user clicks OK, False otherwise. The changes are automatically applied."
297 msgstr ""
298
299 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
300 #: calibre.customize.Plugin.load_resources:1
301 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
302 #: of calibre.gui2.actions.InterfaceAction.load_resources:1
303 msgid ""
304 "If this plugin comes in a ZIP file (user added plugin), this method will "
305 "allow you to load resources from the ZIP file."
306 msgstr ""
307
308 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
309 #: calibre.customize.Plugin.load_resources:4
310 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
311 #: of calibre.gui2.actions.InterfaceAction.load_resources:4
312 msgid "For example to load an image::"
313 msgstr ""
314
315 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
316 #: calibre.customize.Plugin.load_resources:10
317 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
318 #: of calibre.gui2.actions.InterfaceAction.load_resources:10
319 msgid "List of paths to resources in the ZIP file using / as separator"
320 msgstr ""
321
322 #: ../../../__w/calibre/calibre/manual/plugins.rst:0
323 msgid "Returns"
324 msgstr ""
325
326 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
327 #: calibre.customize.Plugin.load_resources:12
328 msgid ""
329 "A dictionary of the form ``{name: file_contents}``. Any names that were not "
330 "found in the ZIP file will not be present in the dictionary."
331 msgstr ""
332
333 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
334 #: calibre.customize.Plugin.customization_help:1
335 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
336 #: of calibre.ebooks.metadata.sources.base.Source.customization_help:1
337 msgid ""
338 "Return a string giving help on how to customize this plugin. By default "
339 "raise a :class:`NotImplementedError`, which indicates that the plugin does "
340 "not require customization."
341 msgstr ""
342
343 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
344 #: calibre.customize.Plugin.customization_help:5
345 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
346 #: of calibre.ebooks.metadata.sources.base.Source.customization_help:5
347 msgid ""
348 "If you re-implement this method in your subclass, the user will be asked to "
349 "enter a string as customization for this plugin. The customization string "
350 "will be available as ``self.site_customization``."
351 msgstr ""
352
353 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
354 #: calibre.customize.Plugin.customization_help:10
355 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
356 #: of calibre.ebooks.metadata.sources.base.Source.customization_help:10
357 msgid ""
358 "Site customization could be anything, for example, the path to a needed "
359 "binary on the user's computer."
360 msgstr ""
361
362 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
363 #: calibre.customize.Plugin.customization_help:13
364 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
365 #: of calibre.ebooks.metadata.sources.base.Source.customization_help:13
366 msgid "If True return HTML help, otherwise return plain text help."
367 msgstr ""
368
369 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
370 #: calibre.customize.Plugin.temporary_file:1
371 msgid ""
372 "Return a file-like object that is a temporary file on the file system. This "
373 "file will remain available even after being closed and will only be removed "
374 "on interpreter shutdown. Use the ``name`` member of the returned object to "
375 "access the full path to the created temporary file."
376 msgstr ""
377
378 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
379 #: calibre.customize.Plugin.temporary_file:6
380 msgid "The suffix that the temporary file will have."
381 msgstr "Il suffisso che avrà il file temporaneo."
382
383 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
384 #: calibre.customize.Plugin.cli_main:1
385 msgid ""
386 "This method is the main entry point for your plugins command line interface."
387 " It is called when the user does: calibre-debug -r \"Plugin Name\". Any "
388 "arguments passed are present in the args variable."
389 msgstr ""
390
391 #: ../../../__w/calibre/calibre/manual/plugins.rst:28
392 msgid "FileTypePlugin"
393 msgstr "FileTypePlugin"
394
395 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
396 #: calibre.customize.FileTypePlugin:1
397 msgid "A plugin that is associated with a particular set of file types."
398 msgstr ""
399
400 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
401 #: calibre.customize.FileTypePlugin.file_types:1
402 msgid ""
403 "Set of file types for which this plugin should be run. Use '*' for all file "
404 "types. For example: ``{'lit', 'mobi', 'prc'}``"
405 msgstr ""
406
407 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
408 #: calibre.customize.FileTypePlugin.on_import:1
409 msgid "If True, this plugin is run when books are added to the database"
410 msgstr ""
411
412 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
413 #: calibre.customize.FileTypePlugin.on_postimport:1
414 msgid ""
415 "If True, this plugin is run after books are added to the database. In this "
416 "case the postimport and postadd methods of the plugin are called."
417 msgstr ""
418
419 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
420 #: calibre.customize.FileTypePlugin.on_postconvert:1
421 msgid ""
422 "If True, this plugin is run after a book is converted. In this case the "
423 "postconvert method of the plugin is called."
424 msgstr ""
425
426 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
427 #: calibre.customize.FileTypePlugin.on_postdelete:1
428 msgid ""
429 "If True, this plugin is run after a book file is deleted from the database. "
430 "In this case the postdelete method of the plugin is called."
431 msgstr ""
432
433 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
434 #: calibre.customize.FileTypePlugin.on_preprocess:1
435 msgid "If True, this plugin is run just before a conversion"
436 msgstr ""
437
438 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
439 #: calibre.customize.FileTypePlugin.on_postprocess:1
440 msgid ""
441 "If True, this plugin is run after conversion on the final file produced by "
442 "the conversion output plugin."
443 msgstr ""
444
445 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
446 #: calibre.customize.FileTypePlugin.run:1
447 msgid ""
448 "Run the plugin. Must be implemented in subclasses. It should perform "
449 "whatever modifications are required on the e-book and return the absolute "
450 "path to the modified e-book. If no modifications are needed, it should "
451 "return the path to the original e-book. If an error is encountered it should"
452 " raise an Exception. The default implementation simply return the path to "
453 "the original e-book. Note that the path to the original file (before any "
454 "file type plugins are run, is available as self.original_path_to_file)."
455 msgstr ""
456
457 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
458 #: calibre.customize.FileTypePlugin.run:11
459 msgid ""
460 "The modified e-book file should be created with the :meth:`temporary_file` "
461 "method."
462 msgstr ""
463
464 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
465 #: calibre.customize.FileTypePlugin.run:14
466 msgid "Absolute path to the e-book."
467 msgstr ""
468
469 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
470 #: calibre.customize.FileTypePlugin.run:16
471 msgid "Absolute path to the modified e-book."
472 msgstr ""
473
474 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
475 #: calibre.customize.FileTypePlugin.postimport:1
476 msgid ""
477 "Called post import, i.e., after the book file has been added to the "
478 "database. Note that this is different from :meth:`postadd` which is called "
479 "when the book record is created for the first time. This method is called "
480 "whenever a new file is added to a book record. It is useful for modifying "
481 "the book record based on the contents of the newly added file."
482 msgstr ""
483
484 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
485 #: calibre.customize.FileTypePlugin.postadd:8
486 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
487 #: calibre.customize.FileTypePlugin.postconvert:5
488 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
489 #: calibre.customize.FileTypePlugin.postdelete:6
490 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
491 #: calibre.customize.FileTypePlugin.postimport:6
492 msgid "Database id of the added book."
493 msgstr ""
494
495 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
496 #: calibre.customize.FileTypePlugin.postconvert:6
497 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
498 #: calibre.customize.FileTypePlugin.postdelete:7
499 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
500 #: calibre.customize.FileTypePlugin.postimport:7
501 msgid "The file type of the book that was added."
502 msgstr "Il tipo di file del libro che è stato aggiunto."
503
504 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
505 #: calibre.customize.FileTypePlugin.postconvert:7
506 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
507 #: calibre.customize.FileTypePlugin.postdelete:8
508 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
509 #: calibre.customize.FileTypePlugin.postimport:8
510 msgid "Library database."
511 msgstr ""
512
513 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
514 #: calibre.customize.FileTypePlugin.postconvert:1
515 msgid ""
516 "Called post conversion, i.e., after the conversion output book file has been"
517 " added to the database. Note that it is run after a conversion only, not "
518 "after a book is added. It is useful for modifying the book record based on "
519 "the contents of the newly added file."
520 msgstr ""
521
522 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
523 #: calibre.customize.FileTypePlugin.postdelete:1
524 msgid ""
525 "Called post deletion, i.e., after the book file has been deleted from the "
526 "database. Note that it is not run when a book record is deleted, only when "
527 "one or more formats from the book are deleted. It is useful for modifying "
528 "the book record based on the format of the deleted file."
529 msgstr ""
530
531 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
532 #: calibre.customize.FileTypePlugin.postadd:1
533 msgid ""
534 "Called post add, i.e. after a book has been added to the db. Note that this "
535 "is different from :meth:`postimport`, which is called after a single book "
536 "file has been added to a book. postadd() is called only when an entire book "
537 "record with possibly more than one book file has been created for the first "
538 "time. This is useful if you wish to modify the book record in the database "
539 "when the book is first added to calibre."
540 msgstr ""
541
542 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
543 #: calibre.customize.FileTypePlugin.postadd:9
544 msgid ""
545 "Map of file format to path from which the file format was added. Note that "
546 "this might or might not point to an actual existing file, as sometimes files"
547 " are added as streams. In which case it might be a dummy value or a non-"
548 "existent path."
549 msgstr ""
550
551 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
552 #: calibre.customize.FileTypePlugin.postadd:13
553 msgid "Library database"
554 msgstr ""
555
556 #: ../../../__w/calibre/calibre/manual/plugins.rst:39
557 msgid "Metadata plugins"
558 msgstr ""
559
560 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
561 #: calibre.customize.MetadataReaderPlugin:1
562 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
563 #: calibre.customize.MetadataWriterPlugin:1
564 msgid "A plugin that implements reading metadata from a set of file types."
565 msgstr ""
566
567 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
568 #: calibre.customize.MetadataReaderPlugin.file_types:1
569 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
570 #: calibre.customize.MetadataWriterPlugin.file_types:1
571 msgid ""
572 "Set of file types for which this plugin should be run. For example: "
573 "``set(['lit', 'mobi', 'prc'])``"
574 msgstr ""
575
576 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
577 #: calibre.customize.MetadataReaderPlugin.get_metadata:1
578 msgid ""
579 "Return metadata for the file represented by stream (a file like object that "
580 "supports reading). Raise an exception when there is an error with the input "
581 "data."
582 msgstr ""
583
584 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
585 #: calibre.customize.MetadataReaderPlugin.get_metadata:5
586 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
587 #: calibre.customize.MetadataWriterPlugin.set_metadata:5
588 msgid ""
589 "The type of file. Guaranteed to be one of the entries in :attr:`file_types`."
590 msgstr ""
591
592 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
593 #: calibre.customize.MetadataReaderPlugin.get_metadata:7
594 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
595 #: calibre.customize.MetadataWriterPlugin.set_metadata:7
596 msgid "A :class:`calibre.ebooks.metadata.book.Metadata` object"
597 msgstr ""
598
599 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
600 #: calibre.customize.MetadataWriterPlugin.set_metadata:1
601 msgid ""
602 "Set metadata for the file represented by stream (a file like object that "
603 "supports reading). Raise an exception when there is an error with the input "
604 "data."
605 msgstr ""
606
607 #: ../../../__w/calibre/calibre/manual/plugins.rst:54
608 msgid "Catalog plugins"
609 msgstr ""
610
611 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
612 #: calibre.customize.CatalogPlugin:1
613 msgid "A plugin that implements a catalog generator."
614 msgstr ""
615
616 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
617 #: calibre.customize.CatalogPlugin.file_types:1
618 msgid ""
619 "Output file type for which this plugin should be run. For example: 'epub' or"
620 " 'xml'"
621 msgstr ""
622
623 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
624 #: calibre.customize.CatalogPlugin.cli_options:1
625 msgid ""
626 "CLI parser options specific to this plugin, declared as `namedtuple` "
627 "`Option`:"
628 msgstr ""
629
630 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
631 #: calibre.customize.CatalogPlugin.cli_options:3
632 msgid ""
633 "from collections import namedtuple Option = namedtuple('Option', 'option, "
634 "default, dest, help') cli_options = [Option('--catalog-title', default = 'My"
635 " Catalog', dest = 'catalog_title', help = (_('Title of generated catalog. "
636 "\\nDefault:') + \" '\" + '%default' + \"'\"))] cli_options parsed in "
637 "calibre.db.cli.cmd_catalog:option_parser()"
638 msgstr ""
639
640 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
641 #: calibre.customize.CatalogPlugin.initialize:1
642 msgid ""
643 "If plugin is not a built-in, copy the plugin's .ui and .py files from the "
644 "ZIP file to $TMPDIR. Tab will be dynamically generated and added to the "
645 "Catalog Options dialog in calibre.gui2.dialogs.catalog.py:Catalog"
646 msgstr ""
647
648 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
649 #: calibre.customize.CatalogPlugin.run:1
650 msgid ""
651 "Run the plugin. Must be implemented in subclasses. It should generate the "
652 "catalog in the format specified in file_types, returning the absolute path "
653 "to the generated catalog file. If an error is encountered it should raise an"
654 " Exception."
655 msgstr ""
656
657 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
658 #: calibre.customize.CatalogPlugin.run:7
659 msgid ""
660 "The generated catalog file should be created with the :meth:`temporary_file`"
661 " method."
662 msgstr ""
663
664 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
665 #: calibre.customize.CatalogPlugin.run:10
666 msgid "Absolute path to the generated catalog file."
667 msgstr ""
668
669 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
670 #: calibre.customize.CatalogPlugin.run:11
671 msgid "A dictionary of keyword arguments"
672 msgstr ""
673
674 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
675 #: calibre.customize.CatalogPlugin.run:12
676 msgid "A LibraryDatabase2 object"
677 msgstr ""
678
679 #: ../../../__w/calibre/calibre/manual/plugins.rst:64
680 msgid "Metadata download plugins"
681 msgstr ""
682
683 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
684 #: of calibre.ebooks.metadata.sources.base.Source.capabilities:1
685 msgid ""
686 "Set of capabilities supported by this plugin. Useful capabilities are: "
687 "'identify', 'cover'"
688 msgstr ""
689
690 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
691 #: of calibre.ebooks.metadata.sources.base.Source.touched_fields:1
692 msgid ""
693 "List of metadata fields that can potentially be download by this plugin "
694 "during the identify phase"
695 msgstr ""
696
697 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
698 #: of calibre.ebooks.metadata.sources.base.Source.has_html_comments:1
699 msgid "Set this to True if your plugin returns HTML formatted comments"
700 msgstr ""
701
702 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
703 #: of
704 #: calibre.ebooks.metadata.sources.base.Source.supports_gzip_transfer_encoding:1
705 msgid ""
706 "Setting this to True means that the browser object will indicate that it "
707 "supports gzip transfer encoding. This can speedup downloads but make sure "
708 "that the source actually supports gzip transfer encoding correctly first"
709 msgstr ""
710
711 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
712 #: of calibre.ebooks.metadata.sources.base.Source.ignore_ssl_errors:1
713 msgid ""
714 "Set this to True to ignore HTTPS certificate errors when connecting to this "
715 "source."
716 msgstr ""
717
718 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
719 #: of
720 #: calibre.ebooks.metadata.sources.base.Source.cached_cover_url_is_reliable:1
721 msgid ""
722 "Cached cover URLs can sometimes be unreliable (i.e. the download could fail "
723 "or the returned image could be bogus). If that is often the case with this "
724 "source, set to False"
725 msgstr ""
726
727 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
728 #: of calibre.ebooks.metadata.sources.base.Source.options:1
729 msgid ""
730 "A list of :class:`Option` objects. They will be used to automatically "
731 "construct the configuration widget for this plugin"
732 msgstr ""
733
734 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
735 #: of calibre.ebooks.metadata.sources.base.Source.config_help_message:1
736 msgid ""
737 "A string that is displayed at the top of the config widget for this plugin"
738 msgstr ""
739
740 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
741 #: of calibre.ebooks.metadata.sources.base.Source.can_get_multiple_covers:1
742 msgid "If True this source can return multiple covers for a given query"
743 msgstr ""
744
745 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
746 #: of calibre.ebooks.metadata.sources.base.Source.auto_trim_covers:1
747 msgid ""
748 "If set to True covers downloaded by this plugin are automatically trimmed."
749 msgstr ""
750
751 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
752 #: of calibre.ebooks.metadata.sources.base.Source.prefer_results_with_isbn:1
753 msgid ""
754 "If set to True, and this source returns multiple results for a query, some "
755 "of which have ISBNs and some of which do not, the results without ISBNs will"
756 " be ignored"
757 msgstr ""
758
759 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
760 #: of calibre.ebooks.metadata.sources.base.Source.is_configured:1
761 msgid ""
762 "Return False if your plugin needs to be configured before it can be used. "
763 "For example, it might need a username/password/API key."
764 msgstr ""
765
766 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
767 #: of calibre.ebooks.metadata.sources.base.Source.get_author_tokens:1
768 msgid ""
769 "Take a list of authors and return a list of tokens useful for an AND search "
770 "query. This function tries to return tokens in first name middle names last "
771 "name order, by assuming that if a comma is in the author name, the name is "
772 "in lastname, other names form."
773 msgstr ""
774
775 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
776 #: of calibre.ebooks.metadata.sources.base.Source.get_title_tokens:1
777 msgid ""
778 "Take a title and return a list of tokens useful for an AND search query. "
779 "Excludes connectives(optionally) and punctuation."
780 msgstr ""
781
782 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
783 #: of calibre.ebooks.metadata.sources.base.Source.split_jobs:1
784 msgid "Split a list of jobs into at most num groups, as evenly as possible"
785 msgstr ""
786
787 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
788 #: of calibre.ebooks.metadata.sources.base.Source.test_fields:1
789 msgid ""
790 "Return the first field from self.touched_fields that is null on the mi "
791 "object"
792 msgstr ""
793
794 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
795 #: of calibre.ebooks.metadata.sources.base.Source.clean_downloaded_metadata:1
796 msgid ""
797 "Call this method in your plugin's identify method to normalize metadata "
798 "before putting the Metadata object into result_queue. You can of course, use"
799 " a custom algorithm suited to your metadata source."
800 msgstr ""
801
802 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
803 #: of calibre.ebooks.metadata.sources.base.Source.get_book_url:1
804 msgid ""
805 "Return a 3-tuple or None. The 3-tuple is of the form: (identifier_type, "
806 "identifier_value, URL). The URL is the URL for the book identified by "
807 "identifiers at this source. identifier_type, identifier_value specify the "
808 "identifier corresponding to the URL. This URL must be browsable to by a "
809 "human using a browser. It is meant to provide a clickable link for the user "
810 "to easily visit the books page at this source. If no URL is found, return "
811 "None. This method must be quick, and consistent, so only implement it if it "
812 "is possible to construct the URL from a known scheme given identifiers."
813 msgstr ""
814
815 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
816 #: of calibre.ebooks.metadata.sources.base.Source.get_book_url_name:1
817 msgid "Return a human readable name from the return value of get_book_url()."
818 msgstr ""
819
820 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
821 #: of calibre.ebooks.metadata.sources.base.Source.get_book_urls:1
822 msgid ""
823 "Override this method if you would like to return multiple URLs for this "
824 "book. Return a list of 3-tuples. By default this method simply calls "
825 ":func:`get_book_url`."
826 msgstr ""
827
828 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
829 #: of calibre.ebooks.metadata.sources.base.Source.get_cached_cover_url:1
830 msgid ""
831 "Return cached cover URL for the book identified by the identifiers "
832 "dictionary or None if no such URL exists."
833 msgstr ""
834
835 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
836 #: of calibre.ebooks.metadata.sources.base.Source.get_cached_cover_url:4
837 msgid ""
838 "Note that this method must only return validated URLs, i.e. not URLS that "
839 "could result in a generic cover image or a not found error."
840 msgstr ""
841
842 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
843 #: of calibre.ebooks.metadata.sources.base.Source.id_from_url:1
844 msgid ""
845 "Parse a URL and return a tuple of the form: (identifier_type, "
846 "identifier_value). If the URL does not match the pattern for the metadata "
847 "source, return None."
848 msgstr ""
849
850 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
851 #: of calibre.ebooks.metadata.sources.base.Source.identify_results_keygen:1
852 msgid ""
853 "Return a function that is used to generate a key that can sort Metadata "
854 "objects by their relevance given a search query (title, authors, "
855 "identifiers)."
856 msgstr ""
857
858 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
859 #: of calibre.ebooks.metadata.sources.base.Source.identify_results_keygen:5
860 msgid "These keys are used to sort the results of a call to :meth:`identify`."
861 msgstr ""
862
863 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
864 #: of calibre.ebooks.metadata.sources.base.Source.identify_results_keygen:7
865 msgid ""
866 "For details on the default algorithm see "
867 ":class:`InternalMetadataCompareKeyGen`. Re-implement this function in your "
868 "plugin if the default algorithm is not suitable."
869 msgstr ""
870
871 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
872 #: of calibre.ebooks.metadata.sources.base.Source.identify:1
873 msgid "Identify a book by its Title/Author/ISBN/etc."
874 msgstr ""
875
876 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
877 #: of calibre.ebooks.metadata.sources.base.Source.identify:3
878 msgid ""
879 "If identifiers(s) are specified and no match is found and this metadata "
880 "source does not store all related identifiers (for example, all ISBNs of a "
881 "book), this method should retry with just the title and author (assuming "
882 "they were specified)."
883 msgstr ""
884
885 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
886 #: of calibre.ebooks.metadata.sources.base.Source.identify:8
887 msgid ""
888 "If this metadata source also provides covers, the URL to the cover should be"
889 " cached so that a subsequent call to the get covers API with the same "
890 "ISBN/special identifier does not need to get the cover URL again. Use the "
891 "caching API for this."
892 msgstr ""
893
894 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
895 #: of calibre.ebooks.metadata.sources.base.Source.identify:13
896 msgid ""
897 "Every Metadata object put into result_queue by this method must have a "
898 "`source_relevance` attribute that is an integer indicating the order in "
899 "which the results were returned by the metadata source for this query. This "
900 "integer will be used by :meth:`compare_identify_results`. If the order is "
901 "unimportant, set it to zero for every result."
902 msgstr ""
903
904 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
905 #: of calibre.ebooks.metadata.sources.base.Source.identify:19
906 msgid ""
907 "Make sure that any cover/ISBN mapping information is cached before the "
908 "Metadata object is put into result_queue."
909 msgstr ""
910
911 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
912 #: of calibre.ebooks.metadata.sources.base.Source.identify:22
913 msgid "A log object, use it to output debugging information/errors"
914 msgstr ""
915
916 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
917 #: of calibre.ebooks.metadata.sources.base.Source.identify:23
918 msgid ""
919 "A result Queue, results should be put into it. Each result is a Metadata "
920 "object"
921 msgstr ""
922
923 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
924 #: of calibre.ebooks.metadata.sources.base.Source.identify:25
925 msgid ""
926 "If abort.is_set() returns True, abort further processing and return as soon "
927 "as possible"
928 msgstr ""
929
930 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
931 #: of calibre.ebooks.metadata.sources.base.Source.identify:27
932 msgid "The title of the book, can be None"
933 msgstr ""
934
935 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
936 #: of calibre.ebooks.metadata.sources.base.Source.identify:28
937 msgid "A list of authors of the book, can be None"
938 msgstr ""
939
940 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
941 #: of calibre.ebooks.metadata.sources.base.Source.identify:29
942 msgid "A dictionary of other identifiers, most commonly {'isbn':'1234...'}"
943 msgstr ""
944
945 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
946 #: of calibre.ebooks.metadata.sources.base.Source.identify:31
947 msgid ""
948 "Timeout in seconds, no network request should hang for longer than timeout."
949 msgstr ""
950
951 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
952 #: of calibre.ebooks.metadata.sources.base.Source.identify:33
953 msgid ""
954 "None if no errors occurred, otherwise a unicode representation of the error "
955 "suitable for showing to the user"
956 msgstr ""
957
958 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
959 #: of calibre.ebooks.metadata.sources.base.Source.download_cover:1
960 msgid ""
961 "Download a cover and put it into result_queue. The parameters all have the "
962 "same meaning as for :meth:`identify`. Put (self, cover_data) into "
963 "result_queue."
964 msgstr ""
965
966 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
967 #: of calibre.ebooks.metadata.sources.base.Source.download_cover:5
968 msgid ""
969 "This method should use cached cover URLs for efficiency whenever possible. "
970 "When cached data is not present, most plugins simply call identify and use "
971 "its results."
972 msgstr ""
973
974 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
975 #: of calibre.ebooks.metadata.sources.base.Source.download_cover:9
976 msgid ""
977 "If the parameter get_best_cover is True and this plugin can get multiple "
978 "covers, it should only get the \"best\" one."
979 msgstr ""
980
981 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
982 #: of calibre.ebooks.metadata.sources.base.InternalMetadataCompareKeyGen:1
983 msgid ""
984 "Generate a sort key for comparison of the relevance of Metadata objects, "
985 "given a search query. This is used only to compare results from the same "
986 "metadata source, not across different sources."
987 msgstr ""
988
989 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
990 #: of calibre.ebooks.metadata.sources.base.InternalMetadataCompareKeyGen:5
991 msgid ""
992 "The sort key ensures that an ascending order sort is a sort by order of "
993 "decreasing relevance."
994 msgstr ""
995
996 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
997 #: of calibre.ebooks.metadata.sources.base.InternalMetadataCompareKeyGen:8
998 msgid "The algorithm is:"
999 msgstr "L'algoritmo è:"
1000
1001 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
1002 #: of calibre.ebooks.metadata.sources.base.InternalMetadataCompareKeyGen:10
1003 msgid ""
1004 "Prefer results that have at least one identifier the same as for the query"
1005 msgstr ""
1006
1007 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
1008 #: of calibre.ebooks.metadata.sources.base.InternalMetadataCompareKeyGen:11
1009 msgid "Prefer results with a cached cover URL"
1010 msgstr ""
1011
1012 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
1013 #: of calibre.ebooks.metadata.sources.base.InternalMetadataCompareKeyGen:12
1014 msgid "Prefer results with all available fields filled in"
1015 msgstr ""
1016
1017 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
1018 #: of calibre.ebooks.metadata.sources.base.InternalMetadataCompareKeyGen:13
1019 msgid ""
1020 "Prefer results with the same language as the current user interface language"
1021 msgstr ""
1022
1023 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
1024 #: of calibre.ebooks.metadata.sources.base.InternalMetadataCompareKeyGen:14
1025 msgid "Prefer results that are an exact title match to the query"
1026 msgstr ""
1027
1028 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
1029 #: of calibre.ebooks.metadata.sources.base.InternalMetadataCompareKeyGen:15
1030 msgid "Prefer results with longer comments (greater than 10% longer)"
1031 msgstr ""
1032
1033 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
1034 #: of calibre.ebooks.metadata.sources.base.InternalMetadataCompareKeyGen:16
1035 msgid ""
1036 "Use the relevance of the result as reported by the metadata source's search"
1037 msgstr ""
1038
1039 #: ../../../__w/calibre/calibre/src/calibre/ebooks/metadata/sources/base.pydocstring
1040 #: of calibre.ebooks.metadata.sources.base.InternalMetadataCompareKeyGen:17
1041 msgid "engine"
1042 msgstr "motore"
1043
1044 #: ../../../__w/calibre/calibre/manual/plugins.rst:76
1045 msgid "Conversion plugins"
1046 msgstr ""
1047
1048 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1049 #: of calibre.customize.conversion.InputFormatPlugin:1
1050 msgid ""
1051 "InputFormatPlugins are responsible for converting a document into "
1052 "HTML+OPF+CSS+etc. The results of the conversion *must* be encoded in UTF-8. "
1053 "The main action happens in :meth:`convert`."
1054 msgstr ""
1055
1056 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1057 #: of calibre.customize.conversion.InputFormatPlugin.file_types:1
1058 msgid ""
1059 "Set of file types for which this plugin should be run For example: "
1060 "``set(['azw', 'mobi', 'prc'])``"
1061 msgstr ""
1062
1063 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1064 #: of calibre.customize.conversion.InputFormatPlugin.is_image_collection:1
1065 msgid ""
1066 "If True, this input plugin generates a collection of images, one per HTML "
1067 "file. This can be set dynamically, in the convert method if the input files "
1068 "can be both image collections and non-image collections. If you set this to "
1069 "True, you must implement the get_images() method that returns a list of "
1070 "images."
1071 msgstr ""
1072
1073 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1074 #: of calibre.customize.conversion.InputFormatPlugin.core_usage:1
1075 msgid ""
1076 "Number of CPU cores used by this plugin. A value of -1 means that it uses "
1077 "all available cores"
1078 msgstr ""
1079
1080 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1081 #: of calibre.customize.conversion.InputFormatPlugin.for_viewer:1
1082 msgid ""
1083 "If set to True, the input plugin will perform special processing to make its"
1084 " output suitable for viewing"
1085 msgstr ""
1086
1087 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1088 #: of calibre.customize.conversion.InputFormatPlugin.output_encoding:1
1089 msgid ""
1090 "The encoding that this input plugin creates files in. A value of None means "
1091 "that the encoding is undefined and must be detected individually"
1092 msgstr ""
1093
1094 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1095 #: of calibre.customize.conversion.InputFormatPlugin.common_options:1
1096 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1097 #: of calibre.customize.conversion.OutputFormatPlugin.common_options:1
1098 msgid ""
1099 "Options shared by all Input format plugins. Do not override in sub-classes. "
1100 "Use :attr:`options` instead. Every option must be an instance of "
1101 ":class:`OptionRecommendation`."
1102 msgstr ""
1103
1104 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1105 #: of calibre.customize.conversion.InputFormatPlugin.options:1
1106 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1107 #: of calibre.customize.conversion.OutputFormatPlugin.options:1
1108 msgid ""
1109 "Options to customize the behavior of this plugin. Every option must be an "
1110 "instance of :class:`OptionRecommendation`."
1111 msgstr ""
1112
1113 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1114 #: of calibre.customize.conversion.InputFormatPlugin.recommendations:1
1115 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1116 #: of calibre.customize.conversion.OutputFormatPlugin.recommendations:1
1117 msgid ""
1118 "A set of 3-tuples of the form (option_name, recommended_value, "
1119 "recommendation_level)"
1120 msgstr ""
1121
1122 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1123 #: of calibre.customize.conversion.InputFormatPlugin.get_images:1
1124 msgid ""
1125 "Return a list of absolute paths to the images, if this input plugin "
1126 "represents an image collection. The list of images is in the same order as "
1127 "the spine and the TOC."
1128 msgstr ""
1129
1130 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1131 #: of calibre.customize.conversion.InputFormatPlugin.convert:1
1132 msgid ""
1133 "This method must be implemented in sub-classes. It must return the path to "
1134 "the created OPF file or an :class:`OEBBook` instance. All output should be "
1135 "contained in the current folder. If this plugin creates files outside the "
1136 "current folder they must be deleted/marked for deletion before this method "
1137 "returns."
1138 msgstr ""
1139
1140 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1141 #: of calibre.customize.conversion.InputFormatPlugin.convert:8
1142 msgid "A file like object that contains the input file."
1143 msgstr ""
1144
1145 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1146 #: of calibre.customize.conversion.InputFormatPlugin.convert:9
1147 msgid ""
1148 "Options to customize the conversion process. Guaranteed to have attributes "
1149 "corresponding to all the options declared by this plugin. In addition, it "
1150 "will have a verbose attribute that takes integral values from zero upwards. "
1151 "Higher numbers mean be more verbose. Another useful attribute is "
1152 "``input_profile`` that is an instance of "
1153 ":class:`calibre.customize.profiles.InputProfile`."
1154 msgstr ""
1155
1156 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1157 #: of calibre.customize.conversion.InputFormatPlugin.convert:17
1158 msgid ""
1159 "The extension (without the .) of the input file. It is guaranteed to be one "
1160 "of the `file_types` supported by this plugin."
1161 msgstr ""
1162
1163 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1164 #: of calibre.customize.conversion.InputFormatPlugin.convert:20
1165 msgid ""
1166 "A :class:`calibre.utils.logging.Log` object. All output should use this "
1167 "object."
1168 msgstr ""
1169
1170 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1171 #: of calibre.customize.conversion.InputFormatPlugin.convert:22
1172 msgid ""
1173 "A dictionary of various information that the input plugin can get easily "
1174 "that would speed up the subsequent stages of the conversion."
1175 msgstr ""
1176
1177 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1178 #: of calibre.customize.conversion.InputFormatPlugin.postprocess_book:1
1179 msgid ""
1180 "Called to allow the input plugin to perform postprocessing after the book "
1181 "has been parsed."
1182 msgstr ""
1183
1184 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1185 #: of calibre.customize.conversion.InputFormatPlugin.specialize:1
1186 msgid ""
1187 "Called to allow the input plugin to specialize the parsed book for a "
1188 "particular output format. Called after postprocess_book and before any "
1189 "transforms are performed on the parsed book."
1190 msgstr ""
1191
1192 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1193 #: of
1194 #: calibre.customize.conversion.InputFormatPlugin.gui_configuration_widget:1
1195 msgid ""
1196 "Called to create the widget used for configuring this plugin in the calibre "
1197 "GUI. The widget must be an instance of the PluginWidget class. See the "
1198 "builtin input plugins for examples."
1199 msgstr ""
1200
1201 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1202 #: of calibre.customize.conversion.OutputFormatPlugin:1
1203 msgid ""
1204 "OutputFormatPlugins are responsible for converting an OEB document "
1205 "(OPF+HTML) into an output e-book."
1206 msgstr ""
1207
1208 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1209 #: of calibre.customize.conversion.OutputFormatPlugin:4
1210 msgid ""
1211 "The OEB document can be assumed to be encoded in UTF-8. The main action "
1212 "happens in :meth:`convert`."
1213 msgstr ""
1214
1215 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1216 #: of calibre.customize.conversion.OutputFormatPlugin.file_type:1
1217 msgid ""
1218 "The file type (extension without leading period) that this plugin outputs"
1219 msgstr ""
1220
1221 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1222 #: of calibre.customize.conversion.OutputFormatPlugin.description:1
1223 msgid ""
1224 "str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str"
1225 msgstr ""
1226
1227 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1228 #: of calibre.customize.conversion.OutputFormatPlugin.description:4
1229 msgid ""
1230 "Create a new string object from the given object. If encoding or errors is "
1231 "specified, then the object must expose a data buffer that will be decoded "
1232 "using the given encoding and error handler. Otherwise, returns the result of"
1233 " object.__str__() (if defined) or repr(object). encoding defaults to "
1234 "'utf-8'. errors defaults to 'strict'."
1235 msgstr ""
1236
1237 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1238 #: of calibre.customize.conversion.OutputFormatPlugin.convert:1
1239 msgid ""
1240 "Render the contents of `oeb_book` (which is an instance of "
1241 ":class:`calibre.ebooks.oeb.OEBBook`) to the file specified by output."
1242 msgstr ""
1243
1244 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1245 #: of calibre.customize.conversion.OutputFormatPlugin.convert:4
1246 msgid ""
1247 "Either a file like object or a string. If it is a string it is the path to a"
1248 " folder that may or may not exist. The output plugin should write its output"
1249 " into that folder. If it is a file like object, the output plugin should "
1250 "write its output into the file."
1251 msgstr ""
1252
1253 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1254 #: of calibre.customize.conversion.OutputFormatPlugin.convert:8
1255 msgid ""
1256 "The input plugin that was used at the beginning of the conversion pipeline."
1257 msgstr ""
1258
1259 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1260 #: of calibre.customize.conversion.OutputFormatPlugin.convert:10
1261 msgid ""
1262 "Conversion options. Guaranteed to have attributes corresponding to the "
1263 "OptionRecommendations of this plugin."
1264 msgstr ""
1265
1266 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1267 #: of calibre.customize.conversion.OutputFormatPlugin.convert:12
1268 msgid "The logger. Print debug/info messages etc. using this."
1269 msgstr ""
1270
1271 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1272 #: of calibre.customize.conversion.OutputFormatPlugin.specialize_options:1
1273 msgid ""
1274 "Can be used to change the values of conversion options, as used by the "
1275 "conversion pipeline."
1276 msgstr ""
1277
1278 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1279 #: of
1280 #: calibre.customize.conversion.OutputFormatPlugin.specialize_css_for_output:1
1281 msgid ""
1282 "Can be used to make changes to the CSS during the CSS flattening process."
1283 msgstr ""
1284
1285 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1286 #: of
1287 #: calibre.customize.conversion.OutputFormatPlugin.specialize_css_for_output:4
1288 msgid "The item (HTML file) being processed"
1289 msgstr "L'elemento (file HTML) in corso di elaborazione"
1290
1291 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1292 #: of
1293 #: calibre.customize.conversion.OutputFormatPlugin.specialize_css_for_output:5
1294 msgid ""
1295 "A Stylizer object containing the flattened styles for item. You can get the "
1296 "style for any element by stylizer.style(element)."
1297 msgstr ""
1298
1299 #: ../../../__w/calibre/calibre/src/calibre/customize/conversion.pydocstring
1300 #: of
1301 #: calibre.customize.conversion.OutputFormatPlugin.gui_configuration_widget:1
1302 msgid ""
1303 "Called to create the widget used for configuring this plugin in the calibre "
1304 "GUI. The widget must be an instance of the PluginWidget class. See the "
1305 "builtin output plugins for examples."
1306 msgstr ""
1307
1308 #: ../../../__w/calibre/calibre/manual/plugins.rst:91
1309 msgid "Device drivers"
1310 msgstr ""
1311
1312 #: ../../../__w/calibre/calibre/manual/plugins.rst:95
1313 msgid ""
1314 "The base class for all device drivers is :class:`DevicePlugin`. However, if "
1315 "your device exposes itself as a USBMS drive to the operating system, you "
1316 "should use the USBMS class instead as it implements all the logic needed to "
1317 "support these kinds of devices."
1318 msgstr ""
1319
1320 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1321 #: calibre.devices.interface.DevicePlugin:1
1322 msgid ""
1323 "Defines the interface that should be implemented by backends that "
1324 "communicate with an e-book reader."
1325 msgstr ""
1326
1327 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1328 #: calibre.devices.interface.DevicePlugin.FORMATS:1
1329 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1330 #: of calibre.devices.usbms.driver.USBMS.FORMATS:1
1331 msgid "Ordered list of supported formats"
1332 msgstr ""
1333
1334 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1335 #: calibre.devices.interface.DevicePlugin.VENDOR_ID:1
1336 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1337 #: of calibre.devices.usbms.device.Device.VENDOR_ID:1
1338 msgid ""
1339 "VENDOR_ID can be either an integer, a list of integers or a dictionary If it"
1340 " is a dictionary, it must be a dictionary of dictionaries, of the form::"
1341 msgstr ""
1342
1343 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1344 #: calibre.devices.interface.DevicePlugin.PRODUCT_ID:1
1345 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1346 #: of calibre.devices.usbms.device.Device.PRODUCT_ID:1
1347 msgid "An integer or a list of integers"
1348 msgstr ""
1349
1350 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1351 #: calibre.devices.interface.DevicePlugin.BCD:1
1352 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1353 #: of calibre.devices.usbms.device.Device.BCD:1
1354 msgid ""
1355 "BCD can be either None to not distinguish between devices based on BCD, or "
1356 "it can be a list of the BCD numbers of all devices supported by this driver."
1357 msgstr ""
1358
1359 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1360 #: calibre.devices.interface.DevicePlugin.THUMBNAIL_HEIGHT:1
1361 msgid "Height for thumbnails on the device"
1362 msgstr ""
1363
1364 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1365 #: calibre.devices.interface.DevicePlugin.THUMBNAIL_COMPRESSION_QUALITY:1
1366 msgid ""
1367 "Compression quality for thumbnails. Set this closer to 100 to have better "
1368 "quality thumbnails with fewer compression artifacts. Of course, the "
1369 "thumbnails get larger as well."
1370 msgstr ""
1371
1372 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1373 #: calibre.devices.interface.DevicePlugin.WANTS_UPDATED_THUMBNAILS:1
1374 msgid ""
1375 "Set this to True if the device supports updating cover thumbnails during "
1376 "sync_booklists. Setting it to true will ask device.py to refresh the cover "
1377 "thumbnails during book matching"
1378 msgstr ""
1379
1380 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1381 #: calibre.devices.interface.DevicePlugin.CAN_SET_METADATA:1
1382 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1383 #: of calibre.devices.usbms.driver.USBMS.CAN_SET_METADATA:1
1384 msgid "Whether the metadata on books can be set via the GUI."
1385 msgstr ""
1386
1387 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1388 #: calibre.devices.interface.DevicePlugin.CAN_DO_DEVICE_DB_PLUGBOARD:1
1389 msgid "Whether the device can handle device_db metadata plugboards"
1390 msgstr ""
1391
1392 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1393 #: calibre.devices.interface.DevicePlugin.path_sep:1
1394 msgid "Path separator for paths to books on device"
1395 msgstr ""
1396
1397 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1398 #: calibre.devices.interface.DevicePlugin.icon:1
1399 msgid "Icon for this device"
1400 msgstr "L'icona per questo dispositivo"
1401
1402 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1403 #: calibre.devices.interface.DevicePlugin.OPEN_FEEDBACK_MESSAGE:1
1404 msgid ""
1405 "GUI displays this as a message if not None in the status bar. Useful if "
1406 "opening can take a long time"
1407 msgstr ""
1408
1409 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1410 #: calibre.devices.interface.DevicePlugin.VIRTUAL_BOOK_EXTENSIONS:1
1411 msgid ""
1412 "Set of extensions that are \"virtual books\" on the device and therefore "
1413 "cannot be viewed/saved/added to library. For example: "
1414 "``frozenset(['kobo'])``"
1415 msgstr ""
1416
1417 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1418 #: calibre.devices.interface.DevicePlugin.VIRTUAL_BOOK_EXTENSION_MESSAGE:1
1419 msgid "Message to display to user for virtual book extensions."
1420 msgstr ""
1421
1422 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1423 #: calibre.devices.interface.DevicePlugin.NUKE_COMMENTS:1
1424 msgid ""
1425 "Whether to nuke comments in the copy of the book sent to the device. If not "
1426 "None this should be short string that the comments will be replaced by."
1427 msgstr ""
1428
1429 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1430 #: calibre.devices.interface.DevicePlugin.MANAGES_DEVICE_PRESENCE:1
1431 msgid ""
1432 "If True indicates that this driver completely manages device detection, "
1433 "ejecting and so forth. If you set this to True, you *must* implement the "
1434 "detect_managed_devices and debug_managed_device_detection methods. A driver "
1435 "with this set to true is responsible for detection of devices, managing a "
1436 "blacklist of devices, a list of ejected devices and so forth. calibre will "
1437 "periodically call the detect_managed_devices() method and if it returns a "
1438 "detected device, calibre will call open(). open() will be called every time "
1439 "a device is returned even if previous calls to open() failed, therefore the "
1440 "driver must maintain its own blacklist of failed devices. Similarly, when "
1441 "ejecting, calibre will call eject() and then assuming the next call to "
1442 "detect_managed_devices() returns None, it will call post_yank_cleanup()."
1443 msgstr ""
1444
1445 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1446 #: calibre.devices.interface.DevicePlugin.SLOW_DRIVEINFO:1
1447 msgid ""
1448 "If set the True, calibre will call the :meth:`get_driveinfo()` method after "
1449 "the books lists have been loaded to get the driveinfo."
1450 msgstr ""
1451
1452 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1453 #: calibre.devices.interface.DevicePlugin.ASK_TO_ALLOW_CONNECT:1
1454 msgid ""
1455 "If set to True, calibre will ask the user if they want to manage the device "
1456 "with calibre, the first time it is detected. If you set this to True you "
1457 "must implement :meth:`get_device_uid()` and "
1458 ":meth:`ignore_connected_device()` and :meth:`get_user_blacklisted_devices` "
1459 "and :meth:`set_user_blacklisted_devices`"
1460 msgstr ""
1461
1462 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1463 #: calibre.devices.interface.DevicePlugin.user_feedback_after_callback:1
1464 msgid ""
1465 "Set this to a dictionary of the form {'title':title, 'msg':msg, "
1466 "'det_msg':detailed_msg} to have calibre popup a message to the user after "
1467 "some callbacks are run (currently only upload_books). Be careful to not spam"
1468 " the user with too many messages. This variable is checked after *every* "
1469 "callback, so only set it when you really need to."
1470 msgstr ""
1471
1472 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1473 #: calibre.devices.interface.DevicePlugin.get_open_popup_message:1
1474 msgid ""
1475 "GUI displays this as a non-modal popup. Should be an instance of "
1476 "OpenPopupMessage"
1477 msgstr ""
1478
1479 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1480 #: calibre.devices.interface.DevicePlugin.model_metadata:1
1481 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1482 #: of calibre.devices.usbms.device.Device.model_metadata:1
1483 msgid "Metadata about all the actual device models this driver supports"
1484 msgstr ""
1485
1486 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1487 #: calibre.devices.interface.DevicePlugin.is_usb_connected:1
1488 msgid ""
1489 "Return True, device_info if a device handled by this plugin is currently "
1490 "connected."
1491 msgstr ""
1492
1493 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1494 #: calibre.devices.interface.DevicePlugin.is_usb_connected:3
1495 msgid "List of devices currently connected"
1496 msgstr "Elenco di dispositivi attualmente connessi"
1497
1498 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1499 #: calibre.devices.interface.DevicePlugin.debug_managed_device_detection:1
1500 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1501 #: calibre.devices.interface.DevicePlugin.detect_managed_devices:1
1502 msgid "Called only if MANAGES_DEVICE_PRESENCE is True."
1503 msgstr ""
1504
1505 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1506 #: calibre.devices.interface.DevicePlugin.detect_managed_devices:3
1507 msgid ""
1508 "Scan for devices that this driver can handle. Should return a device object "
1509 "if a device is found. This object will be passed to the open() method as the"
1510 " connected_device. If no device is found, return None. The returned object "
1511 "can be anything, calibre does not use it, it is only passed to open()."
1512 msgstr ""
1513
1514 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1515 #: calibre.devices.interface.DevicePlugin.detect_managed_devices:9
1516 msgid ""
1517 "This method is called periodically by the GUI, so make sure it is not too "
1518 "resource intensive. Use a cache to avoid repeatedly scanning the system."
1519 msgstr ""
1520
1521 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1522 #: calibre.devices.interface.DevicePlugin.detect_managed_devices:13
1523 msgid "Set of USB devices found on the system."
1524 msgstr ""
1525
1526 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1527 #: calibre.devices.interface.DevicePlugin.detect_managed_devices:15
1528 msgid ""
1529 "If True and the driver uses a cache to prevent repeated scanning, the cache "
1530 "must be flushed."
1531 msgstr ""
1532
1533 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1534 #: calibre.devices.interface.DevicePlugin.debug_managed_device_detection:3
1535 msgid ""
1536 "Should write information about the devices detected on the system to output,"
1537 " which is a file like object."
1538 msgstr ""
1539
1540 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1541 #: calibre.devices.interface.DevicePlugin.debug_managed_device_detection:6
1542 msgid ""
1543 "Should return True if a device was detected and successfully opened, "
1544 "otherwise False."
1545 msgstr ""
1546
1547 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1548 #: calibre.devices.interface.DevicePlugin.reset:1
1549 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1550 #: of calibre.devices.usbms.device.Device.reset:1
1551 msgid "The key to unlock the device"
1552 msgstr "Il tasto per sbloccare il dispositivo"
1553
1554 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1555 #: calibre.devices.interface.DevicePlugin.reset:2
1556 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1557 #: of calibre.devices.usbms.device.Device.reset:2
1558 msgid "If true the packet stream to/from the device is logged"
1559 msgstr ""
1560
1561 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1562 #: calibre.devices.interface.DevicePlugin.reset:3
1563 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1564 #: calibre.devices.interface.DevicePlugin.set_progress_reporter:3
1565 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1566 #: of calibre.devices.usbms.device.Device.reset:3
1567 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1568 #: of calibre.devices.usbms.device.Device.set_progress_reporter:3
1569 msgid ""
1570 "Function that is called with a % progress (number between 0 and 100) for "
1571 "various tasks. If it is called with -1 that means that the task does not "
1572 "have any progress information"
1573 msgstr ""
1574
1575 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1576 #: calibre.devices.interface.DevicePlugin.reset:7
1577 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1578 #: of calibre.devices.usbms.device.Device.reset:7
1579 msgid "Device information from the device scanner"
1580 msgstr ""
1581
1582 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1583 #: calibre.devices.interface.DevicePlugin.can_handle_windows:1
1584 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1585 #: of calibre.devices.usbms.device.Device.can_handle_windows:1
1586 msgid ""
1587 "Optional method to perform further checks on a device to see if this driver "
1588 "is capable of handling it. If it is not it should return False. This method "
1589 "is only called after the vendor, product ids and the bcd have matched, so it"
1590 " can do some relatively time intensive checks. The default implementation "
1591 "returns True. This method is called only on Windows. See also "
1592 ":meth:`can_handle`."
1593 msgstr ""
1594
1595 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1596 #: calibre.devices.interface.DevicePlugin.can_handle_windows:8
1597 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1598 #: of calibre.devices.usbms.device.Device.can_handle_windows:8
1599 msgid ""
1600 "Note that for devices based on USBMS this method by default delegates to "
1601 ":meth:`can_handle`. So you only need to override :meth:`can_handle` in your"
1602 " subclass of USBMS."
1603 msgstr ""
1604
1605 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1606 #: calibre.devices.interface.DevicePlugin.can_handle_windows:12
1607 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1608 #: of calibre.devices.usbms.device.Device.can_handle_windows:12
1609 msgid ""
1610 "A usbdevice as returned by :func:`calibre.devices.winusb.scan_usb_devices`"
1611 msgstr ""
1612
1613 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1614 #: calibre.devices.interface.DevicePlugin.can_handle:1
1615 msgid "Unix version of :meth:`can_handle_windows`."
1616 msgstr ""
1617
1618 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1619 #: calibre.devices.interface.DevicePlugin.can_handle:3
1620 msgid "Is a tuple of (vid, pid, bcd, manufacturer, product, serial number)"
1621 msgstr ""
1622
1623 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1624 #: calibre.devices.interface.DevicePlugin.open:1
1625 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1626 #: of calibre.devices.usbms.device.Device.open:1
1627 msgid ""
1628 "Perform any device specific initialization. Called after the device is "
1629 "detected but before any other functions that communicate with the device. "
1630 "For example: For devices that present themselves as USB Mass storage "
1631 "devices, this method would be responsible for mounting the device or if the "
1632 "device has been automounted, for finding out where it has been mounted. The "
1633 "method :meth:`calibre.devices.usbms.device.Device.open` has an "
1634 "implementation of this function that should serve as a good example for USB "
1635 "Mass storage devices."
1636 msgstr ""
1637
1638 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1639 #: calibre.devices.interface.DevicePlugin.open:11
1640 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1641 #: of calibre.devices.usbms.device.Device.open:11
1642 msgid ""
1643 "This method can raise an OpenFeedback exception to display a message to the "
1644 "user."
1645 msgstr ""
1646
1647 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1648 #: calibre.devices.interface.DevicePlugin.open:14
1649 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1650 #: of calibre.devices.usbms.device.Device.open:14
1651 msgid ""
1652 "The device that we are trying to open. It is a tuple of (vendor id, product "
1653 "id, bcd, manufacturer name, product name, device serial number). However, "
1654 "some devices have no serial number and on Windows only the first three "
1655 "fields are present, the rest are None."
1656 msgstr ""
1657
1658 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1659 #: calibre.devices.interface.DevicePlugin.open:20
1660 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1661 #: of calibre.devices.usbms.device.Device.open:20
1662 msgid ""
1663 "The UUID of the current calibre library. Can be None if there is no library "
1664 "(for example when used from the command line)."
1665 msgstr ""
1666
1667 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1668 #: calibre.devices.interface.DevicePlugin.eject:1
1669 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1670 #: of calibre.devices.usbms.device.Device.eject:1
1671 msgid ""
1672 "Un-mount / eject the device from the OS. This does not check if there are "
1673 "pending GUI jobs that need to communicate with the device."
1674 msgstr ""
1675
1676 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1677 #: calibre.devices.interface.DevicePlugin.eject:4
1678 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1679 #: of calibre.devices.usbms.device.Device.eject:4
1680 msgid ""
1681 "NOTE: That this method may not be called on the same thread as the rest of "
1682 "the device methods."
1683 msgstr ""
1684
1685 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1686 #: calibre.devices.interface.DevicePlugin.post_yank_cleanup:1
1687 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1688 #: of calibre.devices.usbms.device.Device.post_yank_cleanup:1
1689 msgid "Called if the user yanks the device without ejecting it first."
1690 msgstr ""
1691
1692 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1693 #: calibre.devices.interface.DevicePlugin.set_progress_reporter:1
1694 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1695 #: of calibre.devices.usbms.device.Device.set_progress_reporter:1
1696 msgid "Set a function to report progress information."
1697 msgstr ""
1698
1699 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1700 #: calibre.devices.interface.DevicePlugin.get_device_information:1
1701 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1702 #: of calibre.devices.usbms.driver.USBMS.get_device_information:1
1703 msgid "Ask device for device information. See L{DeviceInfoQuery}."
1704 msgstr ""
1705
1706 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1707 #: calibre.devices.interface.DevicePlugin.get_device_information:3
1708 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1709 #: of calibre.devices.usbms.driver.USBMS.get_device_information:3
1710 msgid ""
1711 "(device name, device version, software version on device, MIME type) The "
1712 "tuple can optionally have a fifth element, which is a drive information "
1713 "dictionary. See usbms.driver for an example."
1714 msgstr ""
1715
1716 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1717 #: calibre.devices.interface.DevicePlugin.get_driveinfo:1
1718 msgid ""
1719 "Return the driveinfo dictionary. Usually called from "
1720 "get_device_information(), but if loading the driveinfo is slow for this "
1721 "driver, then it should set SLOW_DRIVEINFO. In this case, this method will be"
1722 " called by calibre after the book lists have been loaded. Note that it is "
1723 "not called on the device thread, so the driver should cache the drive info "
1724 "in the books() method and this function should return the cached data."
1725 msgstr ""
1726
1727 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1728 #: calibre.devices.interface.DevicePlugin.card_prefix:1
1729 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1730 #: of calibre.devices.usbms.device.Device.card_prefix:1
1731 msgid ""
1732 "Return a 2 element list of the prefix to paths on the cards. If no card is "
1733 "present None is set for the card's prefix. E.G. ('/place', '/place2') (None,"
1734 " 'place2') ('place', None) (None, None)"
1735 msgstr ""
1736
1737 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1738 #: calibre.devices.interface.DevicePlugin.total_space:1
1739 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1740 #: of calibre.devices.usbms.device.Device.total_space:1
1741 msgid "Get total space available on the mountpoints:"
1742 msgstr ""
1743
1744 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1745 #: calibre.devices.interface.DevicePlugin.free_space:2
1746 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1747 #: calibre.devices.interface.DevicePlugin.total_space:2
1748 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1749 #: of calibre.devices.usbms.device.Device.free_space:2
1750 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1751 #: of calibre.devices.usbms.device.Device.total_space:2
1752 msgid "Main memory"
1753 msgstr "Memoria principale"
1754
1755 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1756 #: calibre.devices.interface.DevicePlugin.total_space:3
1757 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1758 #: of calibre.devices.usbms.device.Device.total_space:3
1759 msgid "Memory Card A"
1760 msgstr ""
1761
1762 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1763 #: calibre.devices.interface.DevicePlugin.total_space:4
1764 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1765 #: of calibre.devices.usbms.device.Device.total_space:4
1766 msgid "Memory Card B"
1767 msgstr ""
1768
1769 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1770 #: calibre.devices.interface.DevicePlugin.total_space:6
1771 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1772 #: of calibre.devices.usbms.device.Device.total_space:6
1773 msgid ""
1774 "A 3 element list with total space in bytes of (1, 2, 3). If a particular "
1775 "device doesn't have any of these locations it should return 0."
1776 msgstr ""
1777
1778 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1779 #: calibre.devices.interface.DevicePlugin.free_space:1
1780 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1781 #: of calibre.devices.usbms.device.Device.free_space:1
1782 msgid "Get free space available on the mountpoints:"
1783 msgstr ""
1784
1785 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1786 #: calibre.devices.interface.DevicePlugin.free_space:3
1787 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1788 #: of calibre.devices.usbms.device.Device.free_space:3
1789 msgid "Card A"
1790 msgstr "Scheda A"
1791
1792 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1793 #: calibre.devices.interface.DevicePlugin.free_space:4
1794 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1795 #: of calibre.devices.usbms.device.Device.free_space:4
1796 msgid "Card B"
1797 msgstr "Scheda B"
1798
1799 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1800 #: calibre.devices.interface.DevicePlugin.free_space:6
1801 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
1802 #: of calibre.devices.usbms.device.Device.free_space:6
1803 msgid ""
1804 "A 3 element list with free space in bytes of (1, 2, 3). If a particular "
1805 "device doesn't have any of these locations it should return -1."
1806 msgstr ""
1807
1808 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1809 #: calibre.devices.interface.DevicePlugin.books:1
1810 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1811 #: of calibre.devices.usbms.driver.USBMS.books:1
1812 msgid "Return a list of e-books on the device."
1813 msgstr ""
1814
1815 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1816 #: calibre.devices.interface.DevicePlugin.books:3
1817 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1818 #: of calibre.devices.usbms.driver.USBMS.books:3
1819 msgid ""
1820 "If 'carda' or 'cardb' return a list of e-books on the specific storage card,"
1821 " otherwise return list of e-books in main memory of device. If a card is "
1822 "specified and no books are on the card return empty list."
1823 msgstr ""
1824
1825 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1826 #: calibre.devices.interface.DevicePlugin.books:8
1827 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1828 #: of calibre.devices.usbms.driver.USBMS.books:8
1829 msgid "A BookList."
1830 msgstr ""
1831
1832 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1833 #: calibre.devices.interface.DevicePlugin.upload_books:1
1834 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1835 #: of calibre.devices.usbms.driver.USBMS.upload_books:1
1836 msgid ""
1837 "Upload a list of books to the device. If a file already exists on the "
1838 "device, it should be replaced. This method should raise a "
1839 ":class:`FreeSpaceError` if there is not enough free space on the device. The"
1840 " text of the FreeSpaceError must contain the word \"card\" if ``on_card`` is"
1841 " not None otherwise it must contain the word \"memory\"."
1842 msgstr ""
1843
1844 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1845 #: calibre.devices.interface.DevicePlugin.upload_books:7
1846 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1847 #: of calibre.devices.usbms.driver.USBMS.upload_books:7
1848 msgid "A list of paths"
1849 msgstr ""
1850
1851 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1852 #: calibre.devices.interface.DevicePlugin.upload_books:8
1853 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1854 #: of calibre.devices.usbms.driver.USBMS.upload_books:8
1855 msgid ""
1856 "A list of file names that the books should have once uploaded to the device."
1857 " len(names) == len(files)"
1858 msgstr ""
1859
1860 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1861 #: calibre.devices.interface.DevicePlugin.upload_books:10
1862 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1863 #: of calibre.devices.usbms.driver.USBMS.upload_books:10
1864 msgid ""
1865 "If not None, it is a list of :class:`Metadata` objects. The idea is to use "
1866 "the metadata to determine where on the device to put the book. len(metadata)"
1867 " == len(files). Apart from the regular cover (path to cover), there may also"
1868 " be a thumbnail attribute, which should be used in preference. The thumbnail"
1869 " attribute is of the form (width, height, cover_data as jpeg)."
1870 msgstr ""
1871
1872 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1873 #: calibre.devices.interface.DevicePlugin.upload_books:17
1874 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1875 #: of calibre.devices.usbms.driver.USBMS.upload_books:17
1876 msgid ""
1877 "A list of 3-element tuples. The list is meant to be passed to "
1878 ":meth:`add_books_to_metadata`."
1879 msgstr ""
1880
1881 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1882 #: calibre.devices.interface.DevicePlugin.add_books_to_metadata:1
1883 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1884 #: of calibre.devices.usbms.driver.USBMS.add_books_to_metadata:1
1885 msgid ""
1886 "Add locations to the booklists. This function must not communicate with the "
1887 "device."
1888 msgstr ""
1889
1890 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1891 #: calibre.devices.interface.DevicePlugin.add_books_to_metadata:4
1892 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1893 #: of calibre.devices.usbms.driver.USBMS.add_books_to_metadata:4
1894 msgid "Result of a call to L{upload_books}"
1895 msgstr ""
1896
1897 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1898 #: calibre.devices.interface.DevicePlugin.add_books_to_metadata:5
1899 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1900 #: of calibre.devices.usbms.driver.USBMS.add_books_to_metadata:5
1901 msgid "List of :class:`Metadata` objects, same as for :meth:`upload_books`."
1902 msgstr ""
1903
1904 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1905 #: calibre.devices.interface.DevicePlugin.add_books_to_metadata:7
1906 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1907 #: calibre.devices.interface.DevicePlugin.remove_books_from_metadata:5
1908 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1909 #: calibre.devices.interface.DevicePlugin.sync_booklists:3
1910 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1911 #: of calibre.devices.usbms.driver.USBMS.add_books_to_metadata:7
1912 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1913 #: of calibre.devices.usbms.driver.USBMS.remove_books_from_metadata:5
1914 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1915 #: of calibre.devices.usbms.driver.USBMS.sync_booklists:3
1916 msgid ""
1917 "A tuple containing the result of calls to (:meth:`books(oncard=None)`, "
1918 ":meth:`books(oncard='carda')`, :meth`books(oncard='cardb')`)."
1919 msgstr ""
1920
1921 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1922 #: calibre.devices.interface.DevicePlugin.delete_books:1
1923 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1924 #: of calibre.devices.usbms.driver.USBMS.delete_books:1
1925 msgid "Delete books at paths on device."
1926 msgstr ""
1927
1928 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1929 #: calibre.devices.interface.DevicePlugin.remove_books_from_metadata:1
1930 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1931 #: of calibre.devices.usbms.driver.USBMS.remove_books_from_metadata:1
1932 msgid ""
1933 "Remove books from the metadata list. This function must not communicate with"
1934 " the device."
1935 msgstr ""
1936
1937 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1938 #: calibre.devices.interface.DevicePlugin.remove_books_from_metadata:4
1939 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1940 #: of calibre.devices.usbms.driver.USBMS.remove_books_from_metadata:4
1941 msgid "paths to books on the device."
1942 msgstr ""
1943
1944 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1945 #: calibre.devices.interface.DevicePlugin.sync_booklists:1
1946 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
1947 #: of calibre.devices.usbms.driver.USBMS.sync_booklists:1
1948 msgid "Update metadata on device."
1949 msgstr ""
1950
1951 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1952 #: calibre.devices.interface.DevicePlugin.get_file:1
1953 msgid "Read the file at ``path`` on the device and write it to outfile."
1954 msgstr ""
1955
1956 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1957 #: calibre.devices.interface.DevicePlugin.get_file:3
1958 msgid "file object like ``sys.stdout`` or the result of an :func:`open` call."
1959 msgstr ""
1960
1961 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1962 #: calibre.devices.interface.DevicePlugin.config_widget:1
1963 msgid ""
1964 "Should return a QWidget. The QWidget contains the settings for the device "
1965 "interface"
1966 msgstr ""
1967
1968 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1969 #: calibre.devices.interface.DevicePlugin.save_settings:1
1970 msgid ""
1971 "Should save settings to disk. Takes the widget created in "
1972 ":meth:`config_widget` and saves all settings to disk."
1973 msgstr ""
1974
1975 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1976 #: calibre.devices.interface.DevicePlugin.settings:1
1977 msgid ""
1978 "Should return an opts object. The opts object should have at least one "
1979 "attribute `format_map` which is an ordered list of formats for the device."
1980 msgstr ""
1981
1982 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1983 #: calibre.devices.interface.DevicePlugin.set_plugboards:1
1984 msgid ""
1985 "provide the driver the current set of plugboards and a function to select a "
1986 "specific plugboard. This method is called immediately before add_books and "
1987 "sync_booklists."
1988 msgstr ""
1989
1990 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1991 #: calibre.devices.interface.DevicePlugin.set_plugboards:5
1992 msgid "pb_func is a callable with the following signature::"
1993 msgstr ""
1994
1995 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
1996 #: calibre.devices.interface.DevicePlugin.set_plugboards:6
1997 msgid "def pb_func(device_name, format, plugboards)"
1998 msgstr ""
1999
2000 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2001 #: calibre.devices.interface.DevicePlugin.set_plugboards:8
2002 msgid ""
2003 "You give it the current device name (either the class name or "
2004 "DEVICE_PLUGBOARD_NAME), the format you are interested in (a 'real' format or"
2005 " 'device_db'), and the plugboards (you were given those by set_plugboards, "
2006 "the same place you got this method)."
2007 msgstr ""
2008
2009 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2010 #: calibre.devices.interface.DevicePlugin.set_plugboards:13
2011 msgid "None or a single plugboard instance."
2012 msgstr ""
2013
2014 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2015 #: calibre.devices.interface.DevicePlugin.set_driveinfo_name:1
2016 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
2017 #: of calibre.devices.usbms.driver.USBMS.set_driveinfo_name:1
2018 msgid ""
2019 "Set the device name in the driveinfo file to 'name'. This setting will "
2020 "persist until the file is re-created or the name is changed again."
2021 msgstr ""
2022
2023 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2024 #: calibre.devices.interface.DevicePlugin.set_driveinfo_name:4
2025 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
2026 #: of calibre.devices.usbms.driver.USBMS.set_driveinfo_name:4
2027 msgid ""
2028 "Non-disk devices should implement this method based on the location codes "
2029 "returned by the get_device_information() method."
2030 msgstr ""
2031
2032 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2033 #: calibre.devices.interface.DevicePlugin.prepare_addable_books:1
2034 msgid ""
2035 "Given a list of paths, returns another list of paths. These paths point to "
2036 "addable versions of the books."
2037 msgstr ""
2038
2039 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2040 #: calibre.devices.interface.DevicePlugin.prepare_addable_books:4
2041 msgid ""
2042 "If there is an error preparing a book, then instead of a path, the position "
2043 "in the returned list for that book should be a three tuple: (original_path, "
2044 "the exception instance, traceback)"
2045 msgstr ""
2046
2047 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2048 #: calibre.devices.interface.DevicePlugin.startup:1
2049 msgid ""
2050 "Called when calibre is starting the device. Do any initialization required. "
2051 "Note that multiple instances of the class can be instantiated, and thus "
2052 "__init__ can be called multiple times, but only one instance will have this "
2053 "method called. This method is called on the device thread, not the GUI "
2054 "thread."
2055 msgstr ""
2056
2057 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2058 #: calibre.devices.interface.DevicePlugin.shutdown:1
2059 msgid ""
2060 "Called when calibre is shutting down, either for good or in preparation to "
2061 "restart. Do any cleanup required. This method is called on the device "
2062 "thread, not the GUI thread."
2063 msgstr ""
2064
2065 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2066 #: calibre.devices.interface.DevicePlugin.get_device_uid:1
2067 msgid ""
2068 "Must return a unique id for the currently connected device (this is called "
2069 "immediately after a successful call to open()). You must implement this "
2070 "method if you set ASK_TO_ALLOW_CONNECT = True"
2071 msgstr ""
2072
2073 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2074 #: calibre.devices.interface.DevicePlugin.ignore_connected_device:1
2075 msgid ""
2076 "Should ignore the device identified by uid (the result of a call to "
2077 "get_device_uid()) in the future. You must implement this method if you set "
2078 "ASK_TO_ALLOW_CONNECT = True. Note that this function is called immediately "
2079 "after open(), so if open() caches some state, the driver should reset that "
2080 "state."
2081 msgstr ""
2082
2083 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2084 #: calibre.devices.interface.DevicePlugin.get_user_blacklisted_devices:1
2085 msgid ""
2086 "Return map of device uid to friendly name for all devices that the user has "
2087 "asked to be ignored."
2088 msgstr ""
2089
2090 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2091 #: calibre.devices.interface.DevicePlugin.set_user_blacklisted_devices:1
2092 msgid "Set the list of device uids that should be ignored by this driver."
2093 msgstr ""
2094
2095 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2096 #: calibre.devices.interface.DevicePlugin.specialize_global_preferences:1
2097 msgid ""
2098 "Implement this method if your device wants to override a particular "
2099 "preference. You must ensure that all call sites that want a preference that "
2100 "can be overridden use device_prefs['something'] instead of "
2101 "prefs['something']. Your method should call "
2102 "device_prefs.set_overrides(pref=val, pref=val, ...). Currently used for: "
2103 "metadata management (prefs['manage_device_metadata'])"
2104 msgstr ""
2105
2106 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2107 #: calibre.devices.interface.DevicePlugin.set_library_info:1
2108 msgid ""
2109 "Implement this method if you want information about the current calibre "
2110 "library. This method is called at startup and when the calibre library "
2111 "changes while connected."
2112 msgstr ""
2113
2114 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2115 #: calibre.devices.interface.DevicePlugin.is_dynamically_controllable:1
2116 msgid ""
2117 "Called by the device manager when starting plugins. If this method returns a"
2118 " string, then a) it supports the device manager's dynamic control interface,"
2119 " and b) that name is to be used when talking to the plugin."
2120 msgstr ""
2121
2122 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2123 #: calibre.devices.interface.DevicePlugin.get_option:5
2124 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2125 #: calibre.devices.interface.DevicePlugin.is_dynamically_controllable:5
2126 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2127 #: calibre.devices.interface.DevicePlugin.is_running:3
2128 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2129 #: calibre.devices.interface.DevicePlugin.set_option:4
2130 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2131 #: calibre.devices.interface.DevicePlugin.start_plugin:5
2132 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2133 #: calibre.devices.interface.DevicePlugin.stop_plugin:6
2134 msgid ""
2135 "This method can be called on the GUI thread. A driver that implements this "
2136 "method must be thread safe."
2137 msgstr ""
2138
2139 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2140 #: calibre.devices.interface.DevicePlugin.start_plugin:1
2141 msgid ""
2142 "This method is called to start the plugin. The plugin should begin to accept"
2143 " device connections however it does that. If the plugin is already accepting"
2144 " connections, then do nothing."
2145 msgstr ""
2146
2147 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2148 #: calibre.devices.interface.DevicePlugin.stop_plugin:1
2149 msgid ""
2150 "This method is called to stop the plugin. The plugin should no longer accept"
2151 " connections, and should cleanup behind itself. It is likely that this "
2152 "method should call shutdown. If the plugin is already not accepting "
2153 "connections, then do nothing."
2154 msgstr ""
2155
2156 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2157 #: calibre.devices.interface.DevicePlugin.get_option:1
2158 msgid ""
2159 "Return the value of the option indicated by opt_string. This method can be "
2160 "called when the plugin is not started. Return None if the option does not "
2161 "exist."
2162 msgstr ""
2163
2164 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2165 #: calibre.devices.interface.DevicePlugin.set_option:1
2166 msgid ""
2167 "Set the value of the option indicated by opt_string. This method can be "
2168 "called when the plugin is not started."
2169 msgstr ""
2170
2171 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2172 #: calibre.devices.interface.DevicePlugin.is_running:1
2173 msgid "Return True if the plugin is started, otherwise false"
2174 msgstr ""
2175
2176 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2177 #: calibre.devices.interface.DevicePlugin.synchronize_with_db:1
2178 msgid ""
2179 "Called during book matching when a book on the device is matched with a book"
2180 " in calibre's db. The method is responsible for synchronizing data from the "
2181 "device to calibre's db (if needed)."
2182 msgstr ""
2183
2184 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2185 #: calibre.devices.interface.DevicePlugin.synchronize_with_db:5
2186 msgid ""
2187 "The method must return a two-value tuple. The first value is a set of "
2188 "calibre book ids changed if calibre's database was changed or None if the "
2189 "database was not changed. If the first value is an empty set then the "
2190 "metadata for the book on the device is updated with calibre's metadata and "
2191 "given back to the device, but no GUI refresh of that book is done. This is "
2192 "useful when the calibre data is correct but must be sent to the device."
2193 msgstr ""
2194
2195 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2196 #: calibre.devices.interface.DevicePlugin.synchronize_with_db:13
2197 msgid ""
2198 "The second value is itself a 2-value tuple. The first value in the tuple "
2199 "specifies whether a book format should be sent to the device. The intent is "
2200 "to permit verifying that the book on the device is the same as the book in "
2201 "calibre. This value must be None if no book is to be sent, otherwise return "
2202 "the base file name on the device (a string like foobar.epub). Be sure to "
2203 "include the extension in the name. The device subsystem will construct a "
2204 "send_books job for all books with not- None returned values. Note: other "
2205 "than to later retrieve the extension, the name is ignored in cases where the"
2206 " device uses a template to generate the file name, which most do. The second"
2207 " value in the returned tuple indicated whether the format is future-dated. "
2208 "Return True if it is, otherwise return False. calibre will display a dialog "
2209 "to the user listing all future dated books."
2210 msgstr ""
2211
2212 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2213 #: calibre.devices.interface.DevicePlugin.synchronize_with_db:27
2214 msgid ""
2215 "Extremely important: this method is called on the GUI thread. It must be "
2216 "threadsafe with respect to the device manager's thread."
2217 msgstr ""
2218
2219 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2220 #: calibre.devices.interface.DevicePlugin.synchronize_with_db:30
2221 msgid ""
2222 "book_id: the calibre id for the book in the database. book_metadata: the "
2223 "Metadata object for the book coming from the device. first_call: True if "
2224 "this is the first call during a sync, False otherwise"
2225 msgstr ""
2226
2227 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2228 #: calibre.devices.interface.BookList:1
2229 msgid "A list of books. Each Book object must have the fields"
2230 msgstr ""
2231
2232 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2233 #: calibre.devices.interface.BookList:3
2234 msgid "title"
2235 msgstr "titolo"
2236
2237 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2238 #: calibre.devices.interface.BookList:4
2239 msgid "authors"
2240 msgstr ""
2241
2242 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2243 #: calibre.devices.interface.BookList:5
2244 msgid "size (file size of the book)"
2245 msgstr "dimensioni (dimensioni del file del libro)"
2246
2247 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2248 #: calibre.devices.interface.BookList:6
2249 msgid "datetime (a UTC time tuple)"
2250 msgstr ""
2251
2252 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2253 #: calibre.devices.interface.BookList:7
2254 msgid "path (path on the device to the book)"
2255 msgstr ""
2256
2257 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2258 #: calibre.devices.interface.BookList:8
2259 msgid ""
2260 "thumbnail (can be None) thumbnail is either a str/bytes object with the "
2261 "image data or it should have an attribute image_path that stores an absolute"
2262 " (platform native) path to the image"
2263 msgstr ""
2264
2265 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2266 #: calibre.devices.interface.BookList:11
2267 msgid "tags (a list of strings, can be empty)."
2268 msgstr "tag (una lista di stringhe, si può lasciare vuoto)"
2269
2270 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2271 #: calibre.devices.interface.BookList.supports_collections:1
2272 msgid "Return True if the device supports collections for this book list."
2273 msgstr "Restituisce True se il dispositivo supporta le collezioni per questa lista di libri."
2274
2275 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2276 #: calibre.devices.interface.BookList.add_book:1
2277 msgid ""
2278 "Add the book to the booklist. Intent is to maintain any device-internal "
2279 "metadata. Return True if booklists must be sync'ed"
2280 msgstr ""
2281
2282 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2283 #: calibre.devices.interface.BookList.remove_book:1
2284 msgid ""
2285 "Remove a book from the booklist. Correct any device metadata at the same "
2286 "time"
2287 msgstr ""
2288
2289 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2290 #: calibre.devices.interface.BookList.get_collections:1
2291 msgid ""
2292 "Return a dictionary of collections created from collection_attributes. Each "
2293 "entry in the dictionary is of the form collection name:[list of books]"
2294 msgstr ""
2295
2296 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2297 #: calibre.devices.interface.BookList.get_collections:5
2298 msgid ""
2299 "The list of books is sorted by book title, except for collections created "
2300 "from series, in which case series_index is used."
2301 msgstr ""
2302
2303 #: ../../../__w/calibre/calibre/src/calibre/devices/interface.pydocstring of
2304 #: calibre.devices.interface.BookList.get_collections:8
2305 msgid "A list of attributes of the Book object"
2306 msgstr "Una lista di attributi dell'oggetto Libro"
2307
2308 #: ../../../__w/calibre/calibre/manual/plugins.rst:110
2309 msgid "USB Mass Storage based devices"
2310 msgstr "Dispositivi basati su Memoria di Massa USB"
2311
2312 #: ../../../__w/calibre/calibre/manual/plugins.rst:112
2313 msgid ""
2314 "The base class for such devices is "
2315 ":class:`calibre.devices.usbms.driver.USBMS`. This class in turn inherits "
2316 "some of its functionality from its bases, documented below. A typical basic "
2317 "USBMS based driver looks like this:"
2318 msgstr ""
2319
2320 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
2321 #: of calibre.devices.usbms.device.Device:1
2322 msgid ""
2323 "This class provides logic common to all drivers for devices that export "
2324 "themselves as USB Mass Storage devices. Provides implementations for "
2325 "mounting/ejecting of USBMS devices on all platforms."
2326 msgstr ""
2327
2328 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
2329 #: of calibre.devices.usbms.device.Device.WINDOWS_MAIN_MEM:1
2330 msgid ""
2331 "String identifying the main memory of the device in the Windows PnP id "
2332 "strings This can be None, string, list of strings or compiled regex"
2333 msgstr ""
2334
2335 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
2336 #: of calibre.devices.usbms.device.Device.WINDOWS_CARD_A_MEM:1
2337 msgid ""
2338 "String identifying the first card of the device in the Windows PnP id "
2339 "strings This can be None, string, list of strings or compiled regex"
2340 msgstr ""
2341
2342 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
2343 #: of calibre.devices.usbms.device.Device.WINDOWS_CARD_B_MEM:1
2344 msgid ""
2345 "String identifying the second card of the device in the Windows PnP id "
2346 "strings This can be None, string, list of strings or compiled regex"
2347 msgstr ""
2348
2349 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
2350 #: of calibre.devices.usbms.device.Device.OSX_MAIN_MEM_VOL_PAT:1
2351 msgid ""
2352 "Used by the new driver detection to disambiguate main memory from storage "
2353 "cards. Should be a regular expression that matches the main memory mount "
2354 "point assigned by macOS"
2355 msgstr ""
2356
2357 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
2358 #: of calibre.devices.usbms.device.Device.MAX_PATH_LEN:1
2359 msgid "The maximum length of paths created on the device"
2360 msgstr ""
2361
2362 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
2363 #: of calibre.devices.usbms.device.Device.NEWS_IN_FOLDER:1
2364 msgid "Put news in its own folder"
2365 msgstr "Inserisci le news nella loro cartella"
2366
2367 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
2368 #: of calibre.devices.usbms.device.Device.windows_sort_drives:1
2369 msgid ""
2370 "Called to disambiguate main memory and storage card for devices that do not "
2371 "distinguish between them on the basis of `WINDOWS_CARD_NAME`. For example: "
2372 "The EB600"
2373 msgstr "Chiamata per eliminare l'ambiguità tra la memoria principale e la scheda di memoria in dispositivi che non le distinguono sulla base di `WINDOWS_CARD_NAME`. Per esempio: L'EB600"
2374
2375 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
2376 #: of calibre.devices.usbms.device.Device.sanitize_callback:1
2377 msgid ""
2378 "Callback to allow individual device drivers to override the path "
2379 "sanitization used by :meth:`create_upload_path`."
2380 msgstr ""
2381
2382 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
2383 #: of calibre.devices.usbms.device.Device.filename_callback:1
2384 msgid ""
2385 "Callback to allow drivers to change the default file name set by "
2386 ":meth:`create_upload_path`."
2387 msgstr ""
2388
2389 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
2390 #: of calibre.devices.usbms.device.Device.sanitize_path_components:1
2391 msgid ""
2392 "Perform any device specific sanitization on the path components for files to"
2393 " be uploaded to the device"
2394 msgstr ""
2395
2396 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
2397 #: of calibre.devices.usbms.device.Device.get_annotations:1
2398 msgid "Resolve path_map to annotation_map of files found on the device"
2399 msgstr ""
2400
2401 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/device.pydocstring
2402 #: of calibre.devices.usbms.device.Device.add_annotation_to_library:1
2403 msgid "Add an annotation to the calibre library"
2404 msgstr "Aggiungi annotazione alla libreria di calibre"
2405
2406 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
2407 #: of calibre.devices.usbms.driver.USBMS:1
2408 msgid ""
2409 "The base class for all USBMS devices. Implements the logic for "
2410 "sending/getting/updating metadata/caching metadata/etc."
2411 msgstr "La classe base per tutti i dispositivi USBMS. Implementa la logica per inviare/ricevere/aggiornare metadati/raccogliere metadati/etc."
2412
2413 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
2414 #: of calibre.devices.usbms.driver.USBMS.upload_cover:1
2415 msgid "Upload book cover to the device. Default implementation does nothing."
2416 msgstr ""
2417
2418 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
2419 #: of calibre.devices.usbms.driver.USBMS.upload_cover:3
2420 msgid "The full path to the folder where the associated book is located."
2421 msgstr ""
2422
2423 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
2424 #: of calibre.devices.usbms.driver.USBMS.upload_cover:4
2425 msgid "The name of the book file without the extension."
2426 msgstr ""
2427
2428 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
2429 #: of calibre.devices.usbms.driver.USBMS.upload_cover:5
2430 msgid "metadata belonging to the book. Use metadata.thumbnail for cover"
2431 msgstr ""
2432
2433 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
2434 #: of calibre.devices.usbms.driver.USBMS.upload_cover:7
2435 msgid "The full path to the e-book file"
2436 msgstr ""
2437
2438 #: ../../../__w/calibre/calibre/src/calibre/devices/usbms/driver.pydocstring
2439 #: of calibre.devices.usbms.driver.USBMS.normalize_path:1
2440 msgid "Return path with platform native path separators"
2441 msgstr ""
2442
2443 #: ../../../__w/calibre/calibre/manual/plugins.rst:157
2444 msgid "User interface actions"
2445 msgstr ""
2446
2447 #: ../../../__w/calibre/calibre/manual/plugins.rst:159
2448 msgid ""
2449 "If you are adding your own plugin in a ZIP file, you should subclass both "
2450 "InterfaceActionBase and InterfaceAction. The :meth:`load_actual_plugin` "
2451 "method of your InterfaceActionBase subclass must return an instantiated "
2452 "object of your InterfaceAction subclass."
2453 msgstr ""
2454
2455 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2456 #: of calibre.gui2.actions.InterfaceAction:1
2457 msgid ""
2458 "A plugin representing an \"action\" that can be taken in the graphical user "
2459 "interface. All the items in the toolbar and context menus are implemented by"
2460 " these plugins."
2461 msgstr ""
2462
2463 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2464 #: of calibre.gui2.actions.InterfaceAction:5
2465 msgid ""
2466 "Note that this class is the base class for these plugins, however, to "
2467 "integrate the plugin with calibre's plugin system, you have to make a "
2468 "wrapper class that references the actual plugin. See the "
2469 ":mod:`calibre.customize.builtins` module for examples."
2470 msgstr ""
2471
2472 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2473 #: of calibre.gui2.actions.InterfaceAction:10
2474 msgid ""
2475 "If two :class:`InterfaceAction` objects have the same name, the one with "
2476 "higher priority takes precedence."
2477 msgstr ""
2478
2479 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2480 #: of calibre.gui2.actions.InterfaceAction:13
2481 msgid ""
2482 "Sub-classes should implement the :meth:`genesis`, :meth:`library_changed`, "
2483 ":meth:`location_selected`, :meth:`shutting_down`, "
2484 ":meth:`initialization_complete` and :meth:`tag_browser_context_action` "
2485 "methods."
2486 msgstr ""
2487
2488 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2489 #: of calibre.gui2.actions.InterfaceAction:17
2490 msgid ""
2491 "Once initialized, this plugin has access to the main calibre GUI via the "
2492 ":attr:`gui` member. You can access other plugins by name, for example::"
2493 msgstr ""
2494
2495 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2496 #: of calibre.gui2.actions.InterfaceAction:22
2497 msgid ""
2498 "To access the actual plugin, use the :attr:`interface_action_base_plugin` "
2499 "attribute, this attribute only becomes available after the plugin has been "
2500 "initialized. Useful if you want to use methods from the plugin class like "
2501 "do_user_config()."
2502 msgstr ""
2503
2504 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2505 #: of calibre.gui2.actions.InterfaceAction:27
2506 msgid ""
2507 "The QAction specified by :attr:`action_spec` is automatically create and "
2508 "made available as ``self.qaction``."
2509 msgstr ""
2510
2511 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2512 #: of calibre.gui2.actions.InterfaceAction.name:1
2513 msgid ""
2514 "The plugin name. If two plugins with the same name are present, the one with"
2515 " higher priority takes precedence."
2516 msgstr ""
2517
2518 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2519 #: of calibre.gui2.actions.InterfaceAction.priority:1
2520 msgid ""
2521 "The plugin priority. If two plugins with the same name are present, the one "
2522 "with higher priority takes precedence."
2523 msgstr ""
2524
2525 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2526 #: of calibre.gui2.actions.InterfaceAction.popup_type:1
2527 msgid "The menu popup type for when this plugin is added to a toolbar"
2528 msgstr ""
2529
2530 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2531 #: of calibre.gui2.actions.InterfaceAction.auto_repeat:1
2532 msgid ""
2533 "Whether this action should be auto repeated when its shortcut key is held "
2534 "down."
2535 msgstr ""
2536
2537 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2538 #: of calibre.gui2.actions.InterfaceAction.action_spec:1
2539 msgid ""
2540 "Of the form: (text, icon_path, tooltip, keyboard shortcut). icon, tooltip "
2541 "and keyboard shortcut can be None. keyboard shortcut must be either a "
2542 "string, None or tuple of shortcuts. If None, a keyboard shortcut "
2543 "corresponding to the action is not registered. If you pass an empty tuple, "
2544 "then the shortcut is registered with no default key binding."
2545 msgstr ""
2546
2547 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2548 #: of calibre.gui2.actions.InterfaceAction.action_shortcut_name:1
2549 msgid ""
2550 "If not None, used for the name displayed to the user when customizing the "
2551 "keyboard shortcuts for the above action spec instead of action_spec[0]"
2552 msgstr ""
2553
2554 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2555 #: of calibre.gui2.actions.InterfaceAction.action_add_menu:1
2556 msgid "If True, a menu is automatically created and added to self.qaction"
2557 msgstr ""
2558
2559 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2560 #: of calibre.gui2.actions.InterfaceAction.action_menu_clone_qaction:1
2561 msgid ""
2562 "If True, a clone of self.qaction is added to the menu of self.qaction If you"
2563 " want the text of this action to be different from that of self.qaction, set"
2564 " this variable to the new text"
2565 msgstr ""
2566
2567 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2568 #: of calibre.gui2.actions.InterfaceAction.dont_add_to:1
2569 msgid ""
2570 "Set of locations to which this action must not be added. See "
2571 ":attr:`all_locations` for a list of possible locations"
2572 msgstr ""
2573
2574 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2575 #: of calibre.gui2.actions.InterfaceAction.dont_remove_from:1
2576 msgid ""
2577 "Set of locations from which this action must not be removed. See "
2578 ":attr:`all_locations` for a list of possible locations"
2579 msgstr ""
2580
2581 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2582 #: of calibre.gui2.actions.InterfaceAction.action_type:1
2583 msgid ""
2584 "Type of action 'current' means acts on the current view 'global' means an "
2585 "action that does not act on the current view, but rather on calibre as a "
2586 "whole"
2587 msgstr ""
2588
2589 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2590 #: of calibre.gui2.actions.InterfaceAction.accepts_drops:1
2591 msgid ""
2592 "If True, then this InterfaceAction will have the opportunity to interact "
2593 "with drag and drop events. See the methods, :meth:`accept_enter_event`, "
2594 ":meth`:accept_drag_move_event`, :meth:`drop_event` for details."
2595 msgstr ""
2596
2597 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2598 #: of calibre.gui2.actions.InterfaceAction.accept_drag_move_event:1
2599 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2600 #: of calibre.gui2.actions.InterfaceAction.accept_enter_event:1
2601 msgid ""
2602 "This method should return True iff this interface action is capable of "
2603 "handling the drag event. Do not call accept/ignore on the event, that will "
2604 "be taken care of by the calibre UI."
2605 msgstr ""
2606
2607 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2608 #: of calibre.gui2.actions.InterfaceAction.drop_event:1
2609 msgid ""
2610 "This method should perform some useful action and return True iff this "
2611 "interface action is capable of handling the drop event. Do not call "
2612 "accept/ignore on the event, that will be taken care of by the calibre UI. "
2613 "You should not perform blocking/long operations in this function. Instead "
2614 "emit a signal or use QTimer.singleShot and return quickly. See the builtin "
2615 "actions for examples."
2616 msgstr ""
2617
2618 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2619 #: of calibre.gui2.actions.InterfaceAction.create_menu_action:1
2620 msgid ""
2621 "Convenience method to easily add actions to a QMenu. Returns the created "
2622 "QAction. This action has one extra attribute calibre_shortcut_unique_name "
2623 "which if not None refers to the unique name under which this action is "
2624 "registered with the keyboard manager."
2625 msgstr ""
2626
2627 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2628 #: of calibre.gui2.actions.InterfaceAction.create_menu_action:6
2629 msgid "The QMenu the newly created action will be added to"
2630 msgstr ""
2631
2632 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2633 #: of calibre.gui2.actions.InterfaceAction.create_menu_action:7
2634 msgid ""
2635 "A unique name for this action, this must be globally unique, so make it as "
2636 "descriptive as possible. If in doubt, add an UUID to it."
2637 msgstr ""
2638
2639 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2640 #: of calibre.gui2.actions.InterfaceAction.create_menu_action:10
2641 msgid "The text of the action."
2642 msgstr ""
2643
2644 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2645 #: of calibre.gui2.actions.InterfaceAction.create_menu_action:11
2646 msgid ""
2647 "Either a QIcon or a file name. The file name is passed to the QIcon.ic() "
2648 "builtin, so you do not need to pass the full path to the images folder."
2649 msgstr ""
2650
2651 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2652 #: of calibre.gui2.actions.InterfaceAction.create_menu_action:14
2653 msgid ""
2654 "A string, a list of strings, None or False. If False, no keyboard shortcut "
2655 "is registered for this action. If None, a keyboard shortcut with no default "
2656 "keybinding is registered. String and list of strings register a shortcut "
2657 "with default keybinding as specified."
2658 msgstr ""
2659
2660 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2661 #: of calibre.gui2.actions.InterfaceAction.create_menu_action:18
2662 msgid "A description for this action. Used to set tooltips."
2663 msgstr ""
2664
2665 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2666 #: of calibre.gui2.actions.InterfaceAction.create_menu_action:20
2667 msgid ""
2668 "A callable which is connected to the triggered signal of the created action."
2669 msgstr ""
2670
2671 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2672 #: of calibre.gui2.actions.InterfaceAction.create_menu_action:22
2673 msgid ""
2674 "The text displayed to the user when customizing the keyboard shortcuts for "
2675 "this action. By default it is set to the value of ``text``."
2676 msgstr ""
2677
2678 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2679 #: of calibre.gui2.actions.InterfaceAction.create_menu_action:25
2680 msgid ""
2681 "Shortcuts for actions that don't always appear, or are library dependent, "
2682 "may disappear when other keyboard shortcuts are edited unless "
2683 "```persist_shortcut``` is set True."
2684 msgstr ""
2685
2686 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2687 #: of calibre.gui2.actions.InterfaceAction.load_resources:12
2688 msgid ""
2689 "A dictionary of the form ``{name : file_contents}``. Any names that were not"
2690 " found in the ZIP file will not be present in the dictionary."
2691 msgstr ""
2692
2693 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2694 #: of calibre.gui2.actions.InterfaceAction.genesis:1
2695 msgid ""
2696 "Setup this plugin. Only called once during initialization. self.gui is "
2697 "available. The action specified by :attr:`action_spec` is available as "
2698 "``self.qaction``."
2699 msgstr ""
2700
2701 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2702 #: of calibre.gui2.actions.InterfaceAction.location_selected:1
2703 msgid ""
2704 "Called whenever the book list being displayed in calibre changes. Currently "
2705 "values for loc are: ``library, main, card and cardb``."
2706 msgstr ""
2707
2708 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2709 #: of calibre.gui2.actions.InterfaceAction.location_selected:4
2710 msgid ""
2711 "This method should enable/disable this action and its sub actions as "
2712 "appropriate for the location."
2713 msgstr ""
2714
2715 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2716 #: of calibre.gui2.actions.InterfaceAction.library_about_to_change:1
2717 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2718 #: of calibre.gui2.actions.InterfaceAction.library_changed:1
2719 msgid "Called whenever the current library is changed."
2720 msgstr ""
2721
2722 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2723 #: of calibre.gui2.actions.InterfaceAction.library_about_to_change:3
2724 msgid "The LibraryDatabase corresponding to the previous library."
2725 msgstr ""
2726
2727 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2728 #: of calibre.gui2.actions.InterfaceAction.library_about_to_change:4
2729 msgid "The LibraryDatabase corresponding to the new library."
2730 msgstr ""
2731
2732 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2733 #: of calibre.gui2.actions.InterfaceAction.library_changed:3
2734 msgid "The LibraryDatabase corresponding to the current library."
2735 msgstr ""
2736
2737 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2738 #: of calibre.gui2.actions.InterfaceAction.gui_layout_complete:1
2739 msgid ""
2740 "Called once per action when the layout of the main GUI is completed. If your"
2741 " action needs to make changes to the layout, they should be done here, "
2742 "rather than in :meth:`initialization_complete`."
2743 msgstr ""
2744
2745 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2746 #: of calibre.gui2.actions.InterfaceAction.initialization_complete:1
2747 msgid ""
2748 "Called once per action when the initialization of the main GUI is completed."
2749 msgstr ""
2750
2751 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2752 #: of calibre.gui2.actions.InterfaceAction.tag_browser_context_action:1
2753 msgid ""
2754 "Called when displaying the context menu in the Tag browser. ``index`` is the"
2755 " QModelIndex that points to the Tag browser item that was right clicked. "
2756 "Test it for validity with index.valid() and get the underlying TagTreeItem "
2757 "object with index.data(Qt.ItemDataRole.UserRole). Any action objects yielded"
2758 " by this method will be added to the context menu."
2759 msgstr ""
2760
2761 #: ../../../__w/calibre/calibre/src/calibre/gui2/actions/__init__.pydocstring
2762 #: of calibre.gui2.actions.InterfaceAction.shutting_down:1
2763 msgid ""
2764 "Called once per plugin when the main GUI is in the process of shutting down."
2765 " Release any used resources, but try not to block the shutdown for long "
2766 "periods of time."
2767 msgstr ""
2768
2769 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
2770 #: calibre.customize.InterfaceActionBase.load_actual_plugin:1
2771 msgid "This method must return the actual interface action plugin object."
2772 msgstr ""
2773
2774 #: ../../../__w/calibre/calibre/manual/plugins.rst:175
2775 msgid "Preferences plugins"
2776 msgstr ""
2777
2778 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
2779 #: calibre.customize.PreferencesPlugin:1
2780 msgid "A plugin representing a widget displayed in the Preferences dialog."
2781 msgstr ""
2782
2783 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
2784 #: calibre.customize.PreferencesPlugin:3
2785 msgid ""
2786 "This plugin has only one important method :meth:`create_widget`. The various"
2787 " fields of the plugin control how it is categorized in the UI."
2788 msgstr ""
2789
2790 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
2791 #: calibre.customize.PreferencesPlugin.config_widget:1
2792 msgid ""
2793 "Import path to module that contains a class named ConfigWidget which "
2794 "implements the ConfigWidgetInterface. Used by :meth:`create_widget`."
2795 msgstr ""
2796
2797 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
2798 #: calibre.customize.PreferencesPlugin.category_order:1
2799 msgid ""
2800 "Where in the list of categories the :attr:`category` of this plugin should "
2801 "be."
2802 msgstr ""
2803
2804 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
2805 #: calibre.customize.PreferencesPlugin.name_order:1
2806 msgid ""
2807 "Where in the list of names in a category, the :attr:`gui_name` of this "
2808 "plugin should be"
2809 msgstr ""
2810
2811 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
2812 #: calibre.customize.PreferencesPlugin.category:1
2813 msgid "The category this plugin should be in"
2814 msgstr ""
2815
2816 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
2817 #: calibre.customize.PreferencesPlugin.gui_category:1
2818 msgid "The category name displayed to the user for this plugin"
2819 msgstr ""
2820
2821 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
2822 #: calibre.customize.PreferencesPlugin.gui_name:1
2823 msgid "The name displayed to the user for this plugin"
2824 msgstr ""
2825
2826 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
2827 #: calibre.customize.PreferencesPlugin.icon:1
2828 msgid "The icon for this plugin, should be an absolute path"
2829 msgstr ""
2830
2831 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
2832 #: calibre.customize.PreferencesPlugin.description:1
2833 msgid "The description used for tooltips and the like"
2834 msgstr ""
2835
2836 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
2837 #: calibre.customize.PreferencesPlugin.create_widget:1
2838 msgid ""
2839 "Create and return the actual Qt widget used for setting this group of "
2840 "preferences. The widget must implement the "
2841 ":class:`calibre.gui2.preferences.ConfigWidgetInterface`."
2842 msgstr ""
2843
2844 #: ../../../__w/calibre/calibre/src/calibre/customize/__init__.pydocstring of
2845 #: calibre.customize.PreferencesPlugin.create_widget:5
2846 msgid ""
2847 "The default implementation uses :attr:`config_widget` to instantiate the "
2848 "widget."
2849 msgstr ""
2850
2851 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2852 #: of calibre.gui2.preferences.ConfigWidgetInterface:1
2853 msgid ""
2854 "This class defines the interface that all widgets displayed in the "
2855 "Preferences dialog must implement. See :class:`ConfigWidgetBase` for a base "
2856 "class that implements this interface and defines various convenience methods"
2857 " as well."
2858 msgstr ""
2859
2860 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2861 #: of calibre.gui2.preferences.ConfigWidgetBase.changed_signal:1
2862 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2863 #: of calibre.gui2.preferences.ConfigWidgetInterface.changed_signal:1
2864 msgid ""
2865 "This signal must be emitted whenever the user changes a value in this widget"
2866 msgstr ""
2867
2868 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2869 #: of
2870 #: calibre.gui2.preferences.ConfigWidgetBase.supports_restoring_to_defaults:1
2871 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2872 #: of
2873 #: calibre.gui2.preferences.ConfigWidgetInterface.supports_restoring_to_defaults:1
2874 msgid "Set to True iff the :meth:`restore_to_defaults` method is implemented."
2875 msgstr ""
2876
2877 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2878 #: of calibre.gui2.preferences.ConfigWidgetInterface.restore_defaults_desc:1
2879 msgid "The tooltip for the \"Restore defaults\" button"
2880 msgstr ""
2881
2882 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2883 #: of calibre.gui2.preferences.ConfigWidgetBase.restart_critical:1
2884 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2885 #: of calibre.gui2.preferences.ConfigWidgetInterface.restart_critical:1
2886 msgid ""
2887 "If True the Preferences dialog will not allow the user to set any more "
2888 "preferences. Only has effect if :meth:`commit` returns True."
2889 msgstr ""
2890
2891 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2892 #: of calibre.gui2.preferences.ConfigWidgetInterface.genesis:1
2893 msgid ""
2894 "Called once before the widget is displayed, should perform any necessary "
2895 "setup."
2896 msgstr ""
2897
2898 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2899 #: of calibre.gui2.preferences.ConfigWidgetInterface.genesis:4
2900 msgid "The main calibre graphical user interface"
2901 msgstr ""
2902
2903 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2904 #: of calibre.gui2.preferences.ConfigWidgetBase.initialize:1
2905 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2906 #: of calibre.gui2.preferences.ConfigWidgetInterface.initialize:1
2907 msgid ""
2908 "Should set all config values to their initial values (the values stored in "
2909 "the config files). A \"return\" statement is optional. Return False if the "
2910 "dialog is not to be shown."
2911 msgstr ""
2912
2913 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2914 #: of calibre.gui2.preferences.ConfigWidgetBase.restore_defaults:1
2915 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2916 #: of calibre.gui2.preferences.ConfigWidgetInterface.restore_defaults:1
2917 msgid "Should set all config values to their defaults."
2918 msgstr ""
2919
2920 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2921 #: of calibre.gui2.preferences.ConfigWidgetBase.commit:1
2922 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2923 #: of calibre.gui2.preferences.ConfigWidgetInterface.commit:1
2924 msgid ""
2925 "Save any changed settings. Return True if the changes require a restart, "
2926 "False otherwise. Raise an :class:`AbortCommit` exception to indicate that an"
2927 " error occurred. You are responsible for giving the user feedback about what"
2928 " the error is and how to correct it."
2929 msgstr ""
2930
2931 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2932 #: of calibre.gui2.preferences.ConfigWidgetInterface.refresh_gui:1
2933 msgid ""
2934 "Called once after this widget is committed. Responsible for causing the gui "
2935 "to reread any changed settings. Note that by default the GUI re-initializes "
2936 "various elements anyway, so most widgets won't need to use this method."
2937 msgstr ""
2938
2939 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2940 #: of calibre.gui2.preferences.ConfigWidgetInterface.initial_tab_changed:1
2941 msgid ""
2942 "Called if the initially displayed tab is changed before the widget is shown,"
2943 " but after it is initialized."
2944 msgstr ""
2945
2946 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2947 #: of calibre.gui2.preferences.ConfigWidgetBase:1
2948 msgid ""
2949 "Base class that contains code to easily add standard config widgets like "
2950 "checkboxes, combo boxes, text fields and so on. See the :meth:`register` "
2951 "method."
2952 msgstr ""
2953
2954 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2955 #: of calibre.gui2.preferences.ConfigWidgetBase:5
2956 msgid ""
2957 "This class automatically handles change notification, resetting to default, "
2958 "translation between gui objects and config objects, etc. for registered "
2959 "settings."
2960 msgstr ""
2961
2962 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2963 #: of calibre.gui2.preferences.ConfigWidgetBase:9
2964 msgid ""
2965 "If your config widget inherits from this class but includes setting that are"
2966 " not registered, you should override the :class:`ConfigWidgetInterface` "
2967 "methods and call the base class methods inside the overrides."
2968 msgstr ""
2969
2970 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2971 #: of calibre.gui2.preferences.ConfigWidgetBase.register:1
2972 msgid "Register a setting."
2973 msgstr ""
2974
2975 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2976 #: of calibre.gui2.preferences.ConfigWidgetBase.register:3
2977 msgid "The setting name"
2978 msgstr ""
2979
2980 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2981 #: of calibre.gui2.preferences.ConfigWidgetBase.register:4
2982 msgid "The config object that reads/writes the setting"
2983 msgstr ""
2984
2985 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2986 #: of calibre.gui2.preferences.ConfigWidgetBase.register:5
2987 msgid ""
2988 "The name of the GUI object that presents an interface to change the setting."
2989 " By default it is assumed to be ``'opt_' + name``."
2990 msgstr ""
2991
2992 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
2993 #: of calibre.gui2.preferences.ConfigWidgetBase.register:8
2994 msgid ""
2995 "If this setting is a multiple choice (combobox) based setting, the list of "
2996 "choices. The list is a list of two element tuples of the form: ``[(gui name,"
2997 " value), ...]``"
2998 msgstr ""
2999
3000 #: ../../../__w/calibre/calibre/src/calibre/gui2/preferences/__init__.pydocstring
3001 #: of calibre.gui2.preferences.ConfigWidgetBase.register:11
3002 msgid ""
3003 "The class responsible for managing this setting. The default class handles "
3004 "almost all cases, so this param is rarely used."
3005 msgstr ""