Debian Codegraph @

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