Фрагменти

У редакторі calibre передбачено підтримку фрагментів. Фрагмент — це шматок тексту, який часто використовується повторно або містить багато зайвого тексту. Редактор надає вам змогу вставляти фрагмент за допомогою натискання певної комбінації клавіш. Наприклад, припустімо, що вам часто доводиться вставляти теґи, коли ви редагуєте файли HTML. Тоді, ви можете просто ввести <a у редакторі і натиснути Control+J. Редактор розгорне це до такого виразу:

<a href="filename"></a>

Крім того, буде позначено слово filename, а курсор розташовано над цим словом. Отже, ви зможете одразу почати введення справжньої назви файла, використовуючи чудову можливість Автоматичне доповнення, яку передбачено у редакторі. Щойно ви завершите введення назви файла, натисніть Control+J ще раз, щоб перевести курсор на позицію між теґами <a> і почати введення тексту для посилання.

Система фрагментів у редакторі є дуже потужною: передбачено декілька вбудованих фрагментів, ви можете створювати власні фрагменти, які відповідають вашому стилю редагування.

Наведене нижче обговорення вбудованих фрагментів має допомогти вам зрозуміти потужність системи фрагментів.

Примітка

Ви також можете використовувати фрагменти у полях для введення тексту на панелі пошуку з заміною. Втім, замінники (з використанням Control+J для переходу) не працюватимуть.

Вбудовані фрагменти

Нижче наведено опис вбудованих фрагментів. Зауважте, що ви можете перевизначити ці фрагменти вашими власними фрагментами із тим самим текстом-вмикачем.

Вставляння тексту-заповнювача [Lorem]

Перший і найпростіший із вбудованих фрагментів призначено для вставляння тексту-заповнювача до документа. Текст-заповнювач запозичено з De finibus bonorum et malorum, філософської роботи Цицерона (перекладеної англійською). Для того, щоб скористатися цим фрагментом, просто введіть Lorem у файлі HTML і натисніть Control+J. Введене слово буде замінено абзацами тексту-заповнювача.

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

Вставляння закритого теґу HTML [<>]

Тепер, розгляньмо простий приклад потужної концепції замінників. Припустімо, ви хочете вставити самозакривний теґ <hr/>. Просто введіть <> і натисніть Control+J. Редактор розгорне цей фрагмент до такого тексту:

<|/>

Тут символ | відповідає поточному розташуванню курсора. Далі, ви можете ввести hr і натиснути Control+J, щоб пересунути курсор за кінець теґу. Цей фрагмент визначено ось так:

Trigger: <>
Template: <$1/>$2

Замінниками є комбінації символу долара ($) із цифрами. Після розгортання фрагмента у відповідь на натискання Control+J курсор спочатку буде розташовано на місці першого замінника (замінника із найменшим номером). Після повторного натискання Control+J курсор буде пересунуто до наступного замінника (замінника із наступним найменшим номером).

Вставити HTML теґ зображення [<i]

Цей фрагмент дуже подібний до фрагмента для вставляння посилання HTML, який ми обговорювали вище. Він надає вам змогу швидко ввести теґ <img src="filename" alt="description" /> і здійснювати переходи між атрибутами src і alt:

Trigger: <i
Template: <img src="${1:filename}" alt="${2*:description}" />$3

Вставити довільний теґ HTML [<<]

Це надасть вам змогу вставити довільний повний теґ HTML (або загорнути позначений текст у теґ). Щоб скористатися цим, просто введіть << і натисніть Control+J. Редактор розгорне це до такого виразу:

<|></>

Введіть назву теґу, наприклад span, і натисніть Control+J. Результат буде таким:

<span>|</span>

Як бачите, кінцевий теґ автоматично заповнено рядком span. Цього вдалося досягти за допомогою ще однієї можливості замінників — віддзеркалення. Віддзеркалення працює так: якщо ви використали замінник у шаблоні декілька разів, другу і усі інші позиції буде автоматично заповнено тим, що ви введете на першій позиції, щойно буде натиснуто клавішу Control+J. Цей фрагмент визначено ось так:

Trigger: <<
Template: <$1>${2*}</$1>$3

Як ви бачите, перший замінник ($1) було вказано двічі, другий раз у завершальному тезі, де він просто скопіює усе, що ви ввели у початковому тезі.

Вставляння довільного теґу HTML із атрибутом класу [<c]

Це дуже схоже на наведений вище приклад вставляння довільного теґу, але тут потрібно вказати клас теґу:

Trigger: <c
Template: <$1 class="${2:classname}">${3*}</$1>$4

Ви зможете спочатку набрати назву теґу, натиснути Control+J, ввести назву класу, натиснути Control+J, ввести вміст теґу і натиснути Control+J востаннє, щоб вийти з теґу. Завершальний теґ буде додано автоматично.

Створення ваших власних фрагментів

Фрагменти є дуже корисним елементом редактора, оскільки ви можете створювати власні фрагменти, які відповідають вашому стилю редагування. Для створення фрагментів послідовно скористайтеся пунктами Зміни  →  Налаштування  →  Параметри редактора  →  Керування фрагментами у вікні редактора книг. У відповідь буде відкрито просте у користуванні діалогове вікно, яке допоможе вам у створенні ваших фрагментів. Натисніть кнопку Додати фрагмент, і програма відкриє ось таке діалогове вікно:

The create your own snippets tool

Спочатку надайте вашому фрагменту назву. Назва має бути описовою, такою, яка допоможе вам шукати ваш фрагмент. Далі вкажіть перемикач. Перемикачем є текст, який слід набрати у редакторі до натискання Control+J, щоб програма розгорнула його до вашого фрагмента.

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

Наступним кроком є тестування вашого щойно створеного фрагмента. Для тестування скористайтеся полем Перевірка, яке розташовано у нижній частині вікна. Введіть текст-перемикач і натисніть Control+J, щоб розгорнути фрагмент і перейти між замінниками.