FictionBook Editor V 2.66 Руководство | страница 18



Как использовать скрипт? Нужно стать на позицию в тексте, где должна появиться ссылка на примечание, и запустить скрипт. Остальное делается автоматически.

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

Новые адреса и тексты ссылок генерируются не по порядку их размещения в тексте, а вычисляются по тому, с какими секциями связаны ссылки. Другими словами, связь ссылки и секции сохраняется независимо от порядка их расположения.

Секции примечаний нумеруются с единицы для первой секции.

Заголовки в секции примечаний добавляются независимо от исходного их наличия/отсутствия.

Ограничения. Скрипт не понимает вложенные (более одного уровня вложения) секции в боди примечаний. В случае, если встречаются секции второго или более уровня вложения, скрипт выдаст предупреждающее сообщение и прервет свою работу.

Настройки. В начале файла скрипта расположены определения констант, которые задают шаблоны для называния заголовков, для текста ссылок и пр. Соответственно при необходимости их можно поменять. Макрос %N задает номер секции примечания, остальное трактуется как просто текст.

В данный набор скриптов входят следующие подверсии:

1. Добавление сноски;

2. Обработка сносок;

3. Добавление сноски со вводом;

4. Добавление сноски с переходом;

5. Добавление последней сноски;

6. Добавление последней сноски со вводом;

7. Добавление последней сноски с переходом;

8. Унификация комментария;

9. Унификация комментариев;

10. Добавление комментария со вводом;

11. Добавление комментария с переходом;

12. Добавление последнего комментария;

13. Добавление последнего комментария со вводом;

14. Добавление последнего комментария с переходом;

15. Унификация сносок (с удалением неиспользуемых секций сносок);

16. Унификация комментариев (с удалением неиспользуемых секций комментариев);

Видно, что есть скрипты, которые работают с так называемыми "сносками", а есть которые с "комментариями". Что тут имеется в виду? А имеется тут в виду то, что можно работать одновременно с двумя потоками сносок, различающихся вот чем. Во-первых, "сноски" располагаются в ‹body name="notes"›, а "комментарии" – в ‹body name="comments"›. Во-вторых, текст ссылок-"комментариев" скрипт выделяет тегом ‹sup›, чего не происходит со "сносками". Это нужно для того, чтобы "комментарии" в тех читалках, где нет специальной их поддержки, отображались как верхний индекс. Третье – по умолчанию ссылка "сноски" имеет такой вид: [1], в то время как ссылки "комментариев" оформляются следующим образом: {1}. То есть для "комментариев" используются фигурные скобки, а не квадратные, таким образом можно зрительно различать тип сноски при чтении книги. Четвертое различие состоит в том, что по умолчанию id секций "сносок" имеют вид i_1, а "комментариев" – c_1. Соответственно этому различаются и адреса ссылок.