Debian Codegraph @

translations/manual/es/develop.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-2015
7 # Jellby <[email protected]>, 2014-2026
8 # Walter Paterno <[email protected]>, 2024-2026
9 msgid ""
10 msgstr ""
11 "Project-Id-Version: calibre\n"
12 "Report-Msgid-Bugs-To: \n"
13 "POT-Creation-Date: 2026-07-30 18:07+0000\n"
14 "PO-Revision-Date: 2014-06-17 08:34+0000\n"
15 "Last-Translator: Jellby <[email protected]>, 2014-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/develop.rst:4
24 msgid "Setting up a calibre development environment"
25 msgstr "Configurar un entorno de desarrollo de calibre"
26
27 #: ../../../__w/calibre/calibre/manual/develop.rst:6
28 msgid ""
29 "calibre is completely open source, licensed under the `GNU GPL v3 "
30 "<https://www.gnu.org/licenses/gpl.html>`_. This means that you are free to "
31 "download and modify the program to your heart's content. In this section, "
32 "you will learn how to get a calibre development environment set up on the "
33 "operating system of your choice. calibre is written primarily in `Python "
34 "<https://www.python.org>`_ with some C/C++ code for speed and system "
35 "interfacing. Note that calibre requires at least Python 3.8."
36 msgstr "calibre es código completamente abierto, licenciado bajo la `GNU GPL v3 <https://www.gnu.org/licenses/gpl.html>`_. Esto significa que cualquiera es libre de descargar y modificar el programa a su gusto. En esta sección, se mostrará cómo configurar un entorno de desarrollo de calibre en el sistema operativo de su elección. calibre está escrito principalmente en `Python <https://www.python.org>`_, con algo de código C/C++ para mejorar la velocidad y la interfaz con el sistema. Tenga en cuenta que calibre requiere al menos Python 3.8."
37
38 #: ../../../__w/calibre/calibre/manual/develop.rst:14
39 msgid "Contents"
40 msgstr "Índice"
41
42 #: ../../../__w/calibre/calibre/manual/develop.rst:17
43 msgid "Design philosophy"
44 msgstr "Filosofía del diseño"
45
46 #: ../../../__w/calibre/calibre/manual/develop.rst:19
47 msgid ""
48 "calibre has its roots in the Unix world, which means that its design is "
49 "highly modular. The modules interact with each other via well defined "
50 "interfaces. This makes adding new features and fixing bugs in calibre very "
51 "easy, resulting in a frenetic pace of development. Because of its roots, "
52 "calibre has a comprehensive command line interface for all its functions, "
53 "documented in :doc:`generated/en/cli-index`."
54 msgstr "calibre tiene sus raíces en el mundo Unix, lo que significa que su diseño es altamente modular. Los módulos interactúan entre sí a través de interfaces bien definidas. Esto hace que la añadir nuevas característicasy corregir errores en calibre sea muy fácil, lo que resulta en un ritmo frenético de desarrollo. Debido a sus raíces, calibre tiene una interfaz completa de línea de órdenes para todas sus funciones, documentadas en :doc:`generated/es/cli-index`."
55
56 #: ../../../__w/calibre/calibre/manual/develop.rst:24
57 msgid ""
58 "The modular design of calibre is expressed via ``Plugins``. There is a "
59 ":ref:`tutorial <customize>` on writing calibre plugins. For example, adding "
60 "support for a new device to calibre typically involves writing fewer than "
61 "100 lines of code in the form of a device driver plugin. You can browse the "
62 "`built-in drivers "
63 "<https://github.com/kovidgoyal/calibre/tree/master/src/calibre/devices>`_. "
64 "Similarly, adding support for new conversion formats involves writing "
65 "input/output format plugins. Another example of the modular design is the "
66 ":ref:`recipe system <news>` for fetching news. For more examples of plugins "
67 "designed to add features to calibre, see the `Index of plugins "
68 "<https://www.mobileread.com/forums/showthread.php?p=1362767#post1362767>`_."
69 msgstr "El diseño modular de calibre se expresa mediante complementos. Existe un tutorial<customize> sobre cómo escribir complementos para calibre. Por ejemplo, añadir compatibilidad con un nuevo dispositivo a calibre suele implicar escribir menos de 100 líneas de código en forma de complemento de controlador de dispositivo. Puede explorar los controladores integrados <https://github.com/kovidgoyal/calibre/tree/master/src/calibre/devices>. De igual forma, añadir compatibilidad con nuevos formatos de conversión implica escribir complementos de formato de entrada/salida. Otro ejemplo de diseño modular es el sistema <news> de recetas para la obtención de noticias. Para más ejemplos de complementos diseñados para añadir funciones a calibre, consulte el índice de complementos <https://www.mobileread.com/forums/showthread.php?p=1362767#post1362767>."
70
71 #: ../../../__w/calibre/calibre/manual/develop.rst:34
72 msgid "Code layout"
73 msgstr "Estructura del código"
74
75 #: ../../../__w/calibre/calibre/manual/develop.rst:36
76 msgid ""
77 "All the calibre Python code is in the ``calibre`` package. This package "
78 "contains the following main sub-packages"
79 msgstr "Todo el código Python de calibre está en el paquete ``calibre``. Este paquete contiene los siguientes subpaquetes principales"
80
81 #: ../../../__w/calibre/calibre/manual/develop.rst:38
82 msgid ""
83 "devices - All the device drivers. Just look through some of the built-in "
84 "drivers to get an idea for how they work."
85 msgstr "devices - Todos los controladores de dispositivos. Examite alguno de los controladores predefinidos para hacerse una idea de cómo funcionan."
86
87 #: ../../../__w/calibre/calibre/manual/develop.rst:40
88 msgid ""
89 "For details, see: ``devices.interface`` which defines the interface "
90 "supported by device drivers and ``devices.usbms`` which defines a generic "
91 "driver that connects to a USBMS device. All USBMS based drivers in calibre "
92 "inherit from it."
93 msgstr "Para obtener más información, consulte: ``devices.interface`` que define la interfaz soportada por los controladores de dispositivos y ``devices.usbms`` que define un controlador genérico que se conecta a un dispositivo USBMS. Todos los controladores de dispositivos basados en USBMS ​​en calibre descienden de él."
94
95 #: ../../../__w/calibre/calibre/manual/develop.rst:43
96 msgid ""
97 "e-books - All the e-book conversion/metadata code. A good starting point is"
98 " ``calibre.ebooks.conversion.cli`` which is the module powering the "
99 ":command:`ebook-convert` command. The conversion process is controlled via "
100 "``conversion.plumber``. The format independent code is all in ``ebooks.oeb``"
101 " and the format dependent code is in ``ebooks.format_name``."
102 msgstr "ebooks - Todo el código de conversión y metadatos de libros electrónicos. Un buen punto de partida es ``calibre.ebooks.conversion.cli`` que es el módulo que realiza las funciones de la orden :command:`ebook-convert`. El proceso de conversión se controla mediante ``conversion.plumber``. El código independiente de formato está todo en ``ebooks.oeb`` y el código dependiente de formato está ``ebooks.format_name``."
103
104 #: ../../../__w/calibre/calibre/manual/develop.rst:47
105 msgid ""
106 "Metadata reading, writing, and downloading is all in ``ebooks.metadata``"
107 msgstr "La lectura, escritura y descarga de metadatos están en ``ebooks.metadata``"
108
109 #: ../../../__w/calibre/calibre/manual/develop.rst:48
110 msgid ""
111 "Conversion happens in a pipeline, for the structure of the pipeline, see "
112 ":ref:`conversion-introduction`. The pipeline consists of an input plugin, "
113 "various transforms and an output plugin. The code that constructs and drives"
114 " the pipeline is in :file:`plumber.py`. The pipeline works on a "
115 "representation of an e-book that is like an unzipped epub, with manifest, "
116 "spine, toc, guide, html content, etc. The class that manages this "
117 "representation is OEBBook in ``ebooks.oeb.base``. The various "
118 "transformations that are applied to the book during conversions live in "
119 ":file:`oeb/transforms/*.py`. And the input and output plugins live in "
120 ":file:`conversion/plugins/*.py`."
121 msgstr "La conversión tiene lugar en diferentes etapas, para ver la estructura de estas etapas vea :ref:`conversión-introduction`. Las etapas consisten en un complemento de entrada, diversas transformaciones y un complemento de salida. El código que controla las etapas está en :file:`plumber.py`. La sucesión de etapas trabaja sobre una representación del libro electrónico que es como un epub descomprimido, con manifiesto, lomo, índice, guía, contenidos html, etc. La clase que maneja esta representación es OEBBook en ``ebooks.oeb.base``. Las diversas transformaciones que se aplican al libro durante las conversiones están en :file:`oeb/transforms/*.py`. Los complementos de entrada y salida están en :file:`conversion/plugins/*.py`."
122
123 #: ../../../__w/calibre/calibre/manual/develop.rst:58
124 msgid ""
125 "E-book editing happens using a different container object. It is documented "
126 "in :ref:`polish_api`."
127 msgstr "La modificación de libros electrónicos se realiza mediante un objeto contenedor diferente. Está documentado en :ref:`polish_api`."
128
129 #: ../../../__w/calibre/calibre/manual/develop.rst:61
130 msgid ""
131 "db - The database back-end. See :ref:`db_api` for the interface to the "
132 "calibre library."
133 msgstr "db - El motor de base de datos. Vea :ref:`db_api` para más información sobre la interfaz de la biblioteca de calibre."
134
135 #: ../../../__w/calibre/calibre/manual/develop.rst:63
136 msgid "Content server: ``srv`` is the calibre Content server."
137 msgstr "servidor de contenido: ``srv`` es el servidor de contenido de calibre."
138
139 #: ../../../__w/calibre/calibre/manual/develop.rst:65
140 msgid ""
141 "gui2 - The Graphical User Interface. GUI initialization happens in "
142 "``gui2.main`` and ``gui2.ui``. The e-book-viewer is in ``gui2.viewer``. The "
143 "e-book editor is in ``gui2.tweak_book``."
144 msgstr "gui2 - La interfaz gráfica de usuario. La inicialización de la interfaz gráfica ocurre en ``gui2.main`` y ``gui2.ui``. El visor de libros electrónicos está en ``gui2.viewer``. El editor de libros electrónicos está en ``gui2.tweak_book``."
145
146 #: ../../../__w/calibre/calibre/manual/develop.rst:67
147 msgid ""
148 "If you want to locate the entry points for all the various calibre "
149 "executables, look at the ``entry_points`` structure in `linux.py "
150 "<https://github.com/kovidgoyal/calibre/blob/master/src/calibre/linux.py>`_."
151 msgstr "Si desea localizar los puntos de entrada de todos los ejecutables de calibre, vea la estructura ``entry_points`` en `linux.py <https://github.com/kovidgoyal/calibre/blob/master/src/calibre/linux.py>`_."
152
153 #: ../../../__w/calibre/calibre/manual/develop.rst:71
154 msgid ""
155 "If you need help understanding the code, post in the `development forum "
156 "<https://www.mobileread.com/forums/forumdisplay.php?f=240>`_ and you will "
157 "most likely get help from one of calibre's many developers."
158 msgstr "Si necesita ayuda para entender el código, escriba en el foro de desarrollo `<https://www.mobileread.com/forums/forumdisplay.php?f=240>`_ y probablemente obtendrá ayuda de uno de los muchos desarrolladores de calibre."
159
160 #: ../../../__w/calibre/calibre/manual/develop.rst:75
161 msgid "Getting the code"
162 msgstr "Obtener el código"
163
164 #: ../../../__w/calibre/calibre/manual/develop.rst:77
165 msgid ""
166 "You can get the calibre source code in two ways, using a version control "
167 "system or directly downloading a :website_base:`tarball <dist/src>`."
168 msgstr "Puede obtener el código fuente de calibre de dos maneras, usando un sistema de control de versiones o descargando directamente un :website_base:`tarball <dist/src>`_."
169
170 #: ../../../__w/calibre/calibre/manual/develop.rst:80
171 msgid ""
172 "calibre uses `Git <https://www.git-scm.com/>`_, a distributed version "
173 "control system. Git is available on all the platforms calibre supports. "
174 "After installing Git, you can get the calibre source code with the command::"
175 msgstr "calibre utiliza `Git <https://www.git-scm.com/>`_, un sistema de control de versiones distribuido. Git está disponible en todas las plataformas que soporta calibre. Una vez instalado Git, puede obtener el código fuente de calibre con la orden::"
176
177 #: ../../../__w/calibre/calibre/manual/develop.rst:86
178 msgid ""
179 "On Windows you will need the complete path name, that will be something like"
180 " :file:`C:\\\\Program Files\\\\Git\\\\git.exe`."
181 msgstr "En Windows necesitará la ruta completa, que será algo así como :file:`C:\\\\Archivos de programa\\\\Git\\\\git.exe`."
182
183 #: ../../../__w/calibre/calibre/manual/develop.rst:88
184 msgid ""
185 "calibre is a very large project with a very long source control history, so "
186 "the above can take a while (10 mins to an hour depending on your internet "
187 "speed)."
188 msgstr "calibre es un gran proyecto con un extenso historial de control de código fuente, asi que esto puede tomar un tiempo (de 10 minutos a una hora, dependiendo de la velocidad de la conexión a Internet). "
189
190 #: ../../../__w/calibre/calibre/manual/develop.rst:91
191 msgid ""
192 "If you want to get the code faster, the source code for the latest release "
193 "is always available as an :website_base:`archive <dist/src>`."
194 msgstr "Si quiere obtener el código más rápidamente, el código fuente de la última versión está siempre disponible como un :website_base:`archivo <dist/src>`_."
195
196 #: ../../../__w/calibre/calibre/manual/develop.rst:94
197 msgid "To update a branch to the latest code, use the command::"
198 msgstr "Para actualizar el código de una rama a su versión más reciente, use la orden::"
199
200 #: ../../../__w/calibre/calibre/manual/develop.rst:98
201 msgid ""
202 "You can also browse the code at `GitHub "
203 "<https://github.com/kovidgoyal/calibre>`_."
204 msgstr "También puede explorar el código en `GitHub <https://github.com/kovidgoyal/calibre>`_."
205
206 #: ../../../__w/calibre/calibre/manual/develop.rst:101
207 msgid "Submitting your changes to be included"
208 msgstr "Enviar cambios para que se incluyan"
209
210 #: ../../../__w/calibre/calibre/manual/develop.rst:103
211 msgid ""
212 "If you only plan to make a few small changes, you can make your changes and "
213 "create a \"merge directive\" which you can then attach to a ticket in the "
214 "calibre `bug tracker <https://bugs.launchpad.net/calibre>`_. To do this, "
215 "make your changes, then run::"
216 msgstr "Si sólo va a hacer algunos pequeños cambios, puede hacer los cambios y crear una «directiva de fusión» que luego puede adjuntar a un informe en el `registro de errores <https://bugs.launchpad.net/calibre>`_. Para ello, realice los cambios y después ejecute::"
217
218 #: ../../../__w/calibre/calibre/manual/develop.rst:111
219 msgid ""
220 "This will create a :file:`my-changes` file in the current folder, simply "
221 "attach that to a ticket on the calibre `bug tracker "
222 "<https://bugs.launchpad.net/calibre>`_. Note that this will include *all* "
223 "the commits you have made. If you only want to send some commits, you have "
224 "to change ``origin/master`` above. To send only the last commit, use::"
225 msgstr "Esto creará un archivo :file:`my-changes` en la carpeta actual, simplemente adjúntelo a un informe en el `registro de errores <https://bugs.launchpad.net/calibre>`_. Tenga en cuenta que esto incluirá *todos* los cambios que haya realizado. Si sólo desea enviar algunos cambios, tendrá que sustituir el ``origin/master`` anterior. Para enviar sólo el último cambio, use::"
226
227 #: ../../../__w/calibre/calibre/manual/develop.rst:119
228 msgid ""
229 "To send the last *n* commits, replace *1* with *n*, for example, for the "
230 "last 3 commits::"
231 msgstr "Para enviar los últimos *n* cambios, sustituya *1* por *n*, por ejemplo, para los últimos 3 cambios::"
232
233 #: ../../../__w/calibre/calibre/manual/develop.rst:124
234 msgid "Be careful to not include merges when using ``HEAD~n``."
235 msgstr "Tenga cuidado de no incluir uniones cuando use ``HEAD~n``."
236
237 #: ../../../__w/calibre/calibre/manual/develop.rst:126
238 msgid ""
239 "If you plan to do a lot of development on calibre, then the best method is "
240 "to create a `GitHub <https://github.com>`__ account. Below is a basic guide "
241 "to setting up your own fork of calibre in a way that will allow you to "
242 "submit pull requests for inclusion into the main calibre repository:"
243 msgstr "Si planea realizar mucho desarrollo en calibre, el mejor método es crear una cuenta en `GitHub <https://github.com>`__. A continuación se muestra una guía básica para la creación de su propia derivación de calibre, de manera que le permitirá presentar una solicitud de colaboración para que se incluya en el repositorio principal de calibre:"
244
245 #: ../../../__w/calibre/calibre/manual/develop.rst:131
246 msgid ""
247 "Setup git on your machine as described in this article: `Setup Git "
248 "<https://help.github.com/articles/set-up-git>`_"
249 msgstr "Configure git en el equipo como se describe en este artículo: `Setup Git <https://help.github.com/articles/set-up-git>`_ (en inglés)"
250
251 #: ../../../__w/calibre/calibre/manual/develop.rst:132
252 msgid ""
253 "Setup ssh keys for authentication to GitHub, as described here: `Generating "
254 "SSH keys <https://help.github.com/articles/generating-ssh-keys>`_"
255 msgstr "Configure las claves SSH para la autenticación con GitHub, como se describe aquí: `Generating SSH keys <https://help.github.com/articles/generating-ssh-keys>`_ (en inglés)"
256
257 #: ../../../__w/calibre/calibre/manual/develop.rst:133
258 msgid ""
259 "Go to https://github.com/kovidgoyal/calibre and click the :guilabel:`Fork` "
260 "button."
261 msgstr "Vaya a https://github.com/kovidgoyal/calibre y pulse en el botón :guilabel:`Fork`."
262
263 #: ../../../__w/calibre/calibre/manual/develop.rst:134
264 msgid "In a Terminal do::"
265 msgstr "En una terminal escriba::"
266
267 #: ../../../__w/calibre/calibre/manual/develop.rst:139
268 msgid ""
269 "Replace <username> above with your GitHub username. That will get your fork "
270 "checked out locally."
271 msgstr "Sustituya el <username> de arriba por su nombre de usuario en GitHub. Esto hará que la derivación se actualice localmente."
272
273 #: ../../../__w/calibre/calibre/manual/develop.rst:140
274 msgid ""
275 "You can make changes and commit them whenever you like. When you are ready "
276 "to have your work merged, do a::"
277 msgstr "Puede hacer cambios y fijarlos siempre que lo desee. Cuando esté listo para que su trabajo se una con el repositorio principal, escriba::"
278
279 #: ../../../__w/calibre/calibre/manual/develop.rst:144
280 msgid ""
281 "and go to ``https://github.com/<username>/calibre`` and click the "
282 ":guilabel:`Pull Request` button to generate a pull request that can be "
283 "merged."
284 msgstr "y vaya a ``https://github.com/<username>/calibre``, pulse en el botón :guilabel:`Pull Request` para generar una solicitud de contribución que pueda ser incluida."
285
286 #: ../../../__w/calibre/calibre/manual/develop.rst:145
287 msgid ""
288 "You can update your local copy with code from the main repo at any time by "
289 "doing::"
290 msgstr "Puede actualizar la copia local con código del repositorio principal en cualquier momento haciendo::"
291
292 #: ../../../__w/calibre/calibre/manual/develop.rst:150
293 msgid ""
294 "You should also keep an eye on the calibre `development forum "
295 "<https://www.mobileread.com/forums/forumdisplay.php?f=240>`_. Before making "
296 "major changes, you should discuss them in the forum or contact Kovid "
297 "directly (his email address is all over the source code)."
298 msgstr "También debe mantener un ojo en el `foro de desarrollo de calibre <https://www.mobileread.com/forums/forumdisplay.php?f=240>`_. Antes de hacer cambios importantes, discútalos en el foro o contacte directamente con Kovid (su dirección de correo electrónico está por todo el código fuente)."
299
300 #: ../../../__w/calibre/calibre/manual/develop.rst:156
301 msgid "Windows development environment"
302 msgstr "Entorno de desarrollo en Windows"
303
304 #: ../../../__w/calibre/calibre/manual/develop.rst:158
305 #: ../../../__w/calibre/calibre/manual/develop.rst:192
306 #: ../../../__w/calibre/calibre/manual/develop.rst:229
307 msgid ""
308 "You must also get the calibre source code separately as described above."
309 msgstr "También debe obtener el código fuente de calibre por separado como se describe anteriormente."
310
311 #: ../../../__w/calibre/calibre/manual/develop.rst:160
312 msgid ""
313 "Install calibre normally, using the `Windows installer <https://calibre-"
314 "ebook.com/download_windows>`__. Then open a Command Prompt and change to the"
315 " previously checked out calibre code folder. For example::"
316 msgstr "Instale calibre normalmente, usando el `instalador de Windows <https://calibre-ebook.com/download_windows>`__. A continuación, abra un símbolo del sistema y vaya a la carpeta del código de calibre previamente descargado. Por ejemplo::"
317
318 #: ../../../__w/calibre/calibre/manual/develop.rst:165
319 #: ../../../__w/calibre/calibre/manual/develop.rst:241
320 msgid "calibre is the folder that contains the src and resources sub-folders."
321 msgstr "``calibre`` es la carpeta que contiene las subcarpetas ``src`` y ``resources``."
322
323 #: ../../../__w/calibre/calibre/manual/develop.rst:167
324 msgid ""
325 "The next step is to set the environment variable ``CALIBRE_DEVELOP_FROM`` to"
326 " the absolute path of the src folder. So, following the example above, it "
327 "would be ``C:\\Users\\kovid\\work\\calibre\\src``. `Here is a short guide "
328 "<https://docs.python.org/using/windows.html#excursus-setting-environment-"
329 "variables>`_ to setting environment variables on Windows."
330 msgstr "El siguiente paso es establecer la variable de entorno ``CALIBRE_DEVELOP_FROM`` a la ruta absoluta de la carpeta ``src``. Siguiendo el ejemplo anterior, sería ``C:\\Users\\Kovid\\work\\calibre\\src``. `He aquí una breve guía <https://docs.python.org/using/windows.html#excursus-setting-environment-variables>`_ (en inglés) para establecer variables de entorno en Windows."
331
332 #: ../../../__w/calibre/calibre/manual/develop.rst:172
333 msgid ""
334 "Once you have set the environment variable, open a new command prompt and "
335 "check that it was correctly set by using the command::"
336 msgstr "Una vez que haya establecido la variable de entorno, abra un nuevo símbolo del sistema y compruebe que se estableció correctamente utilizando la orden::"
337
338 #: ../../../__w/calibre/calibre/manual/develop.rst:177
339 #: ../../../__w/calibre/calibre/manual/develop.rst:260
340 msgid ""
341 "Setting this environment variable means that calibre will now load all its "
342 "Python code from the specified location."
343 msgstr "Al establecer esta variable de entorno, calibre cargará todo su código Python desde la ubicación especificada."
344
345 #: ../../../__w/calibre/calibre/manual/develop.rst:179
346 msgid ""
347 "That's it! You are now ready to start hacking on the calibre code. For "
348 "example, open the file :file:`src\\\\calibre\\\\__init__.py` in your "
349 "favorite editor and add the line::"
350 msgstr "¡Eso es todo! Ya está listo para comenzar a modificar el código de calibre. Por ejemplo, abra el archivo :file:`src\\\\calibre\\\\__init__.py` en su editor favorito y añada la línea::"
351
352 #: ../../../__w/calibre/calibre/manual/develop.rst:184
353 #: ../../../__w/calibre/calibre/manual/develop.rst:267
354 msgid ""
355 "near the top of the file. Now run the command :command:`calibredb`. The very"
356 " first line of output should be ``Hello, world!``."
357 msgstr "cerca del inicio del archivo. Ahora ejecute la orden :command:`calibredb`. La primera línea de salida deberá ser ``Hello, world!``."
358
359 #: ../../../__w/calibre/calibre/manual/develop.rst:186
360 msgid ""
361 "You can also setup a calibre development environment inside the free "
362 "Microsoft Visual Studio, if you like, following the instructions `here "
363 "<https://www.mobileread.com/forums/showthread.php?t=251201>`_."
364 msgstr "También puede configurar un entorno de desarrollo de calibre dentro de Microsoft Visual Studio, si lo desea, siguiendo `estas instrucciones <https://www.mobileread.com/forums/showthread.php?t=251201>`_ (en inglés)."
365
366 #: ../../../__w/calibre/calibre/manual/develop.rst:190
367 msgid "macOS development environment"
368 msgstr "Entorno de desarrollo macOS"
369
370 #: ../../../__w/calibre/calibre/manual/develop.rst:194
371 msgid ""
372 "Install calibre normally using the `provided .dmg <https://calibre-"
373 "ebook.com/download_osx>`__. Then open a Terminal and change to the "
374 "previously checked out calibre code folder, for example::"
375 msgstr "Instale calibre normalmente, usando el `archivo .dmg suministrado <https://calibre-ebook.com/download_osx>`__. A continuación, abra una Terminal y vaya a la carpeta del código de calibre previamente descargado, por ejemplo::"
376
377 #: ../../../__w/calibre/calibre/manual/develop.rst:199
378 msgid ""
379 "calibre is the folder that contains the src and resources sub-folders. The "
380 "calibre command line tools are found inside the calibre app bundle, in "
381 ":file:`/Applications/calibre.app/Contents/MacOS` you should add this folder "
382 "to your PATH environment variable, if you want to run the command line tools"
383 " easily."
384 msgstr "``calibre`` es la carpeta que contiene las subcarpetas ``src`` y ``resources``. Las herramientas de líneas de órdenes de calibre se encuentran en el paquete de la aplicación calibre, en :file:`/Applications/calibre.app/Contents/MacOS`; debe añadir esta carpeta a la variable de entorno PATH si desea ejecutar estas herramientas cómodamente."
385
386 #: ../../../__w/calibre/calibre/manual/develop.rst:205
387 msgid ""
388 "The next step is to create a bash script that will set the environment "
389 "variable ``CALIBRE_DEVELOP_FROM`` to the absolute path of the src folder "
390 "when running calibre in debug mode."
391 msgstr "El siguiente paso es crear un script bash que establezca la variable de entorno ``CALIBRE_DEVELOP_FROM`` a la ruta absoluta de la carpeta ``src`` cuando ejecute calibre en modo de depuración."
392
393 #: ../../../__w/calibre/calibre/manual/develop.rst:208
394 msgid "Create a plain text file::"
395 msgstr "Cree un archivo de texto sencillo::"
396
397 #: ../../../__w/calibre/calibre/manual/develop.rst:214
398 msgid ""
399 "Save this file as :file:`/usr/local/bin/calibre-develop`, then set its "
400 "permissions so that it can be executed::"
401 msgstr "Guarde este archivo como ``/usr/local/bin/calibre-develop``, después configure los permisos para poder ejecutarlo::"
402
403 #: ../../../__w/calibre/calibre/manual/develop.rst:218
404 msgid "Once you have done this, run::"
405 msgstr "Una vez hecho esto, ejecute::"
406
407 #: ../../../__w/calibre/calibre/manual/develop.rst:222
408 msgid ""
409 "You should see some diagnostic information in the Terminal window as calibre"
410 " starts up, and you should see an asterisk after the version number in the "
411 "GUI window, indicating that you are running from source."
412 msgstr "Debería aparecerer alguna información de diagnóstico en la ventana de la terminal mientras calibre se inicia, y debería ver un asterisco después del número de versión en la ventana de la interfaz gráfica, lo que indica que se está ejecutando desde el código fuente."
413
414 #: ../../../__w/calibre/calibre/manual/develop.rst:227
415 msgid "Linux development environment"
416 msgstr "Entorno de desarrollo Linux"
417
418 #: ../../../__w/calibre/calibre/manual/develop.rst:231
419 msgid ""
420 "calibre is primarily developed on Linux. You have two choices in setting up "
421 "the development environment. You can install the calibre binary as normal "
422 "and use that as a runtime environment to do your development. This approach "
423 "is similar to that used in Windows and macOS. Alternatively, you can install"
424 " calibre from source. Instructions for setting up a development environment "
425 "from source are in the INSTALL file in the source tree. Here we will address"
426 " using the binary as a runtime, which is the recommended method."
427 msgstr "calibre está desarrollado principalmente en Linux. Tiene dos opciones para configurar el entorno de desarrollo. Puede instalar el binario de calibre de modo normal y usarlo como un entorno de ejecución para realizar su desarrollo. Este enfoque es similar al que se utiliza en Windows y macOS. Como alternativa, puede instalar calibre a partir del código fuente. Las instrucciones para configurar un entorno de desarrollo a partir del código fuente están en el archivo INSTALL en el árbol de origen. Aquí vamos a tratar el archivo binario como un entorno de ejecución, que es el método recomendado."
428
429 #: ../../../__w/calibre/calibre/manual/develop.rst:237
430 msgid ""
431 "Install calibre using the `binary installer <https://calibre-"
432 "ebook.com/download_linux>`_. Then open a terminal and change to the "
433 "previously checked out calibre code folder, for example::"
434 msgstr "Instale calibre, usando el `instalador binario <https://calibre-ebook.com/download_linux>`__. A continuación, abra una terminal y vaya a la carpeta del código de calibre previamente descargado, por ejemplo::"
435
436 #: ../../../__w/calibre/calibre/manual/develop.rst:243
437 msgid ""
438 "The next step is to set the environment variable ``CALIBRE_DEVELOP_FROM`` to"
439 " the absolute path of the src folder. So, following the example above, it "
440 "would be ``/home/kovid/work/calibre/src``. How to set environment variables "
441 "depends on your Linux distribution and what shell you are using."
442 msgstr "El siguiente paso es establecer la variable de entorno ``CALIBRE_DEVELOP_FROM`` a la ruta absoluta de la carpeta ``src``. Siguiendo el ejemplo anterior, sería ``/home/kovid/work/calibre/src``. La manera de establecer variables de entorno depende de la distribución de Linux y la shell que esté utilizando."
443
444 #: ../../../__w/calibre/calibre/manual/develop.rst:248
445 msgid ""
446 "It is recommended to use the binary installer provided from upstream. Should"
447 " you insist on using a package provided by your distribution, use the "
448 "``CALIBRE_PYTHON_PATH`` and ``CALIBRE_RESOURCES_PATH`` variables instead. "
449 "You can get these by running ``calibre-debug --paths``. But note that "
450 "distribution calibre packages are often terminally broken and are completely"
451 " unsupported."
452 msgstr "Se recomienda usar el instalador binario suministrado en el repositorio oficial. Si insiste en usar un paquete provisto por su distribución, use las variables ``CALIBRE_PYTHON_PATH`` y ``CALIBRE_RESOURCES_PATH``. Puede ver el valor de éstas ejecutando ``calibre-debug --paths``. Pero tenga en cuenta que los paquetes de calibre de las distribuciones a menudo son totalmente inservibles y no se ofrece ayuda para ellos."
453
454 #: ../../../__w/calibre/calibre/manual/develop.rst:255
455 msgid ""
456 "Once you have set the environment variable, open a new terminal and check "
457 "that it was correctly set by using the command::"
458 msgstr "Una vez que haya establecido la variable de entorno, abra una nueva sesión de terminal y compruebe que se ha establecido correctamente usando esta orden::"
459
460 #: ../../../__w/calibre/calibre/manual/develop.rst:262
461 msgid ""
462 "That's it! You are now ready to start hacking on the calibre code. For "
463 "example, open the file :file:`src/calibre/__init__.py` in your favorite "
464 "editor and add the line::"
465 msgstr "¡Eso es todo! Ya está listo para empezar a modificar el código de calibre. Por ejemplo, abra el archivo :file:`src/calibre/__init__.py` en su editor favorito y añada la línea::"
466
467 #: ../../../__w/calibre/calibre/manual/develop.rst:270
468 msgid ""
469 "Having separate \"normal\" and \"development\" calibre installs on the same "
470 "computer"
471 msgstr "Mantener una instalación «normal» y otra de «desarrollo» de calibre en el mismo equipo"
472
473 #: ../../../__w/calibre/calibre/manual/develop.rst:272
474 msgid ""
475 "The calibre source tree is very stable and rarely breaks, but if you feel "
476 "the need to run from source on a separate test library and run the released "
477 "calibre version with your everyday library, you can achieve this easily "
478 "using .bat files or shell scripts to launch calibre. The example below shows"
479 " how to do this on Windows using .bat files (the instructions for other "
480 "platforms are the same, just use a shell script instead of a .bat file)"
481 msgstr "El árbol del código fuente de calibre es muy estable y rara vez se rompe, pero si siente la necesidad de ejecutar a partir del código fuente en una biblioteca de prueba separada y ejecutar la versión oficial de calibre en la biblioteca habitual, puede lograr esto fácilmente usando archivos .bat o scripts de shell para ejectuar calibre. El siguiente ejemplo muestra cómo hacer esto en Windows utilizando archivos .bat (las instrucciones para otras plataformas son las mismas, sólo tiene que utilizar un script de shell en lugar de un archivo .bat)"
482
483 #: ../../../__w/calibre/calibre/manual/develop.rst:277
484 msgid "To launch the release version of calibre with your everyday library:"
485 msgstr "Para ejecutar la versión oficial de calibre con la biblioteca habitual:"
486
487 #: ../../../__w/calibre/calibre/manual/develop.rst:279
488 msgid "calibre-normal.bat::"
489 msgstr "calibre-normal.bat::."
490
491 #: ../../../__w/calibre/calibre/manual/develop.rst:283
492 msgid "calibre-dev.bat::"
493 msgstr "calibre-dev.bat::."
494
495 #: ../../../__w/calibre/calibre/manual/develop.rst:290
496 msgid "Debugging tips"
497 msgstr "Consejos de depuración"
498
499 #: ../../../__w/calibre/calibre/manual/develop.rst:292
500 msgid ""
501 "Python is a dynamically typed language with excellent facilities for "
502 "introspection. Kovid wrote the core calibre code without once using a "
503 "debugger. There are many strategies to debug calibre code:"
504 msgstr "Python es un lenguaje de programación dinámico con excelentes prestaciones para la introspección. Kovid escribió el código central de calibre sin siquiera utilizar un depurador. Hay varias estrategias para depurar el código de calibre:"
505
506 #: ../../../__w/calibre/calibre/manual/develop.rst:297
507 msgid "Using print statements"
508 msgstr "Usar sentencias de impresión"
509
510 #: ../../../__w/calibre/calibre/manual/develop.rst:299
511 msgid ""
512 "This is Kovid's favorite way to debug. Simply insert print statements at "
513 "points of interest and run your program in the terminal. For example, you "
514 "can start the GUI from the terminal as::"
515 msgstr "Ésta es la forma favorita de Kovid para depurar. Basta con insertar sentencias de impresión en los puntos de interés y ejecutar el programa en la terminal. Por ejemplo, puede iniciar la interfaz gráfica desde la terminal como::"
516
517 #: ../../../__w/calibre/calibre/manual/develop.rst:304
518 msgid "Similarly, you can start the E-book viewer as::"
519 msgstr "Del mismo modo, se puede iniciar el visor de libros electrónicos como::"
520
521 #: ../../../__w/calibre/calibre/manual/develop.rst:308
522 msgid "The e-book editor can be started as::"
523 msgstr "El editor de libros electrónicos puede iniciarse como::"
524
525 #: ../../../__w/calibre/calibre/manual/develop.rst:313
526 msgid "Using an interactive Python interpreter"
527 msgstr "Usar un intérprete de Python interactivo"
528
529 #: ../../../__w/calibre/calibre/manual/develop.rst:315
530 msgid ""
531 "You can insert the following two lines of code to start an interactive "
532 "Python session at that point::"
533 msgstr "Puede insertar las siguientes dos líneas de código para iniciar una sesión interactiva de Python en ese punto::"
534
535 #: ../../../__w/calibre/calibre/manual/develop.rst:320
536 msgid ""
537 "When running from the command line, this will start an interactive Python "
538 "interpreter with access to all locally defined variables (variables in the "
539 "local scope). The interactive prompt even has :kbd:`Tab` completion for "
540 "object properties and you can use the various Python facilities for "
541 "introspection, such as :func:`dir`, :func:`type`, :func:`repr`, etc."
542 msgstr "Cuando se ejecuta desde la línea de órdenes, esto iniciará un intérprete interactivo de Python con acceso a todas las variables definidas localmente (variables en el ámbito local). El modo interactivo puede incluso completar con :kbd:`Tab` las propiedades de objetos y puede utilizar las diversas funciones de Python para la introspección, como :func:`dir`, :func:`type`, :func:`repr`, etc."
543
544 #: ../../../__w/calibre/calibre/manual/develop.rst:326
545 msgid "Using the Python debugger as a remote debugger"
546 msgstr "Usar el depurador de Python como un depurador remoto"
547
548 #: ../../../__w/calibre/calibre/manual/develop.rst:328
549 msgid ""
550 "You can use the builtin Python debugger (pdb) as a remote debugger from the "
551 "command line. First, start the remote debugger at the point in the calibre "
552 "code you are interested in, like this::"
553 msgstr "Puede utilizar el depurador incorporado de Python (pdb) como un depurador remoto desde la línea de órdenes. En primer lugar, inicie el depurador remoto en el punto del código de calibre en el que esté interesado, de esta forma::"
554
555 #: ../../../__w/calibre/calibre/manual/develop.rst:335
556 msgid ""
557 "Then run calibre, either as normal, or using one of the calibre-debug "
558 "commands described in the previous section. Once the above point in the code"
559 " is reached, calibre will freeze, waiting for the debugger to connect."
560 msgstr "A continuación ejecute calibre, ya sea en modo normal o usando una de las órdenes de depuración de calibre descritas en la sección anterior. Una vez que se alcanza el punto del código anterior, calibre se detendrá, esperando a que se conecte el depurador."
561
562 #: ../../../__w/calibre/calibre/manual/develop.rst:339
563 msgid ""
564 "Now open a terminal or command prompt and use the following command to start"
565 " the debugging session::"
566 msgstr "Ahora abra una terminal o un símbolo de sistema y utilice el siguiente comando para iniciar la sesión de depuración::"
567
568 #: ../../../__w/calibre/calibre/manual/develop.rst:344
569 msgid ""
570 "You can read about how to use the Python debugger in the `Python stdlib docs"
571 " for the pdb module <https://docs.python.org/library/pdb.html#debugger-"
572 "commands>`_."
573 msgstr "Puede leer acerca de cómo usar el depurador de Python en la `documentación de stdlib de Python para el módulo pdb <https://docs.python.org/library/pdb.html#debugger-commands>`_."
574
575 #: ../../../__w/calibre/calibre/manual/develop.rst:348
576 msgid ""
577 "By default, the remote debugger will try to connect on port 4444. You can "
578 "change it, by passing the port parameter to both the set_trace() and the "
579 "cli() functions above, like this: ``set_trace(port=1234)`` and "
580 "``cli(port=1234)``."
581 msgstr "De forma predeterminada, el depurador remoto intentará conectarse con el puerto 4444. Puede cambiarlo, pasando el parámetro de puerto tanto a la función set_trace() como a cli(), de este modo: ``set_trace(port=1234)`` y ``cli(port=1234)``."
582
583 #: ../../../__w/calibre/calibre/manual/develop.rst:354
584 msgid ""
585 "The Python debugger cannot handle multiple threads, so you have to call "
586 "set_trace once per thread, each time with a different port number."
587 msgstr "El depurador de Python no puede manejar múltiples hilos, así que tiene que llamar set_trace una vez por hilo, cada vez con un número de puerto diferente."
588
589 #: ../../../__w/calibre/calibre/manual/develop.rst:358
590 msgid "Using the debugger in your favorite Python IDE"
591 msgstr "Usar el depurador en su IDE de Python favorito"
592
593 #: ../../../__w/calibre/calibre/manual/develop.rst:360
594 msgid ""
595 "It is possible to use the builtin debugger in your favorite Python IDE, if "
596 "it supports remote debugging. The first step is to add the calibre src "
597 "checkout to the ``PYTHONPATH`` in your IDE. In other words, the folder you "
598 "set as ``CALIBRE_DEVELOP_FROM`` above, must also be in the ``PYTHONPATH`` of"
599 " your IDE."
600 msgstr "Es posible utilizar el depurador incorporado en su IDE de Python favorito, si éste admite depuración remota. El primer paso es añadir la el src de calibre descargado a ``PYTHONPATH`` en el IDE. En otras palabras, la carpeta que habilitó como ``CALIBRE_DEVELOP_FROM`` anteriormente también debe estar en el ``PYTHONPATH`` del IDE`."
601
602 #: ../../../__w/calibre/calibre/manual/develop.rst:365
603 msgid ""
604 "Then place the IDE's remote debugger module into the :file:`src` sub-folder "
605 "of the calibre source code checkout. Add whatever code is needed to launch "
606 "the remote debugger to calibre at the point of interest, for example in the "
607 "main function. Then run calibre as normal. Your IDE should now be able to "
608 "connect to the remote debugger running inside calibre."
609 msgstr "A continuación coloque el módulo depurador remoto del IDE en la subcarpeta :file:`src` del código fuente de calibre. Añada cualquier código que necesite para iniciar el depurador remoto en calibre en el punto de interés, por ejemplo, en la función main. A continuación, ejecute calibre de modo normal. El IDE ahora debería ser capaz de conectar con el depurador remoto ejecutándose dentro de calibre."
610
611 #: ../../../__w/calibre/calibre/manual/develop.rst:372
612 msgid "Executing arbitrary scripts in the calibre Python environment"
613 msgstr "Ejecutar scripts arbitrarios en el entorno Python de calibre"
614
615 #: ../../../__w/calibre/calibre/manual/develop.rst:374
616 msgid ""
617 "The :command:`calibre-debug` command provides a couple of handy switches to "
618 "execute your own code, with access to the calibre modules::"
619 msgstr "La orden :command:`calibre-debug` suministra un par de interruptores útiles para ejecutar su propio código, con acceso a los módulos de calibre::"
620
621 #: ../../../__w/calibre/calibre/manual/develop.rst:379
622 msgid ""
623 "is great for testing a little snippet of code on the command line. It works "
624 "in the same way as the -c switch to the Python interpreter::"
625 msgstr "es ideal para probar un pequeño fragmento de código en la línea de órdenes. Funciona de la misma manera que la opción -c del intérprete de Python::"
626
627 #: ../../../__w/calibre/calibre/manual/develop.rst:383
628 msgid ""
629 "can be used to execute your own Python script. It works in the same way as "
630 "passing the script to the Python interpreter, except that the calibre "
631 "environment is fully initialized, so you can use all the calibre code in "
632 "your script. To use command line arguments with your script, use the form::"
633 msgstr "puede utilizarse para ejecutar su propio script de Python. Funciona de la misma manera que pasar el script por el intérprete de Python, excepto que el entorno de calibre está totalmente inicializado, así que puede utilizar todo el código de calibre en el script. Para utilizar argumentos de línea de órdenes con los scripts utilice la forma::"
634
635 #: ../../../__w/calibre/calibre/manual/develop.rst:388
636 msgid ""
637 "The ``--`` causes all subsequent arguments to be passed to your script."
638 msgstr "El ``--`` hace que todos los argumentos posteriores sean pasados al script."
639
640 #: ../../../__w/calibre/calibre/manual/develop.rst:392
641 msgid "Running the calibre test suite"
642 msgstr "Ejecutar el conjunto de pruebas de calibre"
643
644 #: ../../../__w/calibre/calibre/manual/develop.rst:394
645 msgid "The calibre test suite can be run by::"
646 msgstr "El conjunto de pruebas de calibre puede ejecutarse con::"
647
648 #: ../../../__w/calibre/calibre/manual/develop.rst:400
649 msgid "Using calibre in your projects"
650 msgstr "Usar calibre en sus proyectos"
651
652 #: ../../../__w/calibre/calibre/manual/develop.rst:402
653 msgid ""
654 "It is possible to directly use calibre functions/code in your Python "
655 "project. Two ways exist to do this:"
656 msgstr "Es posible usar directamente las funciones y código de calibre en un proyecto de Python. Existen dos maneras de hacer esto:"
657
658 #: ../../../__w/calibre/calibre/manual/develop.rst:405
659 msgid "Binary install of calibre"
660 msgstr "Instalación binaria de calibre"
661
662 #: ../../../__w/calibre/calibre/manual/develop.rst:407
663 msgid ""
664 "If you have a binary install of calibre, you can use the Python interpreter "
665 "bundled with calibre, like this::"
666 msgstr "Si posee una instalación binaria de calibre, puede utilizar el intérprete de Python incluido con calibre, de esta forma::"
667
668 #: ../../../__w/calibre/calibre/manual/develop.rst:412
669 msgid "Source install on Linux"
670 msgstr "Instalación de código fuente sobre Linux"
671
672 #: ../../../__w/calibre/calibre/manual/develop.rst:414
673 msgid ""
674 "In addition to using the above technique, if you do a source install on "
675 "Linux, you can also directly import calibre, as follows::"
676 msgstr "Además de usar la técnica anterior, si realiza una instalación de código fuente en Linux, también puede importar directamente calibre de la siguiente manera::"
677
678 #: ../../../__w/calibre/calibre/manual/develop.rst:422
679 msgid ""
680 "It is essential that you import the init_calibre module before any other "
681 "calibre modules/packages as it sets up the interpreter to run calibre code."
682 msgstr "Es esencial que importe el módulo init_calibre antes que cualquier otro módulo o paquete de calibre, pues esto configura el intérprete para ejecutar el código de calibre."
683
684 #: ../../../__w/calibre/calibre/manual/develop.rst:426
685 msgid "API documentation for various parts of calibre"
686 msgstr "Documentación de la API de varias partes de calibre"