Debian Codegraph @

translations/manual/eo/plugins.po

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