Вадим Кузнецов - Описание работы пакета OOoFBTools Создание книг FB2

Пример этого см. в файле-примере ExportToFB21_example-1.odt. Поэкспериментируйте.

Гиперссылки используются для перехода из одного места документа в другое. Конвертер позволяет экспортировать следующие внутренние ссылки:

1. Переход из любого места Документа на любое другое место Документа (текст, Цитаты, Стихи, Заголовки и т. д.).

2. Переход из любого места Документа на любое место в тексте Сноски.

3. Переход с текста любой Сноски на любое место Документа.

4. Переход из текста одной Сноски на текст другой Сноски.

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

Для задания внутренних ссылок (переходов) необходимо сделать следующее:

1. На абзац, КУДАнужно перейти, ставим закладку.

Например, для Текста Сноски (на картинке на эту сноску указывает красная стрелка):

Ставим курсор а начало абзаца, вызываем диалог Закладка(меню Вставка-›Закладка…). Задаем там нужное имя закладки, жмем Ok:

2. В абзаце, ОТКУДАнужно перейти, выделяем слово или словосочетание-переход, и форматируем его, как гиперссылку (меню Вставка-›Гиперссылка). В открывшемся диалоге для Документавыбираем Цель– Закладки, а там – нужную закладку для абзаца КУДА. Жмем Применить, закрываем диалог Цели, жмем Применить, закрываем диалог Гиперссылки.

Все!

Мы не будем описывать здесь всю схему FictionBook2.1, а только те моменты, которые очень важны для правильной разметки структурыконвертируемого документа. Лишь в случае правильной разметки структуры экспорт произойдет без единой ошибки и править в полученном fb2 документе вообще ничего не надо будет, за исключение моментов, описанных в п. 5.

Итак, что такое "правильная" разметка структуры? Когда мы придаем отдельным абзацам определенные стили (поэма, цитата, заголовок (уровень), аннотация и т. д.) мы формируем структуру документа. А эта структура должна соответствовать схеме FictionBook2.1. Иначе документ сконвертируется, но валидацию не пройдет. Например: в книгах часто идет аннотация, а потом – эпиграф . Но, согласно схеме FictionBook2.1 должно быть наоборот – сначала эпиграф, а потом – аннотация . Если вы сделаете как в книге, а не по схеме – документ будет невалидный , и online-библиотеки, если не ошибаюсь, его не примут .

А теперь чуть подробнее.

Структуру документа, условно, можно разбить на два блока: 1. От названия книги и до самого первого заголовка (части, раздела) – мы называем это "Уровнем". 2. От этого самого первого заголовка и до конца документа. В этих двух блоках обрамление текста тэгами ‹section› несколько отличается.

В 1-м блоке самым первым элементов должен быть Эпиграф, если он нужен. За ним могут идти еще несколько Эпиграфов, если они нужны, потом – Картинка, если она нужна, потом – Аннотация, если она нужна. При этом междувсеми этими элементами не должно быть ни одной пустой строки! Иначе документ получится невалидным.

Теперь могут идти следующие элементы структуры в любом порядке: Просто абзац текста, пустая строка, Поэма, Цитата, Подзаголовок (SubTitle), Таблица, Картинка Схематично все это можно представить так (в квадратные скобки [] взяты необязательные элементы, в круглые () – названия стилей для создания структуры документов, жирнымвыделены элементы, которых может быть любое количество ), синим цветом – элементы, которые могут идти в любом порядке :

Во 2-м блоке дело обстоит немного по – другому.

2-й блок начинается с самого первого Уровня – Части книги, Раздела книги или просто заголовка. Уровней заголовков может быть 10 (стиль Level 1… Level 10) (хотя программно можно очень легко их увеличить хоть до бесконечности – особенность алгоритма). В книге может быть такая структура: