Debian Codegraph @

translations/manual/cs/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 # Karel Bartůněk <[email protected]>, 2016
7 # Michal Várady <[email protected]>, 2026
8 # Tomas Michalek <[email protected]>, 2015
9 # Trottel <[email protected]>, 2016-2022,2024-2025
10 # Trottel <[email protected]>, 2016
11 msgid ""
12 msgstr ""
13 "Project-Id-Version: calibre\n"
14 "Report-Msgid-Bugs-To: \n"
15 "POT-Creation-Date: 2026-07-30 18:07+0000\n"
16 "PO-Revision-Date: 2014-06-17 08:34+0000\n"
17 "Last-Translator: Michal Várady <[email protected]>, 2026\n"
18 "Language-Team: Czech (http://app.transifex.com/calibre/calibre/language/cs/)\n"
19 "MIME-Version: 1.0\n"
20 "Content-Type: text/plain; charset=UTF-8\n"
21 "Content-Transfer-Encoding: 8bit\n"
22 "Language: cs\n"
23 "Plural-Forms: nplurals=4; plural=(n == 1 && n % 1 == 0) ? 0 : (n >= 2 && n <= 4 && n % 1 == 0) ? 1: (n % 1 != 0 ) ? 2 : 3;\n"
24
25 #: ../../../__w/calibre/calibre/manual/develop.rst:4
26 msgid "Setting up a calibre development environment"
27 msgstr "Nastavení vývojového prostředí Calibre"
28
29 #: ../../../__w/calibre/calibre/manual/develop.rst:6
30 msgid ""
31 "calibre is completely open source, licensed under the `GNU GPL v3 "
32 "<https://www.gnu.org/licenses/gpl.html>`_. This means that you are free to "
33 "download and modify the program to your heart's content. In this section, "
34 "you will learn how to get a calibre development environment set up on the "
35 "operating system of your choice. calibre is written primarily in `Python "
36 "<https://www.python.org>`_ with some C/C++ code for speed and system "
37 "interfacing. Note that calibre requires at least Python 3.8."
38 msgstr "Calibre je celé open source pod licencí `GNU GPL v3 <https://www.gnu.org/licenses/gpl.html>`_. To znamená, že můžete volně stáhnout a upravit program podle své libosti. V této části se naučíte, jak nastavit vývojové prostředí Calibre na vámi zvoleném operačním systému. Calibre je napsáno převážně v `Pythonu <https://www.python.org>`_ s nějakým kódem C/C++ kvůli rychlosti a systémovému rozhraní. Pamatujte, že Calibre vyžaduje alespoň Python 3.8."
39
40 #: ../../../__w/calibre/calibre/manual/develop.rst:14
41 msgid "Contents"
42 msgstr "Obsah"
43
44 #: ../../../__w/calibre/calibre/manual/develop.rst:17
45 msgid "Design philosophy"
46 msgstr "Filozofie návrhu"
47
48 #: ../../../__w/calibre/calibre/manual/develop.rst:19
49 msgid ""
50 "calibre has its roots in the Unix world, which means that its design is "
51 "highly modular. The modules interact with each other via well defined "
52 "interfaces. This makes adding new features and fixing bugs in calibre very "
53 "easy, resulting in a frenetic pace of development. Because of its roots, "
54 "calibre has a comprehensive command line interface for all its functions, "
55 "documented in :doc:`generated/en/cli-index`."
56 msgstr "Calibre má své kořeny ve světě Unixu, což znamená, že jeho design je vysoce modulární. Moduly se navzájem ovlivňují prostřednictvím dobře definovaných rozhraní. To umožňuje velice snadné přidávání nových funkcí a opravování chyb v Calibre, což má za následek zběsilé tempo vývoje. Vzhledem ke svým kořenům má Calibre komplexní rozhraní příkazového řádku pro všechny své funkce, zdokumentované v :doc:`generated/cs/cli-index`."
57
58 #: ../../../__w/calibre/calibre/manual/develop.rst:24
59 msgid ""
60 "The modular design of calibre is expressed via ``Plugins``. There is a "
61 ":ref:`tutorial <customize>` on writing calibre plugins. For example, adding "
62 "support for a new device to calibre typically involves writing fewer than "
63 "100 lines of code in the form of a device driver plugin. You can browse the "
64 "`built-in drivers "
65 "<https://github.com/kovidgoyal/calibre/tree/master/src/calibre/devices>`_. "
66 "Similarly, adding support for new conversion formats involves writing "
67 "input/output format plugins. Another example of the modular design is the "
68 ":ref:`recipe system <news>` for fetching news. For more examples of plugins "
69 "designed to add features to calibre, see the `Index of plugins "
70 "<https://www.mobileread.com/forums/showthread.php?p=1362767#post1362767>`_."
71 msgstr "Modulární návrh calibre je vyjádřen pomocí ``Plugins``. Pro psaní modulů calibre existuje :ref:`kurz <customize>`. Například přidání podpory nového zařízení do calibre obvykle znamená napsat méně než 100 řádků kódu ve formě modulu ovladače zařízení. Můžete si prohlédnout `vestavěné ovladače <https://github.com/kovidgoyal/calibre/tree/master/src/calibre/devices>`_. Podobně přidání podpory nových převodních formátů znamená napsat moduly vstupního/výstupního formátu. Dalším příkladem modulárního návrhu je :ref:`systém receptů <news>` pro stahování zpráv. Další příklady modulů navržených k přidávání funkcí do calibre najdete v `Indexu modulů <https://www.mobileread.com/forums/showthread.php?p=1362767#post1362767>`_."
72
73 #: ../../../__w/calibre/calibre/manual/develop.rst:34
74 msgid "Code layout"
75 msgstr "Rozložení kódu"
76
77 #: ../../../__w/calibre/calibre/manual/develop.rst:36
78 msgid ""
79 "All the calibre Python code is in the ``calibre`` package. This package "
80 "contains the following main sub-packages"
81 msgstr "Všechen kód Pythonu Calibre je v balíčku ``calibre``. Tento balíček obsahuje následující hlavní podbalíčky"
82
83 #: ../../../__w/calibre/calibre/manual/develop.rst:38
84 msgid ""
85 "devices - All the device drivers. Just look through some of the built-in "
86 "drivers to get an idea for how they work."
87 msgstr "zařízení – Všechny ovladače zařízení. Prohlédněte si některé z vestavěných ovladačů pro získání představy o tom, jak fungují."
88
89 #: ../../../__w/calibre/calibre/manual/develop.rst:40
90 msgid ""
91 "For details, see: ``devices.interface`` which defines the interface "
92 "supported by device drivers and ``devices.usbms`` which defines a generic "
93 "driver that connects to a USBMS device. All USBMS based drivers in calibre "
94 "inherit from it."
95 msgstr "Pro podrobnosti se podívejte na ``devices.interface``, které definuje rozhraní podporované ovladači zařízení, a ``devices.usbms``, které definuje obecný ovladač, který se připojuje k zařízení USBMS. Všechny ovladače v Calibre založené na USBMS se z něj dědí."
96
97 #: ../../../__w/calibre/calibre/manual/develop.rst:43
98 msgid ""
99 "e-books - All the e-book conversion/metadata code. A good starting point is"
100 " ``calibre.ebooks.conversion.cli`` which is the module powering the "
101 ":command:`ebook-convert` command. The conversion process is controlled via "
102 "``conversion.plumber``. The format independent code is all in ``ebooks.oeb``"
103 " and the format dependent code is in ``ebooks.format_name``."
104 msgstr "e-knihy – Všechen kód převodu a metadat e-knih. Vhodným výchozím bodem je balíček ``calibre.ebooks.conversion.cli``, což je modul poháněný příkazem :command:`ebook-convert`. Zpracování převodu je řízeno prostřednictvím ``conversion.plumber``. Kód nezávislý na formátu je všechen ``ebooks.oeb`` a kód závislý na formátu je v ``ebooks.format_name``."
105
106 #: ../../../__w/calibre/calibre/manual/develop.rst:47
107 msgid ""
108 "Metadata reading, writing, and downloading is all in ``ebooks.metadata``"
109 msgstr "Čtení, zápis a stahování jsou v ``ebooks.metadata``"
110
111 #: ../../../__w/calibre/calibre/manual/develop.rst:48
112 msgid ""
113 "Conversion happens in a pipeline, for the structure of the pipeline, see "
114 ":ref:`conversion-introduction`. The pipeline consists of an input plugin, "
115 "various transforms and an output plugin. The code that constructs and drives"
116 " the pipeline is in :file:`plumber.py`. The pipeline works on a "
117 "representation of an e-book that is like an unzipped epub, with manifest, "
118 "spine, toc, guide, html content, etc. The class that manages this "
119 "representation is OEBBook in ``ebooks.oeb.base``. The various "
120 "transformations that are applied to the book during conversions live in "
121 ":file:`oeb/transforms/*.py`. And the input and output plugins live in "
122 ":file:`conversion/plugins/*.py`."
123 msgstr "Převod probíhá v řetězci, pro strukturu řetězce se podívejte na :ref:`conversion-introduction`. Řetězec se skládá ze vstupního modulu, různých transformací a výstupního modulu. Kód, který vytvoří a řídí řetězec se nachází v :file:`plumber.py`. Řetězec funguje na základě zobrazení e-knihy, které je jako rozbalené EPUB, s manifestem, páteří, obsahem, průvodcem, obsahem html atd. Třída, která spravuje toto zobrazení je OEBBook v ``ebooks.oeb.base`. Různé transformace, které jsou použity na knihu během převodu jsou v :file:`oeb/transforms/*.py`. A vstupní a výstupní moduly jsou v :file:`conversion/plugins/*.py`."
124
125 #: ../../../__w/calibre/calibre/manual/develop.rst:58
126 msgid ""
127 "E-book editing happens using a different container object. It is documented "
128 "in :ref:`polish_api`."
129 msgstr "Úprava e-knihy se odehrává pomocí různých objektů kontejneru. To je zdokumentováno v :ref:`polish_api`."
130
131 #: ../../../__w/calibre/calibre/manual/develop.rst:61
132 msgid ""
133 "db - The database back-end. See :ref:`db_api` for the interface to the "
134 "calibre library."
135 msgstr "db – Serverová část databáze. Pro rozhraní do knihovny Calibre se podívejte na :ref:`db_api`."
136
137 #: ../../../__w/calibre/calibre/manual/develop.rst:63
138 msgid "Content server: ``srv`` is the calibre Content server."
139 msgstr "Server s obsahem: ``srv`` je Server s obsahem Calibre."
140
141 #: ../../../__w/calibre/calibre/manual/develop.rst:65
142 msgid ""
143 "gui2 - The Graphical User Interface. GUI initialization happens in "
144 "``gui2.main`` and ``gui2.ui``. The e-book-viewer is in ``gui2.viewer``. The "
145 "e-book editor is in ``gui2.tweak_book``."
146 msgstr "gui2 – Grafické uživatelské rozhraní. Inicializace grafického rozhraní se odehrává v ``gui2.main`` a ``gui2.ui``. Prohlížeč e-knih je v ``gui2.viewer``. Editor e-knih je v ``gui2.tweak_book`."
147
148 #: ../../../__w/calibre/calibre/manual/develop.rst:67
149 msgid ""
150 "If you want to locate the entry points for all the various calibre "
151 "executables, look at the ``entry_points`` structure in `linux.py "
152 "<https://github.com/kovidgoyal/calibre/blob/master/src/calibre/linux.py>`_."
153 msgstr "Pokud chcete najít vstupní body pro všechny jednotlivé spustitelné soubory Calibre, podívejte se na strukturu ``entry_points`` v `linux.py <https://github.com/kovidgoyal/calibre/blob/master/src/calibre/linux.py>`_."
154
155 #: ../../../__w/calibre/calibre/manual/develop.rst:71
156 msgid ""
157 "If you need help understanding the code, post in the `development forum "
158 "<https://www.mobileread.com/forums/forumdisplay.php?f=240>`_ and you will "
159 "most likely get help from one of calibre's many developers."
160 msgstr "Pokud potřebujete pomoct pochopit kód, odešlete příspěvek do `vývojářského fóra <https://www.mobileread.com/forums/forumdisplay.php?f=240>`_ a s největší pravděpodobností získáte pomoc od jednoho z mnoha vývojářů Calibre."
161
162 #: ../../../__w/calibre/calibre/manual/develop.rst:75
163 msgid "Getting the code"
164 msgstr "Získání kódu"
165
166 #: ../../../__w/calibre/calibre/manual/develop.rst:77
167 msgid ""
168 "You can get the calibre source code in two ways, using a version control "
169 "system or directly downloading a :website_base:`tarball <dist/src>`."
170 msgstr "Zdrojový kód Calibre můžete získat dvěma způsoby, pomocí systému řízení verzí nebo přímo stažením :website_base:`tarball <dist/src>`."
171
172 #: ../../../__w/calibre/calibre/manual/develop.rst:80
173 msgid ""
174 "calibre uses `Git <https://www.git-scm.com/>`_, a distributed version "
175 "control system. Git is available on all the platforms calibre supports. "
176 "After installing Git, you can get the calibre source code with the command::"
177 msgstr "Calibre používá `Git <https://www.git-scm.com/>`_, distribuovaný systém řízení verzí. Git je dostupný na všech platformách, které Calibre podporuje. Po nainstalování Gitu, můžete získat zdrojový kód Calibre pomocí příkazu::"
178
179 #: ../../../__w/calibre/calibre/manual/develop.rst:86
180 msgid ""
181 "On Windows you will need the complete path name, that will be something like"
182 " :file:`C:\\\\Program Files\\\\Git\\\\git.exe`."
183 msgstr "Na Windows budete potřebovat úplný název cesty, který bude něco jako :file:`C:\\\\Program Files\\\\Git\\\\git.exe`."
184
185 #: ../../../__w/calibre/calibre/manual/develop.rst:88
186 msgid ""
187 "calibre is a very large project with a very long source control history, so "
188 "the above can take a while (10 mins to an hour depending on your internet "
189 "speed)."
190 msgstr "Calibre je velice rozsáhlý projekt s velmi dlouhou historií řízení zdroje, takže výše uvedené může nějakou dobu trvat (10 minut až hodinu v závislosti na vaší rychlosti internetu)."
191
192 #: ../../../__w/calibre/calibre/manual/develop.rst:91
193 msgid ""
194 "If you want to get the code faster, the source code for the latest release "
195 "is always available as an :website_base:`archive <dist/src>`."
196 msgstr "Pokud chcete získat kód rychleji, zdrojový kód pro nejnovější vydanou verzi je vždy dostupný jako :website_base:`archive <dist/src>`."
197
198 #: ../../../__w/calibre/calibre/manual/develop.rst:94
199 msgid "To update a branch to the latest code, use the command::"
200 msgstr "Pro aktualizaci větve na nejnovější kód použijte příkaz::"
201
202 #: ../../../__w/calibre/calibre/manual/develop.rst:98
203 msgid ""
204 "You can also browse the code at `GitHub "
205 "<https://github.com/kovidgoyal/calibre>`_."
206 msgstr "Také můžete procházet kód na `GitHub <https://github.com/kovidgoyal/calibre>`_."
207
208 #: ../../../__w/calibre/calibre/manual/develop.rst:101
209 msgid "Submitting your changes to be included"
210 msgstr "Odesílání vašich změn, které mají být zahrnuty"
211
212 #: ../../../__w/calibre/calibre/manual/develop.rst:103
213 msgid ""
214 "If you only plan to make a few small changes, you can make your changes and "
215 "create a \"merge directive\" which you can then attach to a ticket in the "
216 "calibre `bug tracker <https://bugs.launchpad.net/calibre>`_. To do this, "
217 "make your changes, then run::"
218 msgstr "Pokud plánujete pouze provést několik malých změn, můžete provést změny a vytvořit \"direktivu sloučení\", kterou pak můžete připojit k oznámení v `přehledu chyb <https://bugs.launchpad.net/calibre>`_ Calibre. Abyste to udělali, proveďte změny, pak spusťte::"
219
220 #: ../../../__w/calibre/calibre/manual/develop.rst:111
221 msgid ""
222 "This will create a :file:`my-changes` file in the current folder, simply "
223 "attach that to a ticket on the calibre `bug tracker "
224 "<https://bugs.launchpad.net/calibre>`_. Note that this will include *all* "
225 "the commits you have made. If you only want to send some commits, you have "
226 "to change ``origin/master`` above. To send only the last commit, use::"
227 msgstr "Tím se vytvoří soubor :file:`my-changes` v aktuální složce, jednoduše ho připojte k oznámení na `přehledu chyb <https://bugs.launchpad.net/calibre>`_ Calibre. Pamatujte, že to bude zahrnovat *všechna* potvrzení změn, které jste provedli. Pokud chcete odeslat pouze některá potvrzení, musíte změnit výše uvedený ``origin/master``. Pro odeslání pouze posledního potvrzení použijte::"
228
229 #: ../../../__w/calibre/calibre/manual/develop.rst:119
230 msgid ""
231 "To send the last *n* commits, replace *1* with *n*, for example, for the "
232 "last 3 commits::"
233 msgstr "Pro odeslání posledních *n* potvrzení nahraďte *1* pomocí *n*, například pro poslední 3 potvrzení::"
234
235 #: ../../../__w/calibre/calibre/manual/develop.rst:124
236 msgid "Be careful to not include merges when using ``HEAD~n``."
237 msgstr "Buďte opatrní, abyste nezahrnuli sloučení, když použijete ``HEAD~n``."
238
239 #: ../../../__w/calibre/calibre/manual/develop.rst:126
240 msgid ""
241 "If you plan to do a lot of development on calibre, then the best method is "
242 "to create a `GitHub <https://github.com>`__ account. Below is a basic guide "
243 "to setting up your own fork of calibre in a way that will allow you to "
244 "submit pull requests for inclusion into the main calibre repository:"
245 msgstr "Pokud máte v plánu udělat hodně vyvíjet Calibre, pak je nejlepší metodou vytvořit si účet na `GitHub <https://github.com>`__. Níže je základní průvodce pro nastavení vaší lastní větve Calibre takovým způsobem, který vám umožní předkládat požadavky o zahrnutí do hlavního úložiště Calibre:"
246
247 #: ../../../__w/calibre/calibre/manual/develop.rst:131
248 msgid ""
249 "Setup git on your machine as described in this article: `Setup Git "
250 "<https://help.github.com/articles/set-up-git>`_"
251 msgstr "Nastavte git ve svém počítači, jak je popsáno v tomto článku: `Set Up Git <https://help.github.com/articles/set-up-git>`_"
252
253 #: ../../../__w/calibre/calibre/manual/develop.rst:132
254 msgid ""
255 "Setup ssh keys for authentication to GitHub, as described here: `Generating "
256 "SSH keys <https://help.github.com/articles/generating-ssh-keys>`_"
257 msgstr "Nastavte klíče ssh pro ověřování na GitHub, jak je popsáno zde: `Generating an SSH key <https://help.github.com/articles/generating-ssh-keys>`_"
258
259 #: ../../../__w/calibre/calibre/manual/develop.rst:133
260 msgid ""
261 "Go to https://github.com/kovidgoyal/calibre and click the :guilabel:`Fork` "
262 "button."
263 msgstr "Přejděte na https://github.com/kovidgoyal/calibre a klikněte na tlačítko :guilabel:`Fork`."
264
265 #: ../../../__w/calibre/calibre/manual/develop.rst:134
266 msgid "In a Terminal do::"
267 msgstr "V terminálu zadejte::"
268
269 #: ../../../__w/calibre/calibre/manual/develop.rst:139
270 msgid ""
271 "Replace <username> above with your GitHub username. That will get your fork "
272 "checked out locally."
273 msgstr "Nahraďte výše uvedené <username> svým uživatelským jménem na GitHub. Tím místně odsouhlasíte svůj fork."
274
275 #: ../../../__w/calibre/calibre/manual/develop.rst:140
276 msgid ""
277 "You can make changes and commit them whenever you like. When you are ready "
278 "to have your work merged, do a::"
279 msgstr "Můžete provádět změny a potvrzovat je, kdykoliv budete chtít. Až budete připraveni sloučit svou práci, zadejte::"
280
281 #: ../../../__w/calibre/calibre/manual/develop.rst:144
282 msgid ""
283 "and go to ``https://github.com/<username>/calibre`` and click the "
284 ":guilabel:`Pull Request` button to generate a pull request that can be "
285 "merged."
286 msgstr "a přejděte na ``https://github.com/<username>/calibre`` a klikněte na tlačítko :guilabel:`Pull Request` pro vygenerování požadavku, který může být sloučen."
287
288 #: ../../../__w/calibre/calibre/manual/develop.rst:145
289 msgid ""
290 "You can update your local copy with code from the main repo at any time by "
291 "doing::"
292 msgstr "Svou lokální kopii můžete kdykoliv aktualizovat kódem z hlavního úložiště zadáním::"
293
294 #: ../../../__w/calibre/calibre/manual/develop.rst:150
295 msgid ""
296 "You should also keep an eye on the calibre `development forum "
297 "<https://www.mobileread.com/forums/forumdisplay.php?f=240>`_. Before making "
298 "major changes, you should discuss them in the forum or contact Kovid "
299 "directly (his email address is all over the source code)."
300 msgstr "Také byste měli dávat pozor na `vývojové fórum <https://www.mobileread.com/forums/forumdisplay.php?f=240>`_ Calibre. Před provedením zásadních změn byste měli o nich diskutovat na fóru nebo se přímo obrátit na Kovida (jeho e-mailová adresa je v celém zdrojovém kódu)."
301
302 #: ../../../__w/calibre/calibre/manual/develop.rst:156
303 msgid "Windows development environment"
304 msgstr "Vývojové prostředí Windows"
305
306 #: ../../../__w/calibre/calibre/manual/develop.rst:158
307 #: ../../../__w/calibre/calibre/manual/develop.rst:192
308 #: ../../../__w/calibre/calibre/manual/develop.rst:229
309 msgid ""
310 "You must also get the calibre source code separately as described above."
311 msgstr "Musíte také získat zdrojový kód Calibre samostatně, jak je popsáno výše."
312
313 #: ../../../__w/calibre/calibre/manual/develop.rst:160
314 msgid ""
315 "Install calibre normally, using the `Windows installer <https://calibre-"
316 "ebook.com/download_windows>`__. Then open a Command Prompt and change to the"
317 " previously checked out calibre code folder. For example::"
318 msgstr "Nainstalujte normálně Calibre pomocí `instalátoru Windows <https://calibre-ebook.com/download_windows>`__. Pak otevřete příkazový řádek a přejděte do dříve odsouhlasené složky s kódem Calibre. Například::"
319
320 #: ../../../__w/calibre/calibre/manual/develop.rst:165
321 #: ../../../__w/calibre/calibre/manual/develop.rst:241
322 msgid "calibre is the folder that contains the src and resources sub-folders."
323 msgstr "calibre je složka, která obsahuje podsložky src a resources."
324
325 #: ../../../__w/calibre/calibre/manual/develop.rst:167
326 msgid ""
327 "The next step is to set the environment variable ``CALIBRE_DEVELOP_FROM`` to"
328 " the absolute path of the src folder. So, following the example above, it "
329 "would be ``C:\\Users\\kovid\\work\\calibre\\src``. `Here is a short guide "
330 "<https://docs.python.org/using/windows.html#excursus-setting-environment-"
331 "variables>`_ to setting environment variables on Windows."
332 msgstr "Dalším krokem je nastavení proměnné prostředí ``CALIBRE_DEVELOP_FROM`` na absolutní cestu složky src. Takže v návaznosti na výše uvedený příklad by to bylo ``C:\\Users\\kovid\\work\\calibre\\src``. `Zde je krátký průvodce <https://docs.python.org/using/windows.html#excursus-setting-environment-variables>`_ k nastavení proměnných prostředí v systému Windows."
333
334 #: ../../../__w/calibre/calibre/manual/develop.rst:172
335 msgid ""
336 "Once you have set the environment variable, open a new command prompt and "
337 "check that it was correctly set by using the command::"
338 msgstr "Jakmile nastavíte proměnnou prostředí, otevřete nový příkazový řádek a zkontrolujte, že je správně nastavena pomocí příkazu::"
339
340 #: ../../../__w/calibre/calibre/manual/develop.rst:177
341 #: ../../../__w/calibre/calibre/manual/develop.rst:260
342 msgid ""
343 "Setting this environment variable means that calibre will now load all its "
344 "Python code from the specified location."
345 msgstr "Nastavení této proměnné prostředí znamená, že Calibre bude nyní načítat všechen svůj kód Pythonu ze zadaného umístění."
346
347 #: ../../../__w/calibre/calibre/manual/develop.rst:179
348 msgid ""
349 "That's it! You are now ready to start hacking on the calibre code. For "
350 "example, open the file :file:`src\\\\calibre\\\\__init__.py` in your "
351 "favorite editor and add the line::"
352 msgstr "A je to! Nyní jste připraveni upravovat kód Calibre. Například otevřete soubor :file:`src\\\\calibre\\\\__init__.py` ve svém oblíbeném editoru a přidejte řádek::"
353
354 #: ../../../__w/calibre/calibre/manual/develop.rst:184
355 #: ../../../__w/calibre/calibre/manual/develop.rst:267
356 msgid ""
357 "near the top of the file. Now run the command :command:`calibredb`. The very"
358 " first line of output should be ``Hello, world!``."
359 msgstr "na začátek souboru. Nyní spusťte příkaz :command:`calibredb`. Úplně první řádek výstupu by měl být ``Hello, world!``."
360
361 #: ../../../__w/calibre/calibre/manual/develop.rst:186
362 msgid ""
363 "You can also setup a calibre development environment inside the free "
364 "Microsoft Visual Studio, if you like, following the instructions `here "
365 "<https://www.mobileread.com/forums/showthread.php?t=251201>`_."
366 msgstr "Pokud chcete, můžete také nastavit vývojové prostředí Calibre uvnitř bezplatného programu Microsoft Visual Studio podle pokynů `zde <https://www.mobileread.com/forums/showthread.php?t=251201>`_."
367
368 #: ../../../__w/calibre/calibre/manual/develop.rst:190
369 msgid "macOS development environment"
370 msgstr "Vývojové prostředí macOS"
371
372 #: ../../../__w/calibre/calibre/manual/develop.rst:194
373 msgid ""
374 "Install calibre normally using the `provided .dmg <https://calibre-"
375 "ebook.com/download_osx>`__. Then open a Terminal and change to the "
376 "previously checked out calibre code folder, for example::"
377 msgstr "Nainstalujte normálně Calibre pomocí `poskytnutého .dmg <https://calibre-ebook.com/download_osx>`__. Pak otevřete terminál a přejděte do dříve odsouhlasené složky s kódem Calibre, například::"
378
379 #: ../../../__w/calibre/calibre/manual/develop.rst:199
380 msgid ""
381 "calibre is the folder that contains the src and resources sub-folders. The "
382 "calibre command line tools are found inside the calibre app bundle, in "
383 ":file:`/Applications/calibre.app/Contents/MacOS` you should add this folder "
384 "to your PATH environment variable, if you want to run the command line tools"
385 " easily."
386 msgstr "calibre je složka, která obsahuje podsložky src a resources. Nástroje příkazového řádku Calibre se nacházejí uvnitř balíčku aplikací Calibre, v :file:`/Applications/calibre.app/Contents/MacOS` byste měli tuto složku přidat do proměnné prostředí PATH, pokud chcete snadno spouštět nástroje příkazového řádku."
387
388 #: ../../../__w/calibre/calibre/manual/develop.rst:205
389 msgid ""
390 "The next step is to create a bash script that will set the environment "
391 "variable ``CALIBRE_DEVELOP_FROM`` to the absolute path of the src folder "
392 "when running calibre in debug mode."
393 msgstr "Dalším krokem je vytvoření bashový skript, který nastaví proměnnou prostředí ``CALIBRE_DEVELOP_FROM`` na absolutní cestu složky src při spuštění Calibre v režimu ladění."
394
395 #: ../../../__w/calibre/calibre/manual/develop.rst:208
396 msgid "Create a plain text file::"
397 msgstr "Vytvořte textový soubor::"
398
399 #: ../../../__w/calibre/calibre/manual/develop.rst:214
400 msgid ""
401 "Save this file as :file:`/usr/local/bin/calibre-develop`, then set its "
402 "permissions so that it can be executed::"
403 msgstr "Uložte tento soubor jako :file:`/usr/bin/calibre-develop`, pak nastavte jeho oprávnění tak, aby mohl být spuštěn::"
404
405 #: ../../../__w/calibre/calibre/manual/develop.rst:218
406 msgid "Once you have done this, run::"
407 msgstr "Jakmile toto uděláte, spusťte::"
408
409 #: ../../../__w/calibre/calibre/manual/develop.rst:222
410 msgid ""
411 "You should see some diagnostic information in the Terminal window as calibre"
412 " starts up, and you should see an asterisk after the version number in the "
413 "GUI window, indicating that you are running from source."
414 msgstr "Měli byste vidět nějaké diagnostické informace v okně terminálu při spuštění Calibre a měli byste vidět hvězdičku za číslem verze v okně grafického rozhraní, která znamená, že spouštíte ze zdrojového kódu."
415
416 #: ../../../__w/calibre/calibre/manual/develop.rst:227
417 msgid "Linux development environment"
418 msgstr "Vývojové prostředí Linux"
419
420 #: ../../../__w/calibre/calibre/manual/develop.rst:231
421 msgid ""
422 "calibre is primarily developed on Linux. You have two choices in setting up "
423 "the development environment. You can install the calibre binary as normal "
424 "and use that as a runtime environment to do your development. This approach "
425 "is similar to that used in Windows and macOS. Alternatively, you can install"
426 " calibre from source. Instructions for setting up a development environment "
427 "from source are in the INSTALL file in the source tree. Here we will address"
428 " using the binary as a runtime, which is the recommended method."
429 msgstr "Calibre je vyvíjeno především na Linuxu. Při nastavování vývojového prostředí máte dvě možnosti. Můžete nainstalovat binární kód Calibre jako normálně a použít ho jako běhové prostředí pro váš vývoj. Tento přístup je podobný tomu použitému ve Windows a macOS. Případně můžete nainstalovat Calibre ze zdrojového kódu. Pokyny pro nastavení vývojového prostředí ze zdrojového kódu jsou v souboru INSTALL ve stromu zdrojového kódu. Zde budeme adresovat pomocí binárního kódu jako běhového prostředí, což je doporučená metoda."
430
431 #: ../../../__w/calibre/calibre/manual/develop.rst:237
432 msgid ""
433 "Install calibre using the `binary installer <https://calibre-"
434 "ebook.com/download_linux>`_. Then open a terminal and change to the "
435 "previously checked out calibre code folder, for example::"
436 msgstr "Nainstalujte Calibre pomocí `instalátoru binárního kódu <https://calibre-ebook.com/download_linux>`_. Pak otevřete terminál a přejděte do dříve odsouhlasené složky s kódem Calibre, například::"
437
438 #: ../../../__w/calibre/calibre/manual/develop.rst:243
439 msgid ""
440 "The next step is to set the environment variable ``CALIBRE_DEVELOP_FROM`` to"
441 " the absolute path of the src folder. So, following the example above, it "
442 "would be ``/home/kovid/work/calibre/src``. How to set environment variables "
443 "depends on your Linux distribution and what shell you are using."
444 msgstr "Dalším krokem je nastavení proměnné prostředí ``CALIBRE_DEVELOP_FROM`` na absolutní cestu složky src. Takže v návaznosti na výše uvedený příklad by to bylo ``/home/kovid/work/calibre/src``. Jak nastavit proměnné prostředí závisí na vaší distribuci Linuxu a jaké prostředí používáte."
445
446 #: ../../../__w/calibre/calibre/manual/develop.rst:248
447 msgid ""
448 "It is recommended to use the binary installer provided from upstream. Should"
449 " you insist on using a package provided by your distribution, use the "
450 "``CALIBRE_PYTHON_PATH`` and ``CALIBRE_RESOURCES_PATH`` variables instead. "
451 "You can get these by running ``calibre-debug --paths``. But note that "
452 "distribution calibre packages are often terminally broken and are completely"
453 " unsupported."
454 msgstr "Je doporučeno použít binární instalační program poskytovaný upstreamem. Pokud trváte na použití balíčku poskytovaného vaší distribucí, použijte místo toho proměnné ``CALIBRE_PYTHON_PATH`` a ``CALIBRE_RESOURCES_PATH``. Tyto proměnné můžete získat spuštěním ``calibre-debug --paths``. Pamatujte však, že distribuční balíčky Calibre jsou často nefunkční a nejsou nijak podporovány."
455
456 #: ../../../__w/calibre/calibre/manual/develop.rst:255
457 msgid ""
458 "Once you have set the environment variable, open a new terminal and check "
459 "that it was correctly set by using the command::"
460 msgstr "Jakmile nastavíte proměnnou prostředí, otevřete nový terminál a zkontrolujte, že je správně nastavena pomocí příkazu::"
461
462 #: ../../../__w/calibre/calibre/manual/develop.rst:262
463 msgid ""
464 "That's it! You are now ready to start hacking on the calibre code. For "
465 "example, open the file :file:`src/calibre/__init__.py` in your favorite "
466 "editor and add the line::"
467 msgstr "A je to! Nyní jste připraveni upravovat kód Calibre. Například otevřete soubor :file:`src/calibre/__init__.py` ve svém oblíbeném editoru a přidejte řádek::"
468
469 #: ../../../__w/calibre/calibre/manual/develop.rst:270
470 msgid ""
471 "Having separate \"normal\" and \"development\" calibre installs on the same "
472 "computer"
473 msgstr "Mít samostatnou „normální“ a „vývojovou“ instalaci Calibre na stejném počítači"
474
475 #: ../../../__w/calibre/calibre/manual/develop.rst:272
476 msgid ""
477 "The calibre source tree is very stable and rarely breaks, but if you feel "
478 "the need to run from source on a separate test library and run the released "
479 "calibre version with your everyday library, you can achieve this easily "
480 "using .bat files or shell scripts to launch calibre. The example below shows"
481 " how to do this on Windows using .bat files (the instructions for other "
482 "platforms are the same, just use a shell script instead of a .bat file)"
483 msgstr "Zdrojový strom Calibre je velice stabilní a zřídka kdy spadne, ale pokud cítíte potřebu spouštět ze zdroje na samostatné zkušební knihovně a spouštět vydanou verzi Calibre se svou každodenní knihovnou, můžete toho snadno dosáhnout pomocí souborů .bat nebo skriptů prostředí pro spuštění Calibre. Níže uvedený příklad ukazuje, jak to provést v systému Windows pomocí souborů .bat (pokyny pro ostatní platformy jsou stejné, stačí použít skript prostředí namísto souboru .bat)"
484
485 #: ../../../__w/calibre/calibre/manual/develop.rst:277
486 msgid "To launch the release version of calibre with your everyday library:"
487 msgstr "Pro spuštění vydané verze Calibre s vaší každodenní knihovnou:"
488
489 #: ../../../__w/calibre/calibre/manual/develop.rst:279
490 msgid "calibre-normal.bat::"
491 msgstr "calibre-normal.bat::"
492
493 #: ../../../__w/calibre/calibre/manual/develop.rst:283
494 msgid "calibre-dev.bat::"
495 msgstr "calibre-dev.bat::"
496
497 #: ../../../__w/calibre/calibre/manual/develop.rst:290
498 msgid "Debugging tips"
499 msgstr "Tipy k ladění"
500
501 #: ../../../__w/calibre/calibre/manual/develop.rst:292
502 msgid ""
503 "Python is a dynamically typed language with excellent facilities for "
504 "introspection. Kovid wrote the core calibre code without once using a "
505 "debugger. There are many strategies to debug calibre code:"
506 msgstr "Python je dynamicky napsaný jazyk s vynikajícím vybavením pro introspekci. Kovid napsal kód jádra Calibre, aniž by jedinkrát použil ladicí program. Existuje mnoho strategií ladění kódu Calibre:"
507
508 #: ../../../__w/calibre/calibre/manual/develop.rst:297
509 msgid "Using print statements"
510 msgstr "Používání příkazů tisku"
511
512 #: ../../../__w/calibre/calibre/manual/develop.rst:299
513 msgid ""
514 "This is Kovid's favorite way to debug. Simply insert print statements at "
515 "points of interest and run your program in the terminal. For example, you "
516 "can start the GUI from the terminal as::"
517 msgstr "Toto je Kovidův oblíbený způsob ladění. Jednoduše vložte příkazy tisku do nejdůležitějších bodů a spusťte program v terminálu. Grafické rozhraní můžete spustit z terminálu například takto::"
518
519 #: ../../../__w/calibre/calibre/manual/develop.rst:304
520 msgid "Similarly, you can start the E-book viewer as::"
521 msgstr "Podobně můžete spustit Prohlížeč e-knih takto::"
522
523 #: ../../../__w/calibre/calibre/manual/develop.rst:308
524 msgid "The e-book editor can be started as::"
525 msgstr "Editor e-knih může být spuštěn takto::"
526
527 #: ../../../__w/calibre/calibre/manual/develop.rst:313
528 msgid "Using an interactive Python interpreter"
529 msgstr "Používání interaktivního překladače Pythonu"
530
531 #: ../../../__w/calibre/calibre/manual/develop.rst:315
532 msgid ""
533 "You can insert the following two lines of code to start an interactive "
534 "Python session at that point::"
535 msgstr "Můžete vložit následující dva řádky kódu pro spuštění interaktivní relace Pythonu v tomto bodě::"
536
537 #: ../../../__w/calibre/calibre/manual/develop.rst:320
538 msgid ""
539 "When running from the command line, this will start an interactive Python "
540 "interpreter with access to all locally defined variables (variables in the "
541 "local scope). The interactive prompt even has :kbd:`Tab` completion for "
542 "object properties and you can use the various Python facilities for "
543 "introspection, such as :func:`dir`, :func:`type`, :func:`repr`, etc."
544 msgstr "Při spuštění z příkazového řádku toto spustí interaktivní překladač Pythonu s přístupem ke všem místně definovaným proměnným (proměnné v místním rozsahu). Interaktivní výzva má dokonce dokončení :kbd:`Tab` pro vlastnosti objektů a můžete použít různé vybavení Pythonu pro introspekci, například :func:`dir`, :func:`type`, :func:`repr`, atd."
545
546 #: ../../../__w/calibre/calibre/manual/develop.rst:326
547 msgid "Using the Python debugger as a remote debugger"
548 msgstr "Používání ladicího programu Pythonu jako vzdáleného ladicího programu"
549
550 #: ../../../__w/calibre/calibre/manual/develop.rst:328
551 msgid ""
552 "You can use the builtin Python debugger (pdb) as a remote debugger from the "
553 "command line. First, start the remote debugger at the point in the calibre "
554 "code you are interested in, like this::"
555 msgstr "Můžete použít vestavěný ladicí program Pythonu (pdb) jako vzdálený ladicí program z příkazového řádku. Nejdříve takto spusťte vzdálený ladicí program v místě v kódu Calibre, které vás zajímá::"
556
557 #: ../../../__w/calibre/calibre/manual/develop.rst:335
558 msgid ""
559 "Then run calibre, either as normal, or using one of the calibre-debug "
560 "commands described in the previous section. Once the above point in the code"
561 " is reached, calibre will freeze, waiting for the debugger to connect."
562 msgstr "Pak spusťte Calibre, a to buď jako normálně, nebo pomocí jednoho z ladicích příkazů Calibre popsaných v předchozím oddílu. Jakmile je dosažen výše uvedený bod v kódu, Calibre se zablokuje a počká na připojení ladicího programu."
563
564 #: ../../../__w/calibre/calibre/manual/develop.rst:339
565 msgid ""
566 "Now open a terminal or command prompt and use the following command to start"
567 " the debugging session::"
568 msgstr "Nyní otevřete terminálu nebo příkazový řádek a použijte následující příkaz pro spuštění relace ladění::"
569
570 #: ../../../__w/calibre/calibre/manual/develop.rst:344
571 msgid ""
572 "You can read about how to use the Python debugger in the `Python stdlib docs"
573 " for the pdb module <https://docs.python.org/library/pdb.html#debugger-"
574 "commands>`_."
575 msgstr "Jak používat ladicí program Pythonu, si můžete přečíst v `dokumentaci stdlib Pythonu pro modul pdb <https://docs.python.org/library/pdb.html#debugger-commands>`_."
576
577 #: ../../../__w/calibre/calibre/manual/develop.rst:348
578 msgid ""
579 "By default, the remote debugger will try to connect on port 4444. You can "
580 "change it, by passing the port parameter to both the set_trace() and the "
581 "cli() functions above, like this: ``set_trace(port=1234)`` and "
582 "``cli(port=1234)``."
583 msgstr "Ve výchozím nastavení se vzdálený ladicí program pokusí připojit na portu 4444. Můžete jej změnit předáním parametru portu výše uvedeným funkcím set_trace() a cli() takto : ``set_trace(port=1234)`` a ``cli(port=1234)``."
584
585 #: ../../../__w/calibre/calibre/manual/develop.rst:354
586 msgid ""
587 "The Python debugger cannot handle multiple threads, so you have to call "
588 "set_trace once per thread, each time with a different port number."
589 msgstr "Ladicí program Pythonu nemůže zpracovat více vláken, takže musíte volat set_trace pro každé vlákno, pokaždé s jiným číslem portu."
590
591 #: ../../../__w/calibre/calibre/manual/develop.rst:358
592 msgid "Using the debugger in your favorite Python IDE"
593 msgstr "Používání ladicího programu ve vašem oblíbeném IDE Pythonu"
594
595 #: ../../../__w/calibre/calibre/manual/develop.rst:360
596 msgid ""
597 "It is possible to use the builtin debugger in your favorite Python IDE, if "
598 "it supports remote debugging. The first step is to add the calibre src "
599 "checkout to the ``PYTHONPATH`` in your IDE. In other words, the folder you "
600 "set as ``CALIBRE_DEVELOP_FROM`` above, must also be in the ``PYTHONPATH`` of"
601 " your IDE."
602 msgstr "Je možné použít vestavěný ladicí program ve vašem oblíbeném IDE Pythonu, pokud podporuje vzdálené ladění. Prvním krokem je přidání rezervační složky src Calibre do ``PYTHONPATH`` ve vašem IDE. Jinými slovy, složka nastavená výše jako ``CALIBRE_DEVELOP_FROM``, musí být také v ``PYTHONPATH`` vašeho IDE."
603
604 #: ../../../__w/calibre/calibre/manual/develop.rst:365
605 msgid ""
606 "Then place the IDE's remote debugger module into the :file:`src` sub-folder "
607 "of the calibre source code checkout. Add whatever code is needed to launch "
608 "the remote debugger to calibre at the point of interest, for example in the "
609 "main function. Then run calibre as normal. Your IDE should now be able to "
610 "connect to the remote debugger running inside calibre."
611 msgstr "Pak umístěte modul vzdáleného ladicího programu IDE do podsložky :file:`src` rezervační složky zdrojového kódu Calibre. Přidejte jakýkoliv potřebný kód pro spuštění vzdáleného ladicího programu do Calibre v důležitém místě, například do hlavní funkce. Pak spusťte Calibre jako normálně. Váš IDE by nyní měl být schopný se připojit ke vzdálenému ladicímu programu běžícímu uvnitř Calibre."
612
613 #: ../../../__w/calibre/calibre/manual/develop.rst:372
614 msgid "Executing arbitrary scripts in the calibre Python environment"
615 msgstr "Provádění libovolných skriptů uvnitř prostření Pythonu Calibre "
616
617 #: ../../../__w/calibre/calibre/manual/develop.rst:374
618 msgid ""
619 "The :command:`calibre-debug` command provides a couple of handy switches to "
620 "execute your own code, with access to the calibre modules::"
621 msgstr "Příkaz :command:`calibre-debug` poskytuje několik šikovných přepínačů pro provádění vašeho kódu s přístupem k modulům Calibre::"
622
623 #: ../../../__w/calibre/calibre/manual/develop.rst:379
624 msgid ""
625 "is great for testing a little snippet of code on the command line. It works "
626 "in the same way as the -c switch to the Python interpreter::"
627 msgstr "je skvělý pro testování malého fragmentu kódu na příkazovém řádku. Funguje to stejným způsobem jako přepínač -c pro překladač Pythonu::"
628
629 #: ../../../__w/calibre/calibre/manual/develop.rst:383
630 msgid ""
631 "can be used to execute your own Python script. It works in the same way as "
632 "passing the script to the Python interpreter, except that the calibre "
633 "environment is fully initialized, so you can use all the calibre code in "
634 "your script. To use command line arguments with your script, use the form::"
635 msgstr "může být použit ke spuštění vašeho skriptu Python. Funguje to stejným způsobem jako předání skriptu překladači Pythonu, kromě toho, že prostředí Calibre je plně inicializované, takže můžete ve svém skriptu použít celý kód Calibre. Pro použití parametrů příkazového řádku s vaším skriptem použijte formulář::"
636
637 #: ../../../__w/calibre/calibre/manual/develop.rst:388
638 msgid ""
639 "The ``--`` causes all subsequent arguments to be passed to your script."
640 msgstr "``--`` způsobí, že všechny následující parametry budou předány do vašeho skriptu."
641
642 #: ../../../__w/calibre/calibre/manual/develop.rst:392
643 msgid "Running the calibre test suite"
644 msgstr "Spuštění sady testů calibre"
645
646 #: ../../../__w/calibre/calibre/manual/develop.rst:394
647 msgid "The calibre test suite can be run by::"
648 msgstr "Sadu testů calibre lze spustit příkazem::"
649
650 #: ../../../__w/calibre/calibre/manual/develop.rst:400
651 msgid "Using calibre in your projects"
652 msgstr "Používání Calibre ve vašich projektech"
653
654 #: ../../../__w/calibre/calibre/manual/develop.rst:402
655 msgid ""
656 "It is possible to directly use calibre functions/code in your Python "
657 "project. Two ways exist to do this:"
658 msgstr "Je možné přímo použít funkce nebo kód Calibre ve vašem projektu v Pythonu. Existují dva způsoby, jak to udělat:"
659
660 #: ../../../__w/calibre/calibre/manual/develop.rst:405
661 msgid "Binary install of calibre"
662 msgstr "Binární instalace Calibre"
663
664 #: ../../../__w/calibre/calibre/manual/develop.rst:407
665 msgid ""
666 "If you have a binary install of calibre, you can use the Python interpreter "
667 "bundled with calibre, like this::"
668 msgstr "Pokud máte binární instalaci Calibre, můžete použít překladač Pythonu nainstalovaný s Calibre takto::"
669
670 #: ../../../__w/calibre/calibre/manual/develop.rst:412
671 msgid "Source install on Linux"
672 msgstr "Zdrojová instalace na Linuxu"
673
674 #: ../../../__w/calibre/calibre/manual/develop.rst:414
675 msgid ""
676 "In addition to using the above technique, if you do a source install on "
677 "Linux, you can also directly import calibre, as follows::"
678 msgstr "Kromě použití výše uvedené techniky, pokud provedete zdrojovou instalaci na Linuxu, můžete také přímo importovat Calibre následujícím způsobem::"
679
680 #: ../../../__w/calibre/calibre/manual/develop.rst:422
681 msgid ""
682 "It is essential that you import the init_calibre module before any other "
683 "calibre modules/packages as it sets up the interpreter to run calibre code."
684 msgstr "Je nezbytné, abyste importovali modul init_calibre před jakýmikoliv jinými moduly nebo balíčky Calibre, protože nastavuje překladač ke spuštění kódu Calibre."
685
686 #: ../../../__w/calibre/calibre/manual/develop.rst:426
687 msgid "API documentation for various parts of calibre"
688 msgstr "Dokumentace API pro různé části Calibre"