В архиве имеются следующие скрипты:
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);
Слова в скобках описывают, какими тегами будут выделены новосозданные подписи.
По завершении работы скрипт отображает статистику: сколько всего встретилось картинок, сколько заголовков было заменено на подпись.
Управляемое исправление разрывов абзацев
Иногда в исходнике книги, который приходится использовать для создания 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› также удаляются.
ПС, нужные для того, чтобы секция была валидной, не удаляются при описанных выше действиях скрипта.
За ПС во всех указанных случаях считаются: абзацы, которые из чисто текстового содержимого (не считая тэгов) либо не имеют вообще ничего, либо представляют комбинацию произвольного количества пробелов и неразрывных пробелов; тэги ‹empty-line/›.