Initial commit

docs/examples/documents/report/chapters/00-introduction.typ

@@ -0,0 +1,11 @@
+#import "/.template/lib/index.typ": vref, vrefs
+
+#heading(numbering: none)[ВВЕДЕНИЕ]
+
+Настоящий отчёт подготовлен для демонстрации структуры рабочего проекта. Замените этот текст описанием основания, цели, исходных данных и границ своей работы.
+
+В основном разделе показаны рисунки, таблицы, формулы, ссылки и цитирование источников. Эти блоки можно копировать и адаптировать. Например, требования к наблюдениям можно сопроводить ссылкой на нормативный источник @fnip.
+
+Цель работы — оценить исходные условия, выполнить расчётную проверку и сформулировать рекомендации для следующего этапа.
+
+Исходные материалы приведены в #vref(<appendix-source-data>), а дополнительные расчёты — в #vref(<appendix-additional-calculations>). Оба приложения можно указать одной групповой ссылкой: в #vrefs((<appendix-source-data>, <appendix-additional-calculations>)).

docs/examples/documents/report/chapters/10-main.typ

@@ -0,0 +1,78 @@
+// Публичные функции шаблона можно импортировать в любой главе.
+#import "/.template/lib/index.typ": corp-table, formula, vref, vrefs, eqref
+
+= ИСХОДНЫЕ ДАННЫЕ <source-data>
+
+В работе использованы инженерно-геологические материалы, параметры массива и проектная геометрия. Структура исходных данных показана на #vref(<workflow>).
+
+// РИСУНОК: храните файлы проекта в assets/images/.
+// width принимает, например, 60%, 12cm или auto.
+#figure(
+  image("../assets/images/example-diagram.svg", width: 82%),
+  caption: [Последовательность подготовки расчётной модели],
+) <workflow>
+
+// НЕСКОЛЬКО ИЗОБРАЖЕНИЙ: grid позволяет собрать панели а), б), в).
+#figure(
+  grid(
+    columns: (1fr, 1fr),
+    column-gutter: 1em,
+    row-gutter: 0.4em,
+    align(center)[
+      #rect(width: 5.4cm, height: 2.2cm, fill: rgb("fff3cf"), stroke: rgb("e39f49"))
+      #linebreak()
+      а) исходная схема
+    ],
+    align(center)[
+      #circle(radius: 1.1cm, fill: rgb("fbb20d"), stroke: rgb("444444"))
+      #linebreak()
+      б) расчётная область
+    ],
+  ),
+  caption: [Варианты представления графических материалов],
+) <figure-grid>
+
+На #vrefs((<workflow>, <figure-grid>)) приведены два допустимых способа оформления графики.
+
+= МЕТОДИКА РАСЧЁТА
+
+Расчётный коэффициент запаса определяется отношением удерживающих сил к сдвигающим:
+
+// ФОРМУЛА: helper formula оформляет отдельную нумерованную формулу.
+#formula(
+  $K = (sum F_("уд"))/(sum F_("сдв"))$,
+) <safety-factor>
+
+В тексте можно использовать короткую формулу $K >= 1.3$ без отдельного номера. На #eqref(<safety-factor>) ссылаются как на обычный объект документа.
+
+= РЕЗУЛЬТАТЫ
+
+// ПРОСТАЯ ТАБЛИЦА: columns задаёт число или относительную ширину столбцов.
+#figure(
+  corp-table(
+    columns: (1.3fr, 1fr, 1fr),
+    header: ([Расчётный случай], [Коэффициент $K$], [Оценка]),
+    body: (
+      [Основное сочетание], [1,42], [Устойчиво],
+      [Водо-насыщение], [1,31], [Устойчиво],
+      [Сейсмическое воздействие], [1,18], [Требуются меры],
+    ),
+    align: (left, center, left),
+    table-align: "center",
+    text-size: 9.5pt,
+    body-inset: (x: 5pt, y: 4pt),
+    repeat_header: true,
+    continuation: true,
+  ),
+  caption: [Результаты проверочных расчётов],
+) <calculation-results>
+
+Как видно из #vref(<calculation-results>, "р"), третий случай требует дополнительных мероприятий. Более сложные таблицы, объединение ячеек и импорт CSV показаны в `docs/examples/formatting/main.typ`.
+
+== Основные рекомендации
+
+- уточнить положение уровня подземных вод;
+- проверить расчётные параметры по результатам наблюдений;
+- повторить оценку после корректировки проектной геометрии.
+
+Дополнительные исходные данные вынесены в приложение, а библиографическая запись хранится в `assets/references.bib`.

docs/examples/documents/report/chapters/90-conclusion.typ

@@ -0,0 +1,11 @@
+#heading(numbering: none)[ЗАКЛЮЧЕНИЕ]
+
+В демонстрационном отчёте показаны настройка титульных данных, подключение глав, автоматическая нумерация рисунков, таблиц и формул, перекрёстные ссылки, библиография и приложение.
+
+Перед выпуском собственного документа:
+
+- замените значения в `main.typ`;
+- удалите учебные блоки, которые не относятся к работе;
+- подключите фактические главы через `#include`;
+- проверьте ссылки, список источников и итоговый PDF;
+- смените `document-mode` с `draft` на `final`.

docs/examples/documents/report/chapters/appendices/01-source-data.typ

@@ -0,0 +1,14 @@
+= Исходные данные <appendix-source-data>
+
+В приложении можно разместить исходные таблицы, схемы и другие материалы, которые перегружают основной текст.
+
+#figure(
+  table(
+    columns: (1fr, 1fr),
+    inset: 5pt,
+    [Параметр], [Значение],
+    [Высота уступа], [15 м],
+    [Угол откоса], [70°],
+  ),
+  caption: [Пример исходных параметров],
+) <appendix-source-table>

docs/examples/documents/report/chapters/appendices/02-additional-calculations.typ

@@ -0,0 +1,8 @@
+= Дополнительные расчёты <appendix-additional-calculations>
+
+Каждое приложение хранится в отдельном файле. Его первый заголовок задаёт название, номер формируется автоматически, а метка позволяет ссылаться на приложение из любой главы.
+
+#figure(
+  rect(width: 6cm, height: 2cm, fill: luma(235), stroke: 0.6pt),
+  caption: [Дополнительная расчётная схема],
+) <appendix-calculation-scheme>