Debian Codegraph @

translations/manual/pt/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 # Eduardo Lopes <[email protected]>, 2019-2020
7 # Manuela Silva <[email protected]>, 2016
8 # Paulo Pereira <[email protected]>, 2016,2018-2020,2022,2024-2025
9 msgid ""
10 msgstr ""
11 "Project-Id-Version: calibre\n"
12 "Report-Msgid-Bugs-To: \n"
13 "POT-Creation-Date: 2026-02-17 16:44+0000\n"
14 "PO-Revision-Date: 2014-06-17 08:35+0000\n"
15 "Last-Translator: Paulo Pereira <[email protected]>, 2016,2018-2020,2022,2024-2025\n"
16 "Language-Team: Portuguese (http://app.transifex.com/calibre/calibre/language/pt/)\n"
17 "MIME-Version: 1.0\n"
18 "Content-Type: text/plain; charset=UTF-8\n"
19 "Content-Transfer-Encoding: 8bit\n"
20 "Language: pt\n"
21 "Plural-Forms: nplurals=3; plural=(n == 0 || 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 "Criar os seus próprios plugins para aumentar as funcionalidades do 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 "O Calibre possui um design muito modular. Quase todas as funcionalidades do Calibre existem sob a forma de plugins. Os plugins são usados para conversão, para descarregar notícias (que são chamadas de receitas), em vários componentes da interface de utilizador, para se ligar a dispositivos diferentes, para processar ficheiros ao serem adicionados ao Calibre e assim por diante. Para obter uma lista completa de todos os plugins embutidos no Calibre, aceda a :guilabel:`Preferências-> Avançado-> Plugins`."
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 "Aqui vamos mostrar como criar os seus próprios plugins e adicionar novas funcionalidades ao Calibre"
42
43 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:13
44 msgid "Contents"
45 msgstr "Conteúdos"
46
47 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:15
48 msgid "This only applies to calibre releases >= 0.8.60"
49 msgstr "Isto só se aplica a versões Calibre >= 0.8.60"
50
51 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:18
52 msgid "Anatomy of a calibre plugin"
53 msgstr "Anatomia de um plugin 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 "Um plugin Calibre é muito simples, é apenas um ficheiro ZIP que contém algum código Python e outros recursos, como ficheiros de imagem necessários ao plugin. Sem mais delongas, vamos ver um exemplo 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 "Suponha que você tenha uma instalação de calibre que esteja usando para publicar automaticamente vários documentos eletrônicos nos formatos EPUB e MOBI. Você deseja que todos os arquivos gerados pelo calibre tenham o editor definido como \"Olá, mundo\", veja como fazê-lo. Crie um arquivo chamado: file: `__init __. Py` (este é um nome especial e sempre deve ser usado para o arquivo principal do seu plugin) e insira o seguinte código Python nele:"
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 ""
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 "No macOS, as ferramentas de linha de comando estão dentro do pacote do Calibre. Por exemplo, se instalou o Calibre em :file:`/Applications` as ferramentas de linha de comando estão em :file:`/Applications/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 ""
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 ""
98
99 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:50
100 msgid "A User Interface plugin"
101 msgstr "Um plugin da Interface de utilizador"
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 plugin será espalhado por alguns arquivos (para manter o código limpo). Ele mostrará como obter recursos (imagens ou arquivos de dados) do arquivo ZIP do plug-in, permitir que os usuários configurem seu plug-in, como criar elementos na interface do usuário do calibre e como acessar e consultar o banco de dados de livros no 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 ""
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 "A primeira coisa a observar é que esse arquivo ZIP contém muito mais arquivos, explicados abaixo, e preste atenção ``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 "Um ficheiro de texto vazio usado para permitir a magia do plugin de multi-ficheiros. O ficheiro tem de estar presente em todas os plugins que usam mais do que um ficheiro .py. Deve estar vazio e o seu nome tem de estar na forma: ``plugin-import-name-**some_name**.txt``. A presença deste ficheiro permite-lhe importar código dos ficheiros .py presentes dentro do ficheiro ZIP, usando uma declaração como no exemplo::"
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 ""
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 "O nome que você usa para `` some_name`` entra em um namespace global compartilhado por todos os plugins, ** para torná-lo o mais exclusivo possível **. Mas lembre-se de que deve ser um identificador Python válido (apenas alfabetos, números e sublinhado)"
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 "Tal como anteriormente, o ficheiro que define a classe do plugin"
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 ficheiro contém o código efetivo que faz algo ú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 "Esse ficheiro define a parte da interface do plugin"
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 "O ícone para este plugin"
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 "Um ficheiro de texto com a informação sobre o plugin"
195
196 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:94
197 msgid "**translations**"
198 msgstr "**traduções**"
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 "Uma pasta contendo arquivos ``.mo`` com as traduções da interface do usuário do seu plugin para diferentes idiomas. Veja abaixo os detalhes."
205
206 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:99
207 msgid "Now let's look at the code."
208 msgstr "Agora vamos ver o 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 "Primeiro, o obrigatório ``__init__.py`` para definir os metadados do plugin:"
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 "O único recurso digno de nota é o campo :attr:`actual_plugin`. Como o *Calibre* tem linha de comando e interfaces *GUI*, plug-ins *GUI* como este não devem carregar nenhuma biblioteca *GUI* em ``__init__.py``. O campo ``actual_plugin`` faz isso para você, informando ao *Calibre* que o plugin real deve ser encontrado em outro arquivo dentro do seu arquivo ZIP, que só será carregado em um contexto GUI."
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 "Lembre-se de que, para que isso funcione, você deve ter um arquivo ``plugin-import-name-some_name.txt`` no arquivo ZIP do plugin, conforme discutido acima."
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 "Também existem alguns métodos para habilitar a configuração do plugin pelo usuário. Eles são discutidos abaixo."
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 "Agora vamos dar uma olhada em ``ui.py`` que define o plugin GUI real. O código-fonte é muito comentado e deve ser autoexplicativo:"
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 "A lógica real para implementar a caixa de diálogo das *Interface Plugin Demo*."
258
259 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:136
260 msgid "Getting resources from the plugin ZIP file"
261 msgstr "Obtendo recursos do ficheiro ZIP do plugin"
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 "o sistema de carregamento do plugin do calibre define algumas funções built-in que permitem obter convenientemente os arquivos do arquivo ZIP do plugin."
268
269 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:140
270 msgid "**get_resources(name_or_list_of_names)**"
271 msgstr "**get_resources(name_or_list_of_names)**"
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 ""
284
285 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:150
286 msgid "**get_icons(name_or_list_of_names, plugin_name='')**"
287 msgstr ""
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 ""
298
299 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:160
300 msgid "Enabling user configuration of your plugin"
301 msgstr "Ativar a configuração de utilizador para o seu plugin"
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 que os usuários configurem seu plug-in, você deve definir três métodos em sua classe base de plug-in, **is_customizable()**, **config_widget()** e **save_settings()** conforme mostrado abaixo:"
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 tem muitas maneiras diferentes de armazenar dados de configuração (um legado de sua longa história). A maneira recomendada é usar a classe **JSONConfig**, que armazena suas informações de configuração em um arquivo ``.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 "O código para gerenciar os dados de configuração no plug-in demo está em ``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 "O objeto ``prefs`` agora está disponível em todo o código do plugin por um simples::"
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 "Pode ver o objeto ``prefs`` a ser usado em main.py:"
331
332 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:192
333 msgid "Edit book plugins"
334 msgstr "Editar plugins de livro"
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 ""
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 ""
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 ""
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 ""
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 ""
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 ""
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 ""
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 ""
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 ""
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 ""
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 ""
425
426 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:259
427 msgid "Adding translations to your plugin"
428 msgstr "Adicionar traduções ao seu plugin"
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 ""
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 ""
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 ""
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 ""
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 ""
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 ""
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 ""
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 ""
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 ""
487
488 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:301
489 msgid "The plugin API"
490 msgstr "A API de plugin"
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 ""
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 ""
506
507 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:311
508 msgid "Debugging plugins"
509 msgstr "Depurar plugins"
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 "A primeira e mais importante etapa é executar o Calibre em modo de depuração. Pode fazer isso na linha de comando com::"
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 ""
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 "Ao executar a partir da linha de comando, a saída de depuração será impressa na consola; ao executar a partir do *Calibre*, a saída irá para um ficheiro``.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 "É possível inserir declarações ``print()`` em qualquer lugar do código do plugin, elas serão geradas no modo de depuração. Lembre-se, isso é *Python*, você realmente não precisa de nada além de declarações ``print()`` para depurar ;) Desenvolvi todo o *Calibre* usando apenas esta técnica de depuração."
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 "Você pode testar rapidamente as alterações em seu plug-in usando a seguinte linha de comando::"
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 "Isso desligará o calibre em execução, esperará até que o desligamento seja concluído e, em seguida, atualizará o calibre do plug-in e o reiniciará."
548
549 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:331
550 msgid "More plugin examples"
551 msgstr "Mais exemplos de plugins"
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 ""
558
559 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:336
560 msgid "Sharing your plugins with others"
561 msgstr "Partilhar os seus plugins com outros"
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 "Se você gostaria de compartilhar os plug-ins que criou com outros usuários do calibre, poste seu plug-in em um novo tópico no `fórum de plug-ins do calibre <https://www.mobileread.com/forums/forumdisplay.php?f=237>`_."