diff --git a/ru/project/toc.md b/ru/project/toc.md index 3181eb5..80f8bbc 100644 --- a/ru/project/toc.md +++ b/ru/project/toc.md @@ -1,4 +1,4 @@ -Оглавление документа +# Оглавление документа Структура документа описывается в файле `toc.yaml`. На основе этого файла генерируется оглавление и происходит сборка документа. @@ -14,7 +14,7 @@ {% endnote %} -## Структура {#structure} +### Структура {#structure} Стандартная структура файла `toc.yaml` имеет вид: @@ -39,7 +39,7 @@ items: * `href` — относительный путь до файла. * `items` — группирующий элемент. -## Условия видимости разделов {#when} +### Условия видимости разделов {#when} Отдельные разделы можно включать или не включать в документ в зависимости от значений [переменных](../syntax/vars.md). Для описания условий видимости используется параметр `when`. @@ -51,7 +51,7 @@ items: when: version == 12 ``` -## Подстановки и условные операторы {#subtitudes} +### Подстановки и условные операторы {#subtitudes} Название документа поддерживает [подстановки](../syntax/vars#subtitudes) и [условные операторы](../syntax/vars#conditions). @@ -65,7 +65,7 @@ title: "not_var{{ title }}" {% endnote %} -## Настройка раскрытия разделов { #expanded } +### Настройка раскрытия разделов { #expanded } По умолчанию все разделы оглавления свернуты. Чтобы важные разделы и страницы в оглавлении всегда были на виду можно использовать параметр `expanded`: @@ -94,7 +94,7 @@ items: {% endnote %} -## Labeled-разделы в навигации {#labeled} +### Labeled-разделы в навигации {#labeled} Специальные заголовки, которые визуально группируют отдельные пункты в оглавлении. @@ -119,7 +119,7 @@ items: href: path/to/file.md ``` -## Скрытые разделы {#hidden} +### Скрытые разделы {#hidden} Чтобы раздел был доступен только по прямой ссылке и не попал в оглавление, укажите параметр `hidden`. @@ -132,7 +132,7 @@ items: Для полного исключения скрытых разделов из сборки используйте [ключ сборки](../tools/docs/settings.md) `--remove-hidden-toc-items=true`. -## Вставки оглавлений {#includes} +### Вставки оглавлений {#includes} Вы можете разбить оглавление на несколько файлов и вставить одно оглавление в другое. Когда это пригодится: * У вас есть блоки оглавления, которые используются в нескольких документах.