From 30a7fceea0c1ec54a7a54256c6245c5360aab6ad Mon Sep 17 00:00:00 2001 From: 1scnd_ <62334658+parinovK@users.noreply.github.com> Date: Tue, 17 Dec 2024 16:30:28 +0300 Subject: [PATCH] =?UTF-8?q?=D0=BF=D1=80=D0=BE=D0=B2=D0=B5=D1=80=D0=BA?= =?UTF-8?q?=D0=B0=20=D0=BC=D0=B8=D0=BD=D0=B8=D1=82=D0=BE=D0=BA=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/project/toc.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/ru/project/toc.md b/ru/project/toc.md index 3181eb50..80f8bbcf 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} Вы можете разбить оглавление на несколько файлов и вставить одно оглавление в другое. Когда это пригодится: * У вас есть блоки оглавления, которые используются в нескольких документах.