Как устроена книга

Большинство работ на LibreTimes — один текст: конспект лекции, листок задач, эссе. Книга устроена иначе. Это дерево разделов — томов, частей, глав, — и читают её по одной главе. Эта страница объясняет эту модель, почему она так устроена и что из неё следует для Markdown, который вы пишете внутри. Пошаговые действия — в Напишите книгу.

Дерево, а не один длинный текст

Учебник на пятьсот страниц одним документом Markdown был бы одной огромной страницей: медленно открывается, перемещаться можно только прокруткой, а оглавление приходится выводить из заголовков. Поэтому книга здесь — дерево, узлы которого — разделы:

Анализ
├── Предисловие                    вводная часть, есть текст → страница
├── Часть I. Пределы               часть, текста нет         → навигация
│   ├── 1. Последовательности      глава, есть текст         → страница
│   └── 2. Ряды                    глава, есть текст         → страница
└── Часть II. Производные          часть, текста нет         → навигация
    └── 3. Производная             глава, есть текст         → страница

Раздел с текстом — это страница. Читатель открывает её, читает и переходит к следующей кнопками самой страницы; содержание сбоку показывает, где в книге он находится.

Раздел без текста — это навигация. У части или тома обычно нет своего текста: это заголовок в содержании, объединяющий главы под ним. Если у части есть вступление, дайте ей текст, и она тоже станет страницей.

Содержание — это само дерево, а не то, что вычитано из заголовков, поэтому оно точное и одинаково работает и для романа с пронумерованными главами, и для трактата с томами, частями и параграфами.

Что есть у раздела

У каждого раздела несколько полей, и они намеренно разделены:

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

Один тип группируется иначе. Статья — короткая нумерованная единица внутри главы или части, например нумерованный параграф трактата. Идущие подряд статьи читаются вместе на одной странице, чтобы читателя не отправляли на новую страницу каждые несколько строк, но у каждой статьи остаётся свой адрес.

Адреса, которые не меняются

У каждой страницы книги есть адрес …/read/<n>, где n считает страницы в порядке чтения. Пока книга — черновик, n следует порядку, в котором вы её собираете, и может меняться при каждой правке: на черновик ещё никто не мог сослаться.

С момента первой публикации книги номера закреплены:

• глава сохраняет адрес, когда вы её перемещаете;
• новая глава получает следующий свободный номер, где бы она ни стояла;
• адрес удалённой главы выводится из оборота и никогда не достаётся другой главе.

Так что ссылка на главу — в программе курса или в цитате — продолжает вести на эту главу. Эта устойчивость важнее, чем совпадение n с порядком чтения навсегда, и для порядка как раз есть необязательное поле Адрес: имя вроде I.1 или Предл. 12, которое говорит, где глава стоит в собственной нумерации книги.

Markdown внутри главы

Текст главы — такой же LibreTimes Markdown, как у любой работы. Из того, что это страница книги, следуют три вещи:

• Номер и заголовок главы — заголовок страницы. Разделы текста начинаются с ##, как в любой работе, и главе они редко нужны: структура книги — её дерево, а не заголовки. Заголовки внутри главы — для нумерованных параграфов главы учебника.
• Сноски принадлежат главе. Каждая глава — отдельная страница, поэтому её сноски нумеруются с 1 и собираются в конце этой главы.
• Книжные блоки здесь как дома. Стихи с их переносами и отступами, эпиграфы, посвящения, письма, капитель и номера страниц печатного издания работают в любой работе, но пришли они из книг. См. Стихи, эпиграфы и письма.

То, как набираются абзацы, — свойство всей книги, а не отметка на абзаце: роман можно читать с абзацными отступами и звёздочками по центру на месте разрыва сцены, как набирает печать, а ваш исходник остаётся простыми абзацами и строками ---. Отмечать это на каждом абзаце значило бы разнести одно типографское решение по тысяче мест, где в трёх его могут забыть.

Книга или курс

И то и другое длинное и состоит из частей, так что выбирать стоит осознанно.

• Книга — одна работа с одной строкой авторов, одной ссылкой и одной лицензией. Её главы не публикуются по отдельности и не появляются сами по себе в поиске и в вашем профиле. Выбирайте её для сплошного текста: учебника, монографии, конспектов лекций, переписанных в один текст.
• Курс — коллекция работ, каждая из которых публикуется, находится и цитируется сама по себе: конспект на каждую лекцию, листок задач на каждую неделю. Выбирайте его, когда каждая часть самостоятельна. См. Коллекции.

Переводы книги

Перевод книги — собственное дерево: он начинается как копия содержания оригинала, с теми же типами, номерами, адресами и порядком, но без заголовков и текста, и вы заполняете его глава за главой. До публикации его видят только редакторы книги. Поскольку дерево скопировано, у каждой главы в обоих вариантах один и тот же Адрес, и читатель может перейти от главы к той же главе на другом языке.