calibre - en to ru translation catalogue (36 entries)

en: Snippets
ru: Фрагменты

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::
ru: Редактор 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.
ru: Кроме того, будет выбрано слово ``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.
ru: Система фрагментов в редакторе очень сложна, есть несколько встроенных фрагментов, и вы можете создать свой собственный в соответствии со своим стилем редактирования.

en: The following discussion of the built-in snippets should help illustrate the power of the snippets system.
ru: Следующее обсуждение встроенных фрагментов должно помочь проиллюстрировать мощь системы фрагментов.

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.
ru: Вы также можете использовать фрагменты в полях ввода текста на панели :guilabel:`Search & replace`, однако заполнители (использующие |ct| для перемещения) не будут работать.

en: The built-in snippets
ru: Встроенные фрагменты

en: The built-in snippets are described below. Note that you can override them by creating your own snippets with the same trigger text.
ru: Встроенные фрагменты описаны ниже. Обратите внимание, что вы можете переопределить их, создав собственные фрагменты с тем же текстом триггера.

en: Inserting filler text [Lorem]
ru: Вставка заполнителя текста [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.
ru: Первый встроенный фрагмент и самый простой используется для вставки текста-заполнителя в документ. Текст заполнителя взят из `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.
ru: Определение этого фрагмента очень просто, текст триггера определяется как ``Lorem``, а шаблон определяется просто как текст, который нужно вставить. Вы можете легко настроить его, чтобы использовать вашу любимую форму текста заполнителя.

en: Inserting a self-closing HTML tag [<>]
ru: Вставка самозакрывающегося тега 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::
ru: Теперь давайте рассмотрим простой пример мощной концепции *заполнителей*. Скажем, вы хотите вставить самозакрывающийся тег ``<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::
ru: Здесь символ ``|`` представляет текущую позицию курсора. Затем вы можете набрать ``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).
ru: Заполнители - это просто знак доллара ($), за которым следует число. Когда фрагмент раскрывается нажатием |ct| курсор помещается на первый заполнитель (заполнитель с наименьшим номером). Когда вы нажимаете |ct| снова курсор переходит к следующему заполнителю (заполнителю со следующим большим номером).

en: Inserting an HTML link tag [<a]
ru: Вставить тег ссылка 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::
ru: Все теги 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::
ru: Кроме того, будет выбрано слово ``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}``.
ru: Здесь есть пара новых функций. Сначала заполнитель ``$1`` стал более сложным. Теперь он включает в себя некоторый *текст по умолчанию* (слово ``filename``). Если заполнитель содержит текст по умолчанию, то текст по умолчанию заменяется заполнителем при раскрытии фрагмента. Также при переходе к заполнителю с текстом по умолчанию с помощью |ct| выбирается текст по умолчанию. Таким образом, вы можете использовать текст по умолчанию, чтобы напоминать вам о необходимости заполнения важных частей шаблона. Вы можете указать текст по умолчанию для заполнителя, используя синтаксис: ``${<number>:текст по умолчанию}``.

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::
ru: Другая новая особенность заключается в том, что второй заполнитель имеет звездочку после него (``${2*}``). Это означает, что любой текст, который был выбран перед расширением шаблона, заменяется заполнителем. Чтобы увидеть это в действии, выделите текст в редакторе, нажмите |ct|, введите ``<a`` и нажмите |ct| снова шаблон будет расширен до::

en: Inserting an HTML image tag [<i]
ru: Вставить тег изображение 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::
ru: Это очень похоже на вставку HTML-ссылки, как мы видели выше. Он позволяет быстро вводить тег ``<img src="filename" alt="description" />`` и переходить между атрибутами ``src`` и ``alt``::

en: Insert an arbitrary HTML tag [<<]
ru: Вставить произвольный тег 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|. If you want to wrap selected text, first select the text, press |ct| then type ``<<`` and press |ct| again. The editor will expand it to::
ru: Это позволяет вставлять произвольный полный тег HTML (или переносить ранее выделенный текст в теге). Чтобы использовать его, просто введите ``<<`` и нажмите |ct|. Если вы хотите обернуть выделенный текст, сначала выделите текст и нажмите |ct| затем введите ``<<`` и нажмите |ct| ещё раз. Редактор расширит его до::

en: Type the tag name, for example: ``span`` and press |ct|, that will result in::
ru: Введите имя тега, например: ``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 same 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::
ru: Вы заметите, что закрывающий тег был автоматически заполнен ``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.
ru: Как видите, первый заполнитель ($1) был указан дважды, второй раз в закрывающем теге, который просто скопирует всё, что вы введете в открывающий тег.

en: Inserting an arbitrary HTML tag with a class attribute [<c]
ru: Вставка произвольного тега 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::
ru: Это очень похоже на пример вставки произвольного тега выше, за исключением того, что предполагается, что вы хотите указать класс для тега::

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.
ru: Это позволит вам сначала ввести имя тега, нажать |ct|, ввести имя класса, нажать |ct|, ввести содержимое тега и нажав |ct| в последний раз, выпрыгнуть из тега. Закрывающий тег будет заполнен автоматически.

en: Creating your own snippets
ru: Создание собственных фрагментов

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:
ru: Фрагменты действительно блестящая вещь, потому что вы можете создать свой собственный, для соответствия своему стилю редактирования. Чтобы создать свои собственные фрагменты, перейдите в :guilabel:`Edit-> Preferences-> Settings Editor-> Manage snippets` в редакторе. Появится простой в использовании диалог, который поможет вам создать свои собственные фрагменты. Просто нажмите кнопку :guilabel:`Добавить фрагмент`, и вы увидите диалоговое окно, которое выглядит следующим образом:

en: The create your own snippets tool
ru: Инструмент создания собственных сниппетов

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

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.
ru: Следующим шагом является проверка вашего вновь созданного фрагмента. Используйте поле :guilabel:`Test` внизу. Введите текст триггера и нажмите |ct| чтобы расширить фрагмент и перейти между заполнителями.
