Стихи, эпиграфы и письма

Большая часть LibreTimes Markdown выросла из математики и преподавания. Эти блоки пришли из книг: стихотворение, где важны переносы строк, эпиграф над главой, письмо внутри романа, номера страниц печатного издания. Работают они в любом документе, не только в книге.

Правило за ними то же, что у всего диалекта: разметка говорит, чем является отрывок, а как он выглядит, решает страница. Вы не задаёте шрифт, кегль или поля – вы говорите «это стихи» или «это эпиграф», и всюду, где появляется текст (на странице, в экспорте, в программе чтения с экрана), с ним обращаются соответственно.

Стихи

В обычном тексте одиночный перенос строки ничего не значит: абзац переформатируется. В стихах единица – строка, поэтому внутри :::verse каждая строка остаётся строкой, а пустая строка разделяет строфы:

:::verse
Мороз и солнце; день чудесный!
Ещё ты дремлешь, друг прелестный --
Пора, красавица, проснись:
 
Открой сомкнуты негой взоры
Навстречу северной Авроры,
Звездою севера явись!
:::

Строки с отступом

Отступ в стихотворении несёт смысл: схему рифмовки, размер, смену говорящего. В стихах – и только в них – ведущие пробелы сохраняются. Каждые два пробела – один уровень отступа, не больше трёх уровней. Пример – лимерик Эдварда Лира в оригинале:

:::verse
There was an Old Man with a beard,
Who said, 'It is just as I feared!
  Two Owls and a Hen,
  Four Larks and a Wren,
Have all built their nests in my beard!'
:::

• Пробелы, не табуляция, и считайте парами: два пробела – уровень 1, четыре – уровень 2, шесть – уровень 3. Глубже – всё равно уровень 3.
• Вне :::verse ведущие пробелы ничего не значат (а четыре начинают блок кода), так что это работает только внутри блока.
• Оформление внутри строки работает как обычно: курсив, формулы, ссылки.
• Строка, не помещающаяся на экран, переносится с висячим отступом, так что перенос никогда не спутать с новой строкой.

Эпиграф

Эпиграф – цитата в начале главы или документа, задающая тон всему, что дальше:

:::epigraph
Все счастливые семьи похожи друг на друга, каждая несчастливая семья
несчастлива по-своему.
 
--- Л. Н. Толстой, «Анна Каренина»
:::

Это не цитата. Цитата – чужие слова внутри вашего рассуждения, эпиграф стоит вне его. Подпись пишется обычным текстом ровно так, как её нужно показать.

Посвящение

:::dedication
Моим учителям
:::

Посвящение стоит особняком и по центру – как на отдельной странице печатной книги.

Письмо

Письмо, записка или дневниковая запись внутри повествования:

:::letter
Милостивый государь!
 
Буду на вокзале в девять. Захватите, пожалуйста, рукопись.
 
Ваш\
Н. Н.
:::

Блок помечает весь отрывок как письмо, так что обращение, текст и подпись держатся вместе и читаются как документ внутри текста. Обратная косая черта в конце строки оставляет следующую строку отдельной, как в подписи выше: без неё «Ваш» и «Н. Н.» слились бы в одну строку.

Капитель

:sc[...] набирает несколько слов капителью – там, где источник пользуется ею со смыслом: имя при первом появлении, вывеска, заголовок внутри текста.

Он прочёл медную табличку на двери: :sc[Доктор Генри Джекил].

Применяйте её только там, где капитель что-то различает в оригинале. Для выделения есть курсив и полужирный.

Номера печатных страниц

Издание, повторяющее печатную книгу, может отмечать, где начинается каждая печатная страница, – чтобы на неё можно было сослаться по бумажному изданию:

...на этом рассуждение заканчивается. :pb[412]Следующая глава начинается
наутро.

• :pb[412] принимает номер страницы: арабский (412) или римский (xiv, как часто в предисловии). Всё остальное остаётся буквальным текстом.
• Поток текста он не трогает. На широком экране номер виден на левом поле, как помета на полях в научном издании.
• Каждая отметка – цель ссылки: #p412 ведёт прямо на страницу 412, так что цитата может указывать точную страницу.

Разрыв сцены

Для разрыва между сценами отдельный блок не нужен. Это горизонтальная линия (--- на отдельной строке), и в книжном режиме чтения она набирается центрированными звёздочками, как в печатном романе.