Строительные блоки документа

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

Важно сразу договориться о терминах. Под строительным блоком здесь понимается не элемент интерфейса Word и не кнопка на панели инструментов, а логическая конструкция, которую вы создаёте прямо в Markdown- или Liquid-тексте. Именно эти конструкции в итоге определяют:

• какой будет структура готового документа;
• как будет вестись автоматическая нумерация;
• как элементы документа связываются между собой ссылками;
• как в итоге корректно собирается сам Word-файл.

Раздел ориентирован на практическое применение, а не на теорию: каждая страница — это готовый рецепт «как это написать», а не общее описание возможностей. Предполагается, что вы уже прочитали разделы про рабочий процесс, шаблоны и языки проекта и примерно понимаете, зачем нужны Markdown и Liquid JS и какую роль в оформлении играет шаблон.

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

• зачем этот блок нужен и какую задачу он решает;
• как он объявляется в тексте — синтаксис и обязательные части;
• как на практике его использовать при написании реального документа;
• как сослаться на этот элемент из других мест текста.

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