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