Debian Codegraph @

translations/manual/es/creating_plugins.po

raw
1 # SOME DESCRIPTIVE TITLE.
2 # Copyright (C) Kovid Goyal
3 # This file is distributed under the same license as the calibre package.
4 #
5 # Translators:
6 # Darío Hereñú, 2014
7 # Jellby <[email protected]>, 2014-2017,2019-2023
8 # Walter Paterno <[email protected]>, 2021,2023-2024,2026
9 msgid ""
10 msgstr ""
11 "Project-Id-Version: calibre\n"
12 "Report-Msgid-Bugs-To: \n"
13 "POT-Creation-Date: 2026-03-12 02:31+0000\n"
14 "PO-Revision-Date: 2014-06-17 08:35+0000\n"
15 "Last-Translator: Walter Paterno <[email protected]>, 2021,2023-2024,2026\n"
16 "Language-Team: Spanish (http://app.transifex.com/calibre/calibre/language/es/)\n"
17 "MIME-Version: 1.0\n"
18 "Content-Type: text/plain; charset=UTF-8\n"
19 "Content-Transfer-Encoding: 8bit\n"
20 "Language: es\n"
21 "Plural-Forms: nplurals=3; plural=n == 1 ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n"
22
23 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:4
24 msgid "Writing your own plugins to extend calibre's functionality"
25 msgstr "Escribir sus propios complementos para extender la funcionalidad de calibre"
26
27 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:6
28 msgid ""
29 "calibre has a very modular design. Almost all functionality in calibre comes"
30 " in the form of plugins. Plugins are used for conversion, for downloading "
31 "news (though these are called recipes), for various components of the user "
32 "interface, to connect to different devices, to process files when adding "
33 "them to calibre and so on. You can get a complete list of all the built-in "
34 "plugins in calibre by going to :guilabel:`Preferences->Advanced->Plugins`."
35 msgstr "calibre tiene un diseño muy modular. Casi todas las funciones de calibre vienen en forma de complementos. Los complementos se utilizan para la conversión, para la descarga de noticias (aunque éstos se llaman fórmulas), para diversos componentes de la interfaz de usuario, para conectarse a diferentes dispositivos, para procesar archivos cuando se añaden a calibre, etcétera. Puede obtener una lista completa de todos los complementos integrados en calibre en :guilabel:`Preferencias > Avanzado > Complementos`."
36
37 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:8
38 msgid ""
39 "Here, we will teach you how to create your own plugins to add new features "
40 "to calibre."
41 msgstr "Aquí le enseñaremos como crear sus propios complementos para agregar funciones a calibre."
42
43 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:13
44 msgid "Contents"
45 msgstr "Índice"
46
47 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:15
48 msgid "This only applies to calibre releases >= 0.8.60"
49 msgstr "Esto sólo se aplica a versiones calibre >= 0.8.60"
50
51 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:18
52 msgid "Anatomy of a calibre plugin"
53 msgstr "Anatomía de un complemento de calibre"
54
55 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:20
56 msgid ""
57 "A calibre plugin is very simple, it's just a ZIP file that contains some "
58 "Python code and any other resources like image files needed by the plugin. "
59 "Without further ado, let's see a basic example."
60 msgstr "Un complemento de calibre es muy sencillo, no es más que un archivo ZIP que contiene algo de código Python y otros recursos, como archivos de imagen, que necesite el complemento. Sin más preámbulos, vamos a ver un ejemplo básico."
61
62 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:24
63 msgid ""
64 "Suppose you have an installation of calibre that you are using to self "
65 "publish various e-documents in EPUB and MOBI formats. You would like all "
66 "files generated by calibre to have their publisher set as \"Hello world\", "
67 "here's how to do it. Create a file named :file:`__init__.py` (this is a "
68 "special name and must always be used for the main file of your plugin) and "
69 "enter the following Python code into it:"
70 msgstr "Supongamos que está usando una instalación de calibre publicar sus propios documentos electrónicos en formatos EPUB y MOBI. Le gustaría que todos los archivos generados por calibre establecieran la editorial como «Hello World», he aquí cómo hacerlo. Cree un archivo llamado :file:`__init __.py` (éste es un nombre especial y siempre debe ser el del archivo principal del complemento) e introduzca el siguiente código Python en él:"
71
72 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:32
73 msgid ""
74 "That's all. To add this code to calibre as a plugin, simply run the "
75 "following in the folder in which you created :file:`__init__.py`::"
76 msgstr "Eso es todo. Para agregar este código a calibre como un complemento, simplemente ejecute lo siguiente en la carpeta donde reside el archivo :file:`__init__.py`::"
77
78 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:38
79 msgid ""
80 "On macOS, the command line tools are inside the calibre bundle, for example,"
81 " if you installed calibre in :file:`/Applications` the command line tools "
82 "are in :file:`/Applications/calibre.app/Contents/MacOS/`."
83 msgstr "En macOS, las herramientas de línea de órdenes están dentro del paquete calibre, por ejemplo, si ha instalado calibre en :file:`/Aplicaciones` las herramientas de línea de órdenes están en :file:/Aplicaciones/calibre.app/Contents/MacOS/`."
84
85 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:42
86 msgid ""
87 "You can download the Hello World plugin from "
88 ":download_file:`helloworld_plugin.zip`."
89 msgstr "Puede descargar el complemento Hello World de :download_file:`helloworld_plugin.zip`."
90
91 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:45
92 msgid ""
93 "Every time you use calibre to convert a book, the plugin's :meth:`run` "
94 "method will be called and the converted book will have its publisher set to "
95 "\"Hello World\". This is a trivial plugin, let's move on to a more complex "
96 "example that actually adds a component to the user interface."
97 msgstr "Cada vez que uses calibre para convertir un libro, se llamará al método :meth:`run` del plugin y el libro convertido tendrá como editor \"Hola Mundo\". Este es un plugin sencillo; pasemos a un ejemplo más complejo que añade un componente a la interfaz de usuario."
98
99 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:50
100 msgid "A User Interface plugin"
101 msgstr "Un complemento de interfaz de usuario"
102
103 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:52
104 msgid ""
105 "This plugin will be spread over a few files (to keep the code clean). It "
106 "will show you how to get resources (images or data files) from the plugin "
107 "ZIP file, allow users to configure your plugin, how to create elements in "
108 "the calibre user interface and how to access and query the books database in"
109 " calibre."
110 msgstr "Este complemento ocupará unos pocos archivos (para mantener el código más limpio). Le mostrará cómo obtener recursos (imágenes o archivos de datos) desde el archivo ZIP del complemento, cómo permitir a los usuarios configurar el complemento, cómo crear elementos en la interfaz de usuario de calibre y cómo acceder y consultar la base de datos de libros de calibre."
111
112 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:57
113 msgid ""
114 "You can download this plugin from :download_file:`interface_demo_plugin.zip`"
115 msgstr "Puede descargar este complemento de :download_file:`interface_demo_plugin.zip`"
116
117 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:61
118 msgid ""
119 "The first thing to note is that this ZIP file has a lot more files in it, "
120 "explained below, pay particular attention to ``plugin-import-name-"
121 "interface_demo.txt``."
122 msgstr "Lo primero que hay que tener en cuenta es que este archivo ZIP tiene muchos más archivos en su interior, explicados a continuación, preste especial atención a ``plugin-import-name-interface_demo.txt``."
123
124 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:64
125 msgid "**plugin-import-name-interface_demo.txt**"
126 msgstr "**plugin-import-name-interface_demo.txt**"
127
128 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:65
129 msgid ""
130 "An empty text file used to enable the multi-file plugin magic. This file "
131 "must be present in all plugins that use more than one .py file. It should be"
132 " empty and its filename must be of the form: ``plugin-import-"
133 "name-**some_name**.txt``. The presence of this file allows you to import "
134 "code from the .py files present inside the ZIP file, using a statement "
135 "like::"
136 msgstr "Un archivo de texto vacío utilizado para activar la gestión de múltiples archivos en el complemento. Este archivo debe estar presente en todos los complementos que utilicen más de un archivo .py. Debe quedar vacío y su nombre debe ser de la forma: ``plugin-import-name-**some_name**.txt``. La presencia de este archivo le permite importar código de los archivos .py presentes dentro del archivo ZIP, usando una sentencia como ésta::"
137
138 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:71
139 msgid ""
140 "The prefix ``calibre_plugins`` must always be present. ``some_name`` comes "
141 "from the filename of the empty text file. ``some_module`` refers to "
142 ":file:`some_module.py` file inside the ZIP file. Note that this importing is"
143 " just as powerful as regular Python imports. You can create packages and "
144 "subpackages of .py modules inside the ZIP file, just like you would normally"
145 " (by defining __init__.py in each sub-folder), and everything should \"just "
146 "work\"."
147 msgstr "El prefijo ``calibre_plugins`` debe estar siempre presente. ``some_name`` proviene del nombre del archivo de texto vacío. ``some_module`` se refiere al archivo ``file:`some_module.py` dentro del archivo ZIP. Tenga en cuenta que esta importación es tan potente como las importaciones normales de Python. Puede crear paquetes y subpaquetes de módulos .py dentro del archivo ZIP, como lo haría normalmente (definiendo `__init__.py` en cada subcarpeta), y todo debería funcionar correctamente."
148
149 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:76
150 msgid ""
151 "The name you use for ``some_name`` enters a global namespace shared by all "
152 "plugins, **so make it as unique as possible**. But remember that it must be "
153 "a valid Python identifier (only alphabets, numbers and the underscore)."
154 msgstr "El nombre que utilice para ``some_name`` entra en un espacio global de nombres compartido por todos los complementos, **así que hágalo tan único como sea posible**. Pero recuerde que debe ser un identificador Python válido (sólo letras, números y guión bajo)."
155
156 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:79
157 msgid "**__init__.py**"
158 msgstr "**__init__.py**"
159
160 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:80
161 msgid "As before, the file that defines the plugin class"
162 msgstr "Como antes, el archivo que define la clase del complemento"
163
164 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:82
165 msgid "**main.py**"
166 msgstr "**main.py**"
167
168 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:83
169 msgid "This file contains the actual code that does something useful"
170 msgstr "Este archivo contiene el código real que realiza alguna operación útil"
171
172 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:85
173 msgid "**ui.py**"
174 msgstr "**ui.py**"
175
176 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:86
177 msgid "This file defines the interface part of the plugin"
178 msgstr "Este archivo define la interfaz del complemento"
179
180 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:88
181 msgid "**images/icon.png**"
182 msgstr "**images/icon.png**"
183
184 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:89
185 msgid "The icon for this plugin"
186 msgstr "El icono para este complemento"
187
188 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:91
189 msgid "**about.txt**"
190 msgstr "**about.txt**"
191
192 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:92
193 msgid "A text file with information about the plugin"
194 msgstr "Un archivo de texto con información acerca de este complemento"
195
196 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:94
197 msgid "**translations**"
198 msgstr "**translations**"
199
200 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:95
201 msgid ""
202 "A folder containing .mo files with the translations of the user interface of"
203 " your plugin into different languages. See below for details."
204 msgstr "Una carpeta que contiene archivos .mo con las traducciones de la interfaz de usuario del complemento a diferentes idiomas. Ver más adelante para más detalles."
205
206 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:99
207 msgid "Now let's look at the code."
208 msgstr "Ahora veamos el código."
209
210 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:102
211 msgid "__init__.py"
212 msgstr "__init__.py"
213
214 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:104
215 msgid "First, the obligatory ``__init__.py`` to define the plugin metadata:"
216 msgstr "Primero, el ``__init__.py`` obligatorio para definir los metadatos del complemento:"
217
218 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:109
219 msgid ""
220 "The only noteworthy feature is the field :attr:`actual_plugin`. Since "
221 "calibre has both command line and GUI interfaces, GUI plugins like this one "
222 "should not load any GUI libraries in __init__.py. The actual_plugin field "
223 "does this for you, by telling calibre that the actual plugin is to be found "
224 "in another file inside your ZIP archive, which will only be loaded in a GUI "
225 "context."
226 msgstr "La única característica notable es el campo :attr:`actual_plugin`. Puesto que calibre posee tanto una interfaz gráfica como de línea de órdenes, los complementos con interfaz gráfica como éste no cargan ninguna biblioteca gráfica en __init__.py. El campo actual_plugin se encargad de esto, informando a calibre de que el complemento real se encuentra en otro archivo dentro del archivo ZIP, que sólo se cargará en un contexto de interfaz gráfica."
227
228 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:114
229 msgid ""
230 "Remember that for this to work, you must have a plugin-import-name-"
231 "some_name.txt file in your plugin ZIP file, as discussed above."
232 msgstr "Recuerde que para que esto funcione, debe tener un archivo plugin-import-name-some_name.txt en el archivo ZIP del complemento, como se discutió anteriormente."
233
234 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:117
235 msgid ""
236 "Also there are a couple of methods for enabling user configuration of the "
237 "plugin. These are discussed below."
238 msgstr "También hay un par de métodos para permitir la configuración por parte del usuario del complemento. Éstos se discuten más adelante."
239
240 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:120
241 msgid "ui.py"
242 msgstr "ui.py"
243
244 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:122
245 msgid ""
246 "Now let's look at ui.py which defines the actual GUI plugin. The source code"
247 " is heavily commented and should be self explanatory:"
248 msgstr "Veamos ahora ui.py, que define la interfaz gráfica del complemento. El código fuente está explícitamente comentado y se explica por sí mismo:"
249
250 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:128
251 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:220
252 msgid "main.py"
253 msgstr "main.py"
254
255 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:130
256 msgid "The actual logic to implement the Interface Plugin Demo dialog."
257 msgstr "El código que implementa el cuadro de diálogo «Interface Plugin Demo»."
258
259 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:136
260 msgid "Getting resources from the plugin ZIP file"
261 msgstr "Obtener recursos del archivo ZIP del complemento"
262
263 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:138
264 msgid ""
265 "calibre's plugin loading system defines a couple of built-in functions that "
266 "allow you to conveniently get files from the plugin ZIP file."
267 msgstr "El sistema de carga de complementos de calibre tiene predefinidas un par de funciones que permiten obtener archivos desde el archivo ZIP del complemento de manera práctica."
268
269 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:140
270 msgid "**get_resources(name_or_list_of_names)**"
271 msgstr "**get_resources(nombre_o_lista_de_nombres)**"
272
273 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:141
274 msgid ""
275 "This function should be called with a list of paths to files inside the ZIP "
276 "file. For example to access the file :file:`icon.png` in the folder images "
277 "in the ZIP file, you would use: ``images/icon.png``. Always use a forward "
278 "slash as the path separator, even on Windows. When you pass in a single "
279 "name, the function will return the raw bytes of that file or None if the "
280 "name was not found in the ZIP file. If you pass in more than one name then "
281 "it returns a dictionary mapping the names to bytes. If a name is not found,"
282 " it will not be present in the returned dictionary."
283 msgstr "Esta función debe ejecutarse con una lista de rutas de acceso a archivos dentro del archivo ZIP. Por ejemplo, para acceder al archivo :file:`icon.png` en la carpeta :file:`images` del archivo ZIP, utilizaría: ``images/icon.png``. Use siempre una barra inclinada a la derecha como separador de ruta, incluso en windows. Cuando se pasa un solo nombre, la función devolverá los bytes en bruto de ese archivo o None si el nombre no se encuentra en el archivo ZIP. Si se pasa más de un nombre, entonces devuelve un diccionario de mapeo de nombres a bytes. Si no se encuentra un nombre, no estará presente en el diccionario devuelto."
284
285 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:150
286 msgid "**get_icons(name_or_list_of_names, plugin_name='')**"
287 msgstr "**get_icons(nombre_o_lista_de_nombres, nombre_de_complemento)**"
288
289 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:151
290 msgid ""
291 "A wrapper for get_resources() that creates QIcon objects from the raw bytes "
292 "returned by get_resources. If a name is not found in the ZIP file the "
293 "corresponding QIcon will be null. In order to support icon theme-ing, pass "
294 "in the human friendly name of your plugin as ``plugin_name``. If the user is"
295 " using an icon theme with icons for your plugin, they will be loaded "
296 "preferentially."
297 msgstr "Una extensión de get_resources() que crea objetos QIcon a partir de los bytes en bruto devueltos por get_resources. Si un nombre no se encuentra en el archivo ZIP, el correspondiente QIcon será nulo. Para permitir el uso de temas de iconos, pase el nombre «para humanos» del complemento como ``nombre de complemento``. Si el usuario está usando un tema de iconos con iconos para el complemento, se usarán éstos de manera preferente."
298
299 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:160
300 msgid "Enabling user configuration of your plugin"
301 msgstr "Habilitar la configuración de usuario para el complemento"
302
303 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:162
304 msgid ""
305 "To allow users to configure your plugin, you must define three methods in "
306 "your base plugin class, **is_customizable**, **config_widget** and "
307 "**save_settings** as shown below:"
308 msgstr "Para permitir a los usuarios configurar el complemento, debe definir tres métodos en la clase base del complemento, **is_customizable**, **config_widget** y **save_settings** como se muestra a continuación:"
309
310 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:173
311 msgid ""
312 "calibre has many different ways to store configuration data (a legacy of its"
313 " long history). The recommended way is to use the **JSONConfig** class, "
314 "which stores your configuration information in a .json file."
315 msgstr "calibre tiene muchas maneras diferentes de almacenar los datos de configuración (un legado de su larga historia). El método recomendado es usar la clase **JSONConfig**, que almacena la información de configuración en un archivo .json."
316
317 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:175
318 msgid ""
319 "The code to manage configuration data in the demo plugin is in config.py:"
320 msgstr "El código para gestionar los datos de configuración en el complemento de demostración está en config.py:"
321
322 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:180
323 msgid ""
324 "The ``prefs`` object is now available throughout the plugin code by a "
325 "simple::"
326 msgstr "El objeto ``prefs`` está ahora disponible en todo el código del complemento simplemente con::"
327
328 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:185
329 msgid "You can see the ``prefs`` object being used in main.py:"
330 msgstr "Puede observar que el objeto ``prefs`` se usa en main.py:"
331
332 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:192
333 msgid "Edit book plugins"
334 msgstr "Complementos para modificar libros"
335
336 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:194
337 msgid ""
338 "Now let's change gears for a bit and look at creating a plugin to add tools "
339 "to the calibre book editor. The plugin is available here: "
340 ":download_file:`editor_demo_plugin.zip`."
341 msgstr "Vamos a cambiar de tercio y enfocarnos en la creación de un complemento para añadir herramientas al editor de libros de calibre. El complemento está disponible aquí: :download_file:`editor_demo_plugin.zip`."
342
343 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:198
344 msgid ""
345 "The first step, as for all plugins is to create the import name empty txt "
346 "file, as described :ref:`above <import_name_txt>`. We shall name the file "
347 "``plugin-import-name-editor_plugin_demo.txt``."
348 msgstr "El primer paso, como para todos los complementos es crear el archivo vacío con el nombre de importación descrito :ref:`anteriormente <import_name_txt>`. Vamos a nombrar el archivo ``plugin-import-name-editor_plugin_demo.txt``."
349
350 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:202
351 msgid ""
352 "Now we create the mandatory ``__init__.py`` file that contains metadata "
353 "about the plugin -- its name, author, version, etc."
354 msgstr "Ahora creamos el archivo obligatorio ``__init__.py`` que contiene los metadatos del complemento: nombre, autor, versión, etc."
355
356 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:208
357 msgid ""
358 "A single editor plugin can provide multiple tools each tool corresponds to a"
359 " single button in the toolbar and entry in the :guilabel:`Plugins` menu in "
360 "the editor. These can have sub-menus in case the tool has multiple related "
361 "actions."
362 msgstr "Un solo complemento del editor puede proporcionar múltiples herramientas; cada herramienta corresponde a un único botón en la barra de herramientas y entrada en el menú :guilabel:`Complementos` del editor. Éstos pueden tener submenús en el caso de que la herramienta posea múltiples acciones relacionadas."
363
364 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:212
365 msgid ""
366 "The tools must all be defined in the file ``main.py`` in your plugin. Every "
367 "tool is a class that inherits from the "
368 ":class:`calibre.gui2.tweak_book.plugin.Tool` class. Let's look at "
369 "``main.py`` from the demo plugin, the source code is heavily commented and "
370 "should be self-explanatory. Read the API documents of the "
371 ":class:`calibre.gui2.tweak_book.plugin.Tool` class for more details."
372 msgstr "Todas las herramientas deben estar definidas en el archivo ``main.py`` del complemento. Cada herramienta es una clase que hereda de la clase :class:`calibre.gui2.tweak_book.plugin.Tool`. Echemos un vistazo al ``main.py`` del complemento de demostración; el código fuente está profusamente comentado y se explica por sí mismo. Lea la documentación de la API de la clase :clase:`calibre.gui2.tweak_book.plugin.Tool` para más detalles."
373
374 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:222
375 msgid ""
376 "Here we will see the definition of a single tool that will multiply all font"
377 " sizes in the book by a number provided by the user. This tool demonstrates "
378 "various important concepts that you will need in developing your own "
379 "plugins, so you should read the (heavily commented) source code carefully."
380 msgstr "Aquí veremos la definición de una herramienta que multiplicará todos los tamaños de letra en el libro por un número proporcionado por el usuario. Esta herramienta demuestra varios conceptos importantes que se necesitarán para desarrollar otros complementos, por lo que debe leer el código fuente (muy comentado) cuidadosamente."
381
382 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:230
383 msgid ""
384 "Let's break down ``main.py``. We see that it defines a single tool, named "
385 "*Magnify fonts*. This tool will ask the user for a number and multiply all "
386 "font sizes in the book by that number."
387 msgstr "Vamos a analizar ``main.py``. Vemos que define una única herramienta, llamada *Magnify fonts*. Esta herramienta le pediráá al usuario un número y multiplicará todos los tamaños de letra en el libro por dicho número."
388
389 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:234
390 msgid ""
391 "The first important thing is the tool name which you must set to some "
392 "relatively unique string as it will be used as the key for this tool."
393 msgstr "La primera cosa importante es el nombre de la herramienta que debe establecer a algún texto relativamente único, ya que se utilizará como clave para esta herramienta."
394
395 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:237
396 msgid ""
397 "The next important entry point is the "
398 ":meth:`calibre.gui2.tweak_book.plugin.Tool.create_action`. This method "
399 "creates the QAction objects that appear in the plugins toolbar and plugin "
400 "menu. It also, optionally, assigns a keyboard shortcut that the user can "
401 "customize. The triggered signal from the QAction is connected to the "
402 "ask_user() method that asks the user for the font size multiplier, and then "
403 "runs the magnification code."
404 msgstr "El siguiente punto de entrada importante es :meth:`calibre.gui2.tweak_book.plugin.Tool.create_action`. Este método crea los objetos QAction que aparecen en la barra de herramientas y en el menú de complementos. También, opcionalmente, asigna un atajo de teclado que el usuario puede personalizar. La señal que se genera en el objeto QAction está conectada con el método ask_user() que pide al usuario el multiplicador del tamaño de letra, y luego ejecuta el código de ampliación."
405
406 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:245
407 msgid ""
408 "The magnification code is well commented and fairly simple. The main things "
409 "to note are that you get a reference to the editor window as ``self.gui`` "
410 "and the editor *Boss* as ``self.boss``. The *Boss* is the object that "
411 "controls the editor user interface. It has many useful methods, that are "
412 "documented in the :class:`calibre.gui2.tweak_book.boss.Boss` class."
413 msgstr "El código de aumento está bien comentado y es bastante simple. Lo principal que hay que destacar es que se obtiene una referencia a la ventana del editor como ``self.gui`` y al *Boss* del editor como ``self.boss``. El *Boss* es el objeto que controla la interfaz de usuario del editor. Tiene muchos métodos útiles, que se documentan en la clase :class:`calibre.gui2.tweak_book.boss.Boss`."
414
415 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:251
416 msgid ""
417 "Finally, there is ``self.current_container`` which is a reference to the "
418 "book being edited as a "
419 ":class:`calibre.ebooks.oeb.polish.container.Container` object. This "
420 "represents the book as a collection of its constituent HTML/CSS/image files "
421 "and has convenience methods for doing many useful things. The container "
422 "object and various useful utility functions that can be reused in your "
423 "plugin code are documented in :ref:`polish_api`."
424 msgstr "Finalmente está ``self.current_container``, que es una referencia al libro que se está editando como un objeto :class:`calibre.ebooks.oeb.polish.container.Container`. Éste representa el libro como una colección de archivos HTML, CSS e imágenes y posee diversos métodos prácticos para hacer varias cosas útiles. El objeto contenedor y varias funciones utilitarias que se pueden reutilizar en el código de los complementos están documentados en :ref:`polish_api`."
425
426 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:259
427 msgid "Adding translations to your plugin"
428 msgstr "Añadir traducciones al complemento"
429
430 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:261
431 msgid ""
432 "You can have all the user interface strings in your plugin translated and "
433 "displayed in whatever language is set for the main calibre user interface."
434 msgstr "Puede traducir todos los textos de la interfaz de usuario del complemento y mostrarlos en el idioma en que está configurada la interfaz principal de calibre."
435
436 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:264
437 msgid ""
438 "The first step is to go through your plugin's source code and mark all user "
439 "visible strings as translatable, by surrounding them in _(). For example::"
440 msgstr "El primer paso es ir al código fuente del complemento y marcar todos los textos visibles por el usuario como traducibles, encerrándolos con _(). Por ejemplo::"
441
442 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:269
443 msgid ""
444 "Then use some program to generate .po files from your plugin source code. "
445 "There should be one .po file for every language you want to translate into. "
446 "For example: de.po for German, fr.po for French and so on. You can use the "
447 "`Poedit <https://poedit.net/>`_ program for this."
448 msgstr "Después utilice algún programa para generar archivos .po para el código fuente del complemento. Debe haber un archivo .po para cada idioma al que lo quiera traducir. Por ejemplo: de.po para el alemán, fr.po para el francés, etc. Puede utilizar el programa `Poedit <https://poedit.net/>`_ para esto."
449
450 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:274
451 msgid ""
452 "Send these .po files to your translators. Once you get them back, compile "
453 "them into .mo files. You can again use Poedit for that, or just do::"
454 msgstr "Envíe estos archivos .po a los traductores. Cuando reciba los archivos traducidos, compílelos en archivos .mo. Puede utilizar nuevamente Poedit para ello, o simplemente ejecutar::"
455
456 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:279
457 msgid "Put the .mo files into the ``translations`` folder in your plugin."
458 msgstr "Ponga los archivos .mo en la carpeta ``translations`` del complemento."
459
460 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:281
461 msgid ""
462 "The last step is to simply call the function `load_translations()` at the "
463 "top of your plugin's .py files. For performance reasons you should only call"
464 " this function in those .py files that actually have translatable strings. "
465 "So in a typical User Interface plugin you would call it at the top of "
466 "``ui.py`` but not ``__init__.py``."
467 msgstr "El último paso es simplemente ejecutar la función `load_translations()` al principio de los archivos .py del complemento. Por motivos de rendimiento, sólo debe llamar a esta función en aquellos archivos .py que realmente poseen textos traducibles. Así que en un complemento de interfaz de usuario típico, la ejecutaría en ``ui.py`` pero no en ``__init__.py``."
468
469 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:287
470 msgid ""
471 "You can test the translations of your plugins by changing the user interface"
472 " language in calibre under :guilabel:`Preferences->Interface->Look & feel` "
473 "or by running calibre with the ``CALIBRE_OVERRIDE_LANG`` environment "
474 "variable set. For example::"
475 msgstr "Puede probar las traducciones del complemento cambiando el idioma de la interfaz de usuario en calibre bajo :guilabel:`Preferencias > Interfaz > Apariencia` o ejecutando calibre con la variable de entorno ``CALIBRE_OVERRIDE_LANG`` establecida. Por ejemplo::"
476
477 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:293
478 msgid ""
479 "Replace ``de`` with the language code of the language you want to test."
480 msgstr "Sustituya ``de`` por el código del idioma que desea probar."
481
482 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:295
483 msgid ""
484 "For translations with plurals, use the ``ngettext()`` function instead of "
485 "``_()``. For example::"
486 msgstr "Para traducciones con plurales, use la función ``ngettext()`` en lugar de ``_()``. Por ejemplo::"
487
488 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:301
489 msgid "The plugin API"
490 msgstr "La API del complemento"
491
492 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:303
493 msgid ""
494 "As you may have noticed above, a plugin in calibre is a class. There are "
495 "different classes for the different types of plugins in calibre. Details on "
496 "each class, including the base class of all plugins can be found in "
497 ":ref:`plugins`."
498 msgstr "Como ya se habrá dado cuenta, un complemento en calibre es una clase. Hay diferentes clases para los diferentes tipos de complementos en calibre. Los detalles de cada clase, incluyendo la clase base de todos los complementos, se pueden encontrar en :ref:`plugins`."
499
500 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:306
501 msgid ""
502 "Your plugin is almost certainly going to use code from calibre. To learn how"
503 " to find various bits of functionality in the calibre code base, read the "
504 "section on the calibre :ref:`code_layout`."
505 msgstr "Es casi seguro que el complemento va a usar el código de calibre. Para saber cómo encontrar los distintos elementos de funcionalidad en el código base de calibre, lea la sección :ref:`code_layout`."
506
507 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:311
508 msgid "Debugging plugins"
509 msgstr "Depurar complementos"
510
511 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:313
512 msgid ""
513 "The first, most important step is to run calibre in debug mode. You can do "
514 "this from the command line with::"
515 msgstr "El primer paso, el más importante, es ejecutar calibre en modo de depuración. Puede hacer esto desde la línea de órdenes con::"
516
517 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:317
518 msgid ""
519 "Or from within calibre by right-clicking the :guilabel:`Preferences` button "
520 "or using the :kbd:`Ctrl+Shift+R` keyboard shortcut."
521 msgstr "O desde el mismo calibre, pulsando con el botón derecho en :guilabel:`Preferencias` o usando el atajo de teclado :kbd:`Ctrl+Mayús+R`."
522
523 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:319
524 msgid ""
525 "When running from the command line, debug output will be printed to the "
526 "console, when running from within calibre the output will go to a txt file."
527 msgstr "Cuando se ejecuta desde la línea de órdenes, la salida de depuración se enviará a la consola, si se ejecuta dentro de calibre, la salida irá a un archivo txt."
528
529 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:321
530 msgid ""
531 "You can insert print statements anywhere in your plugin code, they will be "
532 "output in debug mode. Remember, this is Python, you really shouldn't need "
533 "anything more than print statements to debug ;) I developed all of calibre "
534 "using just this debugging technique."
535 msgstr "Puede insertar sentencias de impresión en cualquier lugar en el código fuente del complemento, tendrán efecto en el modo de depuración. Recuerde, esto es Python, no debe necesitar más que sentencias de impresión para depurar ;) He desarrollado todo calibre usando sólo esta técnica de depuración."
536
537 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:323
538 msgid ""
539 "You can quickly test changes to your plugin by using the following command "
540 "line::"
541 msgstr "Puede probar rápidamente los cambios en el complemento con la siguiente orden::"
542
543 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:328
544 msgid ""
545 "This will shutdown a running calibre, wait for the shutdown to complete, "
546 "then update your plugin in calibre and relaunch calibre."
547 msgstr "Esto cerrará calibre, esperará hasta que se cierre completamente, después actualiza el complemento en calibre y vuelve a iniciar calibre."
548
549 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:331
550 msgid "More plugin examples"
551 msgstr "Más ejemplos de complementos"
552
553 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:333
554 msgid ""
555 "You can find a list of many sophisticated calibre plugins `here "
556 "<https://www.mobileread.com/forums/showthread.php?t=118764>`_."
557 msgstr "Puede encontrar una lista de muchos complementos de calibre más complejos `aqui <https://www.mobileread.com/forums/showthread.php?t=118764>`_."
558
559 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:336
560 msgid "Sharing your plugins with others"
561 msgstr "Compartir sus complementos con otros"
562
563 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:338
564 msgid ""
565 "If you would like to share the plugins you have created with other users of "
566 "calibre, post your plugin in a new thread in the `calibre plugins forum "
567 "<https://www.mobileread.com/forums/forumdisplay.php?f=237>`_."
568 msgstr "Si desea compartir los complementos que ha creado con otros usuarios de calibre, inicie un nuevo hilo adjuntando el complemento en el `foros de complementos de calibre <https://www.mobileread.com/forums/forumdisplay.php?f=237>`_ (en inglés)."