calibre - en to cs translation catalogue (35 entries)

en: Snippets
cs: Fragmenty

en: The calibre E-book editor supports *snippets*. A snippet is a piece of text that is either re-used often or contains a lot of redundant text. The editor allows you to insert a snippet with only a few key strokes. For example, suppose you often find yourself inserting link tags when editing HTML files, then you can simply type ``<a`` in the editor and press |ct|. The editor will expand it to::
cs: Editor e-knih Calibre podporuje *fragmenty*. Fragment je kus textu, který je buď znovu často použit, nebo obsahuje velké množství nadbytečného textu. Editor vám umožňuje vložit fragment pouhými několika stisky kláves. Předpokládejme například, že zjistíte, že často vkládáte značky odkazů při úpravě souborů HTML, pak můžete jednoduše v editoru napsat ``<a`` a stiskněte |ct|. Editor to rozbalí na::

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link.
cs: Nejen to, slovo ``filename`` bude vybráno a kurzor umístěn nad ním, abyste mohli snadno zadat skutečný název souboru pomocí šikovné funkce editoru :ref:`editor_auto_complete`. A jakmile zadáte název souboru, stiskněte znovu |ct| a kurzor se přesune na pozici mezi značkami ``<a>``, abyste mohli snadno zadat text pro odkaz.

en: The snippets system in the editor is very sophisticated, there are a few built-in snippets and you can create your own to suit your editing style.
cs: Systém fragmentů v editoru je velice propracovaný, je zde několik předdefinovaných fragmentů a můžete vytvářet své vlastní, aby vyhovovali vašemu stylu úprav.

en: The following discussion of the built-in snippets should help illustrate the power of the snippets system.
cs: Následující diskuze o předdefinovaných fragmentech by měla pomoci vysvětlit sílu systému fragmentů.

en: You can also use snippets in the text entry fields in the :guilabel:`Search & replace` panel, however, placeholders (using |ct| to jump around) will not work.
cs: Fragmenty můžete také použít ve vstupních polích textu v panelu :guilabel:`Hledat a nahradit`, zástupné symboly (pomocí |ct| pro přeskakování) však nebudou fungovat.

en: The built-in snippets
cs: Předdefinované fragmenty

en: The built-in snippets are described below. Note that you can override them by creating your own snippets with the same trigger text.
cs: Předdefinované fragmenty jsou popsány níže. Pamatujte, že je můžete přepsat vytvořením svých vlastních fragmentů se stejným textem spouštěče.

en: Inserting filler text [Lorem]
cs: Vkládání výplňového textu [Lorem]

en: The first built-in snippet, and the simplest is used to insert filler text into a document. The filler text is taken from `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ a philosophical work by Cicero (translated to English). To use it simply type ``Lorem`` in an HTML file and press |ct|. It will be replaced by a couple of paragraphs of filler.
cs: První a nejjednodušší předdefinovaný fragment je používán pro vkládání výplňového textu do dokumentu. Výplňový text je brán z `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`, filozofického díla od Cicera (přeloženého do angličtiny). Pro použití jednoduše zadejte ``Lorem`` do souboru HTML a stiskněte |ct|. Bude to nahrazeno několika odstavci výplně.

en: The definition of this snippet is very simple, the trigger text is defined as ``Lorem`` and the template is defined simply as the literal text to be inserted. You can easily customize it to use your favorite form of filler text.
cs: Definice tohoto fragmentu je velice jednoduchá, text spouštěče je definován jako ``Lorem`` a šablona je definována jednoduše jako literární text, který má být vložen. Můžete ho snadno upravit pro použití vámi oblíbené podoby výplňového textu.

en: Inserting a self-closing HTML tag [<>]
cs: Vkládání samouzavírací značky HTML [<>]

en: Now let's look at a simple example of the powerful concept of *placeholders*. Say you want to insert the self-closing tag ``<hr/>``. Just type ``<>``, and press |ct|, the editor will expand the snippet to::
cs: Nyní se podívejme na jednoduchý příklad výkonného konceptu *zástupných symbolů*. Řekněme, že chcete vložit samouzavírací značku  ``<hr/>``. Jednoduše napište ``<>`` a stiskněte |ct|, editor rozbalí fragment na::

en: Here, the ``|`` symbol represents the current cursor position. You can then type ``hr`` and press |ct| to move the cursor to after the end of the tag. This snippet is defined as::
cs: Symbol ``|`` zde představuje aktuální pozici kurzoru. Pak můžete napsat ``hr`` a stisknout |ct| pro přesun kurzoru za konec značky. Fragment je definován jako::

en: Placeholders are simply the dollar ($) sign followed by a number. When the snippet is expanded by pressing |ct| the cursor is positioned at the first placeholder (the placeholder with the lowest number). When you press |ct| again the cursor jumps to the next placeholder (the placeholder with the next higher number).
cs: Zástupné symboly jsou jednoduše symboly dolaru ($) následované číslem. Když je fragment rozbalen stiskem |ct|, kurzor je umístěn na první zástupný symbol (zástupný symbol s nejnižším číslem). Když znovu stisknete |ct|, kurzor přeskočí na další zástupný symbol (zástupný symbol s nejbližším vyšším číslem).

en: Inserting an HTML link tag [<a]
cs: Vkládání značky odkazu HTML [<a]

en: HTML link tags all share a common structure. They have an ``href`` attribute and some text between the opening and closing tags. A snippet to make typing them more efficient will introduce us to some more features of placeholders. To use this snippet, simply type ``<a`` and press |ct|. The editor will expand this to::
cs: Všechny značky odkazů HTML sdílejí společnou strukturu. Mají atribut ``href`` a nějaký text mezi otevíracími a uzavíracími značkami. Fragment, který učiní jejich psaní efektivnějším nás seznámí s některými dalšími funkcemi zástupných symbolů. Pro použití tohoto fragmentu jednoduše napište ``<a``  a stiskněte |ct|. Editor to rozbalí na::

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link. After you are done typing the text, press |ct| again to jump to the point after the closing tag.  This snippet is defined as::
cs: Nejen to, slovo ``filename`` bude vybráno a kurzor umístěn nad ním, abyste mohli snadno zadat skutečný název souboru pomocí šikovné funkce editoru :ref:`editor_auto_complete`. A jakmile zadáte název souboru, stiskněte znovu |ct| a kurzor se přesune na pozici mezi značkami ``<a>``, abyste mohli snadno zadat text pro odkaz. Po dokončení psaní textu stiskněte znovu |ct| pro přeskočení na místo za ukončovací značku. Tento fragment je definován jako::

en: There are a couple of new features here. First the ``$1`` placeholder has become more complex. It now includes some *default text* (the word ``filename``). If a placeholder contains default text, the default text is substituted for the placeholder when the snippet is expanded. Also when you jump to a placeholder with default text using |ct|, the default text is selected. In this way, you can use default text to act as a reminder to you to fill in important parts of the template. You can specify default text for a placeholder by using the syntax: ``${<number>:default text}``.
cs: Zde je pár nových funkcí. Zaprvé se zástupný symbol ``$1`` stal složitějším. Nyní obsahuje nějaký *výchozí text* (slovo ``filename``). Pokud zástupný symbol obsahuje výchozí text, tak výchozí text nahradí zástupný symbol, když je fragment rozbalen. Také když skočíte na zástupný symbol s výchozím textem pomocí |ct|, výchozí text bude vybrán. Tímto způsobem můžete použít výchozí text, aby vám připomenul, abyste vyplnili důležité části šablony. Výchozí text pro zástupný symbol můžete zadat pomocí syntaxe: ``${<number>:výchozí text}``.

en: The other new feature is that the second placeholder has an asterisk after it (``${2*}``). This means that any text that was selected before expanding the template is substituted for the placeholder. To see this in action, select some text in the editor, press |ct|, type ``<a`` and press |ct| again, the template will be expanded to::
cs: Druhou novou funkcí je, že druhý zástupný symbol má za sebou hvězdičku (``${2*}``). To znamená, že jakýkoliv text, který byl vybrán před rozbalením šablony nahradí zástupný symbol. Abyste toto viděli v akci, vyberte v editoru nějaký text, stiskněte |ct|, napište ``<a`` a stiskněte znovu |ct|, šablona se rozbalí na::

en: Inserting a HTML image tag [<i]
cs: Vkládání značky obrázku HTML [<i]

en: This is very similar to inserting an HTML link, as we saw above. It allows you to quickly input an ``<img src="filename" alt="description" />`` tag and jump between the ``src`` and ``alt`` attributes::
cs: Toto je velice podobné vkládání odkazu HTML, což jsme viděli výše. Umožní vám to rychle zadat značku ``<img src="filename" alt="description" />`` a přeskakovat mezi atributy ``src`` a ``alt``::

en: Insert an arbitrary HTML tag [<<]
cs: Vkládání libovolné značky HTML [<<]

en: Type the tag name, for example: ``span`` and press |ct|, that will result in::
cs: Napište název značky, například: ``span``, a stiskněte |ct|, výsledkem bude::

en: You will note that the closing tag has been automatically filled with ``span``. This is achieved with yet another feature of placeholders, *mirroring*. Mirroring simply means that if you specify the sample placeholder more than once in a template, the second and all later positions will be automatically filled in with whatever you type in the first position, when you press |ct|. The definition for this snippet is::
cs: Všimněte si, že do ukončovací značky bylo automaticky vyplněno ``span``. Toho je dosaženo dalšího funkcí zástupných symbolů, *zrcadlením*. Zrcadlení jednoduše znamená, že pokud zadáte do šablony ukázkový zástupný symbol více než jednou, druhá a všechny pozdější pozice budou automaticky vyplní tím, co napíšete do první pozici, když stisknete |ct|. Definice tohoto fragmentu je::

en: As you can see, the first placeholder ($1) has been specified twice, the second time in the closing tag, which will simply copy whatever you type in the opening tag.
cs: Jak můžete vidět, první zástupný symbol ($1) byl zadán dvakrát, podruhé do ukončovací značky, což jednoduše zkopíruje cokoliv, co napíšete do otevírací značky.

en: Inserting an arbitrary HTML tag with a class attribute [<c]
cs: Vkládání libovolné značky HTML s atributem třídy [<c]

en: This is very similar to the insert arbitrary tag example above, except that it assumes that you want to specify a class for the tag::
cs: Toto je velice podobné výše uvedenému příkladu vkládání libovolné značky kromě toho, že se předpokládá, že chcete pro značku zadat třídu::

en: This will allow you to first type the tag name, press |ct|, type the class name, press |ct| type the contents of the tag and press |ct| one last time to jump out of the tag. The closing tag will be auto-filled.
cs: Umožní vám to nejdříve zadat název značky, stiskněte |ct|, zadejte název třídy, stiskněte |ct|, zadejte obsah značky a stiskněte naposledy |ct|, abyste vyskočili ze značky. Ukončovací značka bude vyplněna automaticky.

en: Creating your own snippets
cs: Vytváření vlastních fragmentů

en: Snippets really shine because you can create your own to suit your editing style. To create your own snippets go to :guilabel:`Edit->Preferences->Editor settings->Manage snippets` in the editor. This will pop-up an easy to use dialog to help you create your own snippets. Simply click the :guilabel:`Add snippet` button and you will see a dialog that looks like:
cs: Fragmenty jsou opravdu senzační, protože si můžete vytvořit svůj vlastní, aby vyhovoval vašemu stylu úprav. Abyste vytvořili svůj vlastní fragment, přejděte v editoru do :guilabel:`Úpravy->Předvolby->Nastavení editoru->Spravovat fragmenty`. Objeví se snadno použitelné dialogové okno, které vám pomůže vytvořit si vlastní fragmenty. Jednoduše klikněte na tlačítko :guilabel:`Přidat fragment` a uvidíte dialogové okno, které vypadá takto:

en: The create your own snippets tool
cs: Nástroj pro vytváření vlastních fragmentů

en: First give your snippet a name, something descriptive, to help identify the snippet in the future. Then specify the *trigger*. A trigger is simply the text that you have to type in the editor before pressing |ct| in order to expand the snippet.
cs: Nejdříve svůj fragment pojmenujte, něco popisného, co vám pomůže v budoucnu fragment poznat. Pak zadejte *spouštěč*. Spouštěč je jednoduše text, který musíte zadat v editoru před stisknutím |ct|, aby se rozbalil fragment.

en: Then specify the snippet template. You should start with one of the examples above and modify it to suit your needs. Finally, specify which file types you want the snippet to be active for. This way you can have multiple snippets with the same trigger text that work differently in different file types.
cs: Pak zadejte šablonu fragmentu. Měli byste začít jedním z výše uvedených příkladů a upravit ho podle svých potřeb. Nakonec zadejte, pro které typy souborů chcete, aby byl fragment aktivní. Tímto způsobem můžete mít více fragmentů se stejným spouštěcím textem, které pracují odlišně pro různé typy souborů.

en: The next step is to test your newly created snippet. Use the :guilabel:`Test` box at the bottom. Type in the trigger text and press |ct| to expand the snippet and jump between placeholders.
cs: Dalším krokem je otestovat váš nově vytvořený fragment. Použijte pole :guilabel:`Test` v dolní části. Zadejte spouštěcí text a stiskněte |ct| pro rozbalení fragmentu a přeskočení mezi zástupné symboly.
