Debian Codegraph @

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