FictionBook Editor V 2.6 Руководство - Izekbis

Скрипты 4, 7, 11 и 14 («…с переходом») работают так, что совершаются все перенумерации, создается сноска с пустым телом, а потом в начало этого тела сноски (но после заголовка) перемещается курсор. Бывает удобно вставить текст сноски в буфер обмена, потом запустить скрипт «…с переходом» и сделать paste из буфера.

Скрипты 6, 7, 13 и 14 («Добавление *последней* сноски/комментария…») позволяют добавлять сноску только ниже по документу, чем расположена последняя сноска из уже имеющихся. Данные скрипты не производят перенумерацию ссылок и секций (т. к. при добавлении *последней* сноски в этом нет нужды), за счет чего происходит ускорение работы скрипта. Детали работы этого скрипта, я, честно говоря, сам восстанавливаю в памяти не без труда, если еще чего вспомню, то напишу.

Скрипты 15 и 16 («Унификация… с удалением неиспользуемых секций…») производят унификацию сносок либо комментариев, при этом секции сносок или комментариев, на которые нет ссылок, удаляются.

Примечания и комментарии из скобок v2.2

Бывает так, что в книге примечания сделаны прямо посреди основного текста книги, а не вынесены в отдельные секции в ‹body name="notes"›. В таком случае может быть удобней не переносить примечания в ‹body name="notes"› по одному, а пометить начало и конец каждого примечания (посреди текста книги) последовательностью определенных символов (такая последовательность в рамках письменного и устного общения насчет данного скрипта условно называется «скобкой»), а потом сгенерировать все (корректно оформленные) сноски сразу. Именно для такого случая и сделан данный набор скриптов.

В архиве имеются следующие скрипты:

1. Примечания из [];

2. Примечания из {};

3. Примечания из [!!];

4. Примечания из [~ ~];

5. Примечания из скобок, заданных регэкспами;

6. Примечания из скобок, заданных простым текстом;

7. Комментарии из [];

8. Комментарии из {};

9. Комментарии из [!!];

10. Комментарии из [~ ~]

11. Комментарии из скобок, заданных регэкспами;

12. Комментарии из скобок, заданных простым текстом;

Про разницу между «Примечаниями» и «Комментариями» можно прочитать в описнии скрипта «Добавление сносок и примечаний».

Скрипты 1-4 и 7-10 используют жестко заданные «скобки», какие именно – указано в названиях скриптов (сначала открывающая, а затем закрывающая).

Скрипты 5 и 11 («…из скобок заданных регэкспами») позволяют задать отдельно регэксп для открывающей и закрывающей «скобок», и по этим регэкспам скрипт ищет скобки и извлекает сноски.

Скрипты 6 и 12 («…из скобок, заданных простым текстом») позволяют ввести две строковые последовательности в одном окошке (через пробел), и эти последовательности скрипт при работе будет считать за открывающую и закрывающую скобки.

Начиная с определенной версии, в поисках примечаний скрипт обрабатывает все body, которые есть в книге, причем он просматривает их целиком, выделение текста перед запуском скрипта не учитывается.

Скрипты данного набора имеют такой недостаток, что если внутри многосимвольной «скобки» в тексте книги есть какой-то тег (например, используется скрипт «Примечания из [!!]» и открывающая скобка имеет в fb2 вид [‹emphasis›!), то такая скобка не будет обнаружена скриптом. По этой причине односимвольные «скобки» предпочтительнее многосимвольных. Если вам все же приходится использовать многосимвольные, то после обработки скриптом нужно сделать поиск «скобки» по тексту в режим «Дизайн» (в случае приведенного примера искать нужно [! и!]), подправить случаи, где тег оказался внутри «скобки», и запустить скрипт заново.

Приятной фичей является то, что скрипт умеет извлекать из «скобок» не только однострочные, но и многострочные примечания.

Заголовки картинок в подписи v1.1

Скрипты данного набора создает под всеми картинками документа подпись (не графикой, текстом) на основе текста из атрибута title картинки, после чего этот атрибут удаляется. Перед создаваемой подписью скрипт не вставляет пустую строку, после – вставляет.

В архиве пять скриптов:

1. Заголовок картинки в подпись (strong);

2. Заголовок картинки в подпись (emphasis);

3. Заголовок картинки в подпись (subtitle);

4. Заголовок картинки в подпись (subtitle, strong);

5. Заголовок картинки в подпись (subtitle, emphasis);

Слова в скобках описывают, какими тегами будут выделены новосозданные подписи.

По завершении работы скрипт отображает статистику: сколько всего встретилось картинок, сколько заголовков было заменено на подпись.

Интерактивная ликвидация разрывов абзацев v3.0

Иногда в исходнике книги, который приходится использовать для создания fb2, встречаются разрывы абзацев, запятые вместо точек в конце абзацев (при этом абзац кончается на маленькую букву) и прочие неправильности. Данный скрипт призван решить данную проблему (хотя бы частично). Он просматривает весь документ, анализирует пары абзацев текста, расположенные рядом друг с другом, и проверяет конечные символы первого (считая от начала документа) абзаца и начальные символы второго абзаца каждой такой пары на то, допустимая ли это комбинация.

На первом этапе после запуска скрипта нужно задать настройки, согласно которым будет происходить отлов различных комбинаций конца одного абзаца и начала другого. Настройка «Ручной выбор», если она установлена, предписывает скрипту запоминать пару абзацев с указанной разновидностью комбинации конечных и начальных символов для последующего ручного выбора варианта обработки. В этом случае выбранный в окне предварительных настроек вариант обработки станет вариантом по умолчанию в окне ручной обработки. Если же опция «Ручной выбор» не установлена, для данной комбинации будет происходить автоматическая обработка согласно выбранному варианту.

Нажатие «ОК» запускает второй (неинтерактивный) этап – автоматическую обработку и поиск спорных случаев для ручной обработки. Это может потребовать заметного времени, зависит от размера документа, количества абзацев, количества найденных для ручной обработки случаев и, может, от чего-то еще.

На третьем этапе возникает окно с собранными непонятными случаями. В этом окне отображаются пары абзацев (порой с окружающим их текстом впридачу), и подсвечены символы, из-за которых данная пара абзацев направлена на ручную обработку. И можно, выбрав радиокнопку (круглую кнопку), выбрать вариант исправления данной пары абзацев. Если ваша мышь имеет колесико прокрутки, то крутить колесико и кликать по радиокнопкам достаточно комфортное занятие.

Как разложить файлы скрипта по папкам.

1. js-файл следует разместить в папке скриптов, выбранной в настройках FBE.

2. htm-файлы в подпапке HTML папки редактора, чей exe-файл будете запускать. Создайте эту подпапку, если ее нет.

3. css-файлы в поддиректории CSS каталога редактора, чей exe-файл будете запускать. Под именем «удаление разрывов_main.css» можно подложить main.css от вашего FBE (чтобы текст отображался тем же стилем, что у вас в редакторе). В файле «удаление разрывов_add.css», редактируя строку

ac {background-color: red; color: white;}

можно настроить стиль подсветки (во время третьего этапа) символов, из-за которых пара абзацев направлена на ручную обработку.

Разметка подзаголовков, чистка пустых строк v3.2

Скрипт превращает код вида

‹p›***‹/p›

‹p›* * *‹/p›

‹subtitle›***‹/subtitle›

‹title›‹p›***‹/p›‹/title›

‹title›‹p›* * *‹/p›‹/title›

в

‹subtitle›* * *‹/subtitle›

Вместо трех звездочек в перечисленных случаях может быть и несколько другой текст. Вопрос, стоит ли исходя из вида строки делать ее сабтайтлом, решается с помощью такого регэкспа:

^(|)**((|)*(*))?((|)*(*))?(|)*$

Если объяснять словами, строка может содержать от одной до трех звездочек с любым количеством простых или неразрывных пробелов до, между и после них. Анализируется строка без учета тэгов, т. е. форматирование не влияет.

Пустые строки (далее – ПС) непосредственно перед и непосредственно после подзаголовков (всех) удаляются. В случае с ‹title› разрыв секции перед этим тэгом ликвидируется. По информации от jurgenntа преобразование title – › subtitle может быть опасно для файлов, где используется заголовок (не стиха, а простой) из трех звездочек, чтобы «одноименное» стихотворение попало в оглавление.

Также удаляются тэги ‹empty-line/› в начале и конце секции («в начале» в данном случае значит не только сразу после ‹section›, но и после ‹title›, ‹epigraph› и пр.).

Удаляются ПС перед и после тэгов ‹cite› и ‹poem›.

Последовательности из нескольких ПС заменяются на одну ПС.

Удаляются ПС внутри ‹poem›, т. к. они препятствуют валидности документа. ПС внутри тегов ‹title› также удаляются.

ПС, нужные для того, чтобы секция была валидной, не удаляются при описанных выше действиях скрипта.