Скрипт добавления сноски (и другие)

Предлагаю вниманию пользователей FBW от Alex Saveliev для тестирования (в случае отсутствия багов - для использования) скрипт по добавлению сноски. Первая ссылка для скачивания (по этому адресу буду выкладывать последнюю версию). Вторая ссылка для скачивания (здесь останется версия 1.00), 3 КБ. В FBE, кажется, тоже поддерживаются скрипты, но точно не знаю, т.к. начал сразу с FWB, так что в FBE не тестировал.

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

Что делает скрипт.
1. Добавляет body примечаний, если его нет.
2. Добавляет заголовок body примечаний, если его нет. Если есть - оставляет без изменений.
3. Изменяет ID секций примечаний.
4. Изменяет заголовки секций примечаний.
5. Меняет адреса как сносок, так и простых ссылок, которые указывают на секции примечаний.
6. Меняет текст сносок (у простых ссылок остается как было).
7. Добавляет новую секцию примечаний.
7. Добавляет новую сноску с правильными адресом и текстом.
Кроме этого ничего не делает (если не осталось каких-то ошибок программирования).

Чтобы установить скрипт (в случае FBW), нужно его .js-файл кинуть в подкаталог styles\имя стиля\cmd в папке редактора. Далее запустить (заново, если нужно) редактор и искать пункт «Добавление сноски» в меню «Команды», или как оно называется в вашем стиле.

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

Детали алгоритма. Номер вставляемого примечания определяется по номеру примечания, расположенного перед вставляемым. Остальные не анализируются. Т.е. если вставляем после сноски, связанной с третьей секцией боди примечаний, новая сноска получит номер четыре. Тут я уже упомянул и еще один момент работы скрипта - новые адреса и тексты ссылок генерятся не по порядку их размещения в тексте, а вычисляются по тому, с какими секциями связаны ссылки. Другими словами, связь ссылки и секции сохраняется независимо от порядка их расположения. Это я считаю за фичу. Секции примечаний нумеруются с единицы для первой секции. Заголовки в секции примечаний добавляются независимо от исходного их наличия/отсутствия.

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

Настройки. В начале файла скрипта расположены определения констант, которые задают шаблоны для называния заголовков, для текста ссылок и пр. Соответственно при необходимости их можно поменять. Макрос %N задает номер секции примечания, остальное трактуется как просто текст. Скрипт в кодировке UTF-16 Little Endian. Скрипт должен содержать сигнатуру FFFE первыми байтами файла, иначе FBW не поймет его правильно, так что позаботьтесь об этом, если редактируете файл. Я редактировал в EditPadPro, перед каждым запуском скрипта запуская батник, добавляющий сигнатуру, т.к. EPP у меня ее не сохранял. В настройках же можно включить режим работы скрипта без добавления новой сноски, при этом остальная работа по упорядочению сносок будет произведена.

За предварительное тестирование и советы спасибо jurgennt'у. Он же побуждал меня к работе над скриптом.

Добавлено спустя 6 минут 45 секунд:

Re: Скрипт добавления сноски

По предложения jurgennt'а добавил в архив версию, где добавление сноски отключено (включена только обработка имеющихся сносок).

Браво! Браво! Бис!!! Благодарность

_________________
REB 1100, REB 1200, SE P910i

Очень хорошо!

По поводу UTF-16 - скрипт можно писать и в обычной кодировке, но тогда придется немного помучаться с переводом русских сообщений в UTF-8. Сделать это можно в том же FBW Smile

По мотивам топика "FB Editor - скрипты, вопросы..." сделал скрипт, меняющий регистр букв в выделении на нижний или верхний. По рекомендации GribUser'а работаю через DOM. От vvv взял куски алгоритма и идею использовать в качестве маркеров границ выделения пустые ссылки (оказалось очень удобно так сделать, т.к. для пустых ссылок создаются узлы и тогда не надо анализировать текст). Спасибо за советы, они пригодились.

В отличие от тех скриптов, которые прилагаются к FBW, корректно обрабатывается любая структура документа, тэги при этом не трогаются.

Ссылки для скачивания: 1 (последняя версия) и 2 (версия 1.0), 1.4 Кб.

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

Недостатки. Не обрабатываются entities (символы, задаваемые по коду). Выделение после работы скрипта не сохраняется.

Sclex, респект за скрипты! Отличная работа!

Можно хотелки по сноскам?
1. В БД и ФБД все равно сноски получаются возвратными. Тут Валера никак не хочет уступать. После обработки твоим скриптом после возвратности остается мусор Crying or Very sad

а) <p id="_ftnref1"> в тексте документа осталось, надо на <p> заменить
б) <a l:href="#_ftnref1">[1]</a> в самой сноске надо убрать
по всем номерам сносок, конечно
только там может быть не только ftnref но и endref и еще какие-то похожие варианты. И все это надо убирать нафиг, потому как даже сам БД не умеет корректно работать с им же сделанными фб2.

2. При добавлении новой сноски приходится прыгать в конец документа и обратно. Можно ли сделать чтобы при вставке сноски не просто создавало и нумеровало сноски, а еще и форму для ввода текста предлагало?

3. Хочется подхватывать и конвертить в сноски различные [], {} и т.п. варианты - иногда они полностью пропущены, а иногда быстрее по тексту пробежаться и обрамить сноски [] - а потом сконвертить. Т.е. представь - есть фб2, вычитанный и более-менее отформатированный. Но сноски там оформлены [] - почему-то не сконвертили. Таких файлов в либах есть немало.

Не ругайся на то, что желаний так много - мечты же... Хотелки... Просилки... Wink

_________________
REB 1100, REB 1200, SE P910i

Спасибо! Просто отличные новости с утра Very Happy

Добавлено спустя 1 час 58 минут 1 секунду:

Ну и бог с ним! Все равно изумительно удобно!!!
А по другим моим хотелкам что-нить скажешь?
Типа - будут, не будут, нафиг или еще чего? Wink

_________________
REB 1100, REB 1200, SE P910i

Добавление сноски v1.2. Ссылка 1. Ссылка 2. 4326 б.

Теперь в архиве четыре скрипта. Новый называется "Добавление сноски с переходом". Его особенность в том, что после добавления сноски происходит смещение фокуса видимости в редакторе на секцию новосозданного примечания, т.е. сразу можно набирать текст примечания и видеть его со всем форматированием. Сообщение "обработка закончена" не выводится. jurgennt считает (насчет фокуса), это удобно, может и еще кто-то предпочтет такой способ. Напомню, в FBW вернуться из секции примечания обратно к сссылке сноски можно нажатием Ctrl-Backspace.

И спасибо Alex Saveliev за совет перейти на UTF-8. Так и сделал, что избавило от нужды добавлять сигнатуру в начало – теперь после сохранения файла сразу запуск.

Добавлено спустя 1 час 21 минуту 30 секунд:

Добавление сноски v1.3. Ссылка 1. Ссылка 2. 4333 б.
В предыдущей версии в случае, когда скрипту приходилось создать боди нотесов, заголовок его выглядел как "+strconst5+" (включая кавычки), исправлено.

Добавлено спустя 1 час 22 минуты 56 секунд:

Смена регистра v1.1. Ссылка 1. Ссылка 2. 1394 Б.
Теперь корректно обрабатывается случай, когда начало или конец выделения приходится внутри ссылки. В предыдущей версии получалось, ссылка в такой ситуации разбивалась на части. Предсказуемый результат вставления ссылки внутрь ссылки. Изменил маркер блока с <A id=BlockStart></A> на <B id=BlockStart></B> .

Sclex

Спасибо большое за скрипты, ты даже не представляешь как стало жить легче.
_________________
Все о чтении электронных книг