calibre - en to uk translation catalogue (36 entries)

en: Snippets
uk: Фрагменти

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::
uk: У редакторі книг calibre передбачено підтримку *фрагментів*. Фрагмент — це шматок тексту, який часто використовується повторно або містить багато зайвого тексту. Редактор надає вам змогу вставляти фрагмент за допомогою натискання певної комбінації клавіш. Наприклад, припустімо, що вам часто доводиться вставляти теґи, коли ви редагуєте файли HTML. Тоді, ви можете просто ввести ``<a`` у редакторі і натиснути |ct|. Редактор розгорне це до такого виразу::

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.
uk: Крім того, буде позначено слово ``filename``, а курсор розташовано над цим словом. Отже, ви зможете одразу почати введення справжньої назви файла, використовуючи чудову можливість :ref:`editor_auto_complete`, яку передбачено у редакторі. Щойно ви завершите введення назви файла, натисніть |ct| ще раз, щоб перевести курсор на позицію між теґами ``<a>`` і почати введення тексту для посилання.

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.
uk: Система фрагментів у редакторі є дуже потужною: передбачено декілька вбудованих фрагментів, ви можете створювати власні фрагменти, які відповідають вашому стилю редагування.

en: The following discussion of the built-in snippets should help illustrate the power of the snippets system.
uk: Наведене нижче обговорення вбудованих фрагментів має допомогти вам зрозуміти потужність системи фрагментів.

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.
uk: Ви також можете використовувати фрагменти у полях для введення тексту на панелі пошуку з заміною. Втім, замінники (з використанням |ct| для переходу) не працюватимуть.

en: The built-in snippets
uk: Вбудовані фрагменти

en: The built-in snippets are described below. Note that you can override them by creating your own snippets with the same trigger text.
uk: Нижче наведено опис вбудованих фрагментів. Зауважте, що ви можете перевизначити ці фрагменти вашими власними фрагментами із тим самим текстом-вмикачем.

en: Inserting filler text [Lorem]
uk: Вставляння тексту-заповнювача [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.
uk: Перший і найпростіший із вбудованих фрагментів призначено для вставляння тексту-заповнювача до документа. Текст-заповнювач запозичено з `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_, філософської роботи Цицерона (перекладеної англійською). Для того, щоб скористатися цим фрагментом, просто введіть ``Lorem`` у файлі HTML і натисніть |ct|. Введене слово буде замінено абзацами тексту-заповнювача.

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.
uk: Визначення цього фрагмента є дуже простим: текст-перемикач визначено як ``Lorem``, шаблон визначено як простий текст, який слід вставити. Вам буде дуже просто налаштувати цей фрагмент відповідно до вашої улюбленої форми тексту-заповнювача.

en: Inserting a self-closing HTML tag [<>]
uk: Вставляння закритого теґу 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::
uk: Тепер, розгляньмо простий приклад потужної концепції *замінників*. Припустімо, ви хочете вставити самозакривний теґ ``<hr/>``. Просто введіть ``<>`` і натисніть |ct|. Редактор розгорне цей фрагмент до такого тексту::

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::
uk: Тут символ ``|`` відповідає поточному розташуванню курсора. Далі, ви можете ввести ``hr`` і натиснути |ct|, щоб пересунути курсор за кінець теґу. Цей фрагмент визначено ось так::

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).
uk: Замінниками є комбінації символу долара ($) із цифрами. Після розгортання фрагмента у відповідь на натискання |ct| курсор спочатку буде розташовано на місці першого замінника (замінника із найменшим номером). Після повторного натискання |ct| курсор буде пересунуто до наступного замінника (замінника із наступним найменшим номером).

en: Inserting an HTML link tag [<a]
uk: Вставити 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::
uk: Усі теґи посилань у HTML мають однакову структуру. У них міститься атрибут ``href`` і якийсь текст між початковим і кінцевим теґами. Фрагмент для ефективного введення теґів посилань познайомить нас із додатковими можливостями замінників. Щоб скористатися цим фрагментом, просто введіть ``<a`` і натисніть |ct|. Редактор розгорне фрагмент до такого::

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::
uk: Крім того, буде позначено слово ``filename``, а курсор розташовано над цим словом. Отже, ви зможете одразу почати введення справжньої назви файла, використовуючи чудову можливість :ref:`editor_auto_complete`, яку передбачено у редакторі. Щойно ви завершите введення назви файла, натисніть |ct| ще раз, щоб перевести курсор на позицію між теґами ``<a>`` і почати введення тексту для посилання. Після завершення введення тексту натисніть клавішу |ct| ще раз, щоб перейти до позиції після кінцевого теґу. Цей фрагмент визначено ось так::

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}``.
uk: Тут ми бачимо ще декілька нових можливостей. По-перше, замінник ``$1`` став складнішим. Тепер він включає деякий *типовий текст* (слово ``filename``). Якщо замінник містить типовий текст, замінник буде заміщено типовим текстом під час розгортання фрагмента. Крім того, під час переходів до замінника із типовим текстом за допомогою натискання клавіші |ct| програма автоматично позначатиме типовий текст. Таким чином, ви можете скористатися типовим текстом як нагадуванням про те, що вам слід заповнити певні важливі місця у шаблоні. Типовий текст для замінника можна вказати за допомогою такої синтаксичної конструкції: ``${<число>:типовий текст}``.

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::
uk: Ще однією новою можливістю є те, що у другому заміннику використано зірочку після цифри (``${2*}``). Цей означає, що замінник у шаблоні буде замінено на будь-який текст, який було позначено до розгортання шаблона. Щоб побачити, як це працює, позначте якийсь фрагмент тексту у редакторі, натисніть клавішу |ct|, введіть ``<a`` і натисніть клавішу |ct| ще раз. Шаблон буде розгорнуто до такого рядка::

en: Inserting a HTML image tag [<i]
uk: Вставити 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::
uk: Цей фрагмент дуже подібний до фрагмента для вставляння посилання HTML, який ми обговорювали вище. Він надає вам змогу швидко ввести теґ ``<img src="filename" alt="description" />`` і здійснювати переходи між атрибутами ``src`` і ``alt``::

en: Insert an arbitrary HTML tag [<<]
uk: Вставити довільний теґ HTML [<<]

en: This allows you to insert an arbitrary full HTML tag (or wrap previously selected text in the tag). To use it, simply type ``<<`` and press |ct|. The editor will expand it to::
uk: Це надасть вам змогу вставити довільний повний теґ HTML (або загорнути позначений текст у теґ). Щоб скористатися цим, просто введіть ``<<`` і натисніть |ct|. Редактор розгорне це до такого виразу::

en: Type the tag name, for example: ``span`` and press |ct|, that will result in::
uk: Введіть назву теґу, наприклад ``span``, і натисніть |ct|. Результат буде таким::

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::
uk: Як бачите, кінцевий теґ автоматично заповнено рядком ``span``. Цього вдалося досягти за допомогою ще однієї можливості замінників — *віддзеркалення*. Віддзеркалення працює так: якщо ви використали замінник у шаблоні декілька разів, другу і усі інші позиції буде автоматично заповнено тим, що ви введете на першій позиції, щойно буде натиснуто клавішу |ct|. Цей фрагмент визначено ось так::

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.
uk: Як ви бачите, перший замінник ($1) було вказано двічі, другий раз у завершальному тезі, де він просто скопіює усе, що ви ввели у початковому тезі.

en: Inserting an arbitrary HTML tag with a class attribute [<c]
uk: Вставляння довільного теґу HTML із атрибутом класу [<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::
uk: Це дуже схоже на наведений вище приклад вставляння довільного теґу, але тут потрібно вказати клас теґу::

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.
uk: Ви зможете спочатку набрати назву теґу, натиснути |ct|, ввести назву класу, натиснути |ct|, ввести вміст теґу і натиснути |ct| востаннє, щоб вийти з теґу. Завершальний теґ буде додано автоматично.

en: Creating your own snippets
uk: Створення ваших власних фрагментів

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:
uk: Фрагменти є дуже корисним елементом редактора, оскільки ви можете створювати власні фрагменти, які відповідають вашому стилю редагування. Для створення фрагментів послідовно скористайтеся пунктами :guilabel:`Зміни -> Налаштування -> Параметри редактора -> Керування фрагментами` у вікні редактора книг. У відповідь буде відкрито просте у користуванні діалогове вікно, яке допоможе вам у створенні ваших фрагментів. Натисніть кнопку :guilabel:`Додати фрагмент`, і програма відкриє ось таке діалогове вікно:

en: The create your own snippets tool
uk: Інструмент створення ваших власних фрагментів

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.
uk: Спочатку надайте вашому фрагменту назву. Назва має бути описовою, такою, яка допоможе вам шукати ваш фрагмент. Далі вкажіть *перемикач*. Перемикачем є текст, який слід набрати у редакторі до натискання |ct|, щоб програма розгорнула його до вашого фрагмента.

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.
uk: Далі вкажіть шаблон фрагмента. Вам слід почати з одного з наведених вище прикладів і внести до нього зміни відповідно до ваших потреб. Нарешті, вкажіть, для яких типів файлів слід активізувати цей фрагмент. Таким чином, ви можете мати декілька фрагментів із однаковими назвами, які будуть працювати по-різному у файлах різних типів.

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.
uk: Наступним кроком є тестування вашого щойно створеного фрагмента. Для тестування скористайтеся полем :guilabel:`Перевірка`, яке розташовано у нижній частині вікна. Введіть текст-перемикач і натисніть |ct|, щоб розгорнути фрагмент і перейти між замінниками.
