diff --git a/ru/guides/generate-pdf.md b/ru/guides/generate-pdf.md index c41d6e9c..34e22c42 100644 --- a/ru/guides/generate-pdf.md +++ b/ru/guides/generate-pdf.md @@ -1,3 +1,7 @@ +--- +tags: + - Инструкция +--- # Создание PDF из документации Diplodoc может генерировать документацию в формате PDF. diff --git a/ru/guides/multilingual-projects.md b/ru/guides/multilingual-projects.md index e2887451..9b08da17 100644 --- a/ru/guides/multilingual-projects.md +++ b/ru/guides/multilingual-projects.md @@ -1,3 +1,8 @@ +--- +tags: + - Структура + - Локализация +--- # Многоязычные проекты Если ваша документация переведена на несколько языков, вы можете управлять ею с помощью многоязычного проекта. Такой проект поддерживает несколько версий контента — по одной на каждый язык. Локализованные версии хранятся в одном репозитории и попадают в общую сборку. diff --git a/ru/guides/pdf-styles.md b/ru/guides/pdf-styles.md index 4436a330..40d54191 100644 --- a/ru/guides/pdf-styles.md +++ b/ru/guides/pdf-styles.md @@ -1,3 +1,7 @@ +--- +tags: + - Стизилизация +--- # Пользовательские стили в PDF [PDF-версия документации](generate-pdf.md) собирается в три шага: diff --git a/ru/guides/source-docs.md b/ru/guides/source-docs.md index 08646d9c..9b6a1a24 100644 --- a/ru/guides/source-docs.md +++ b/ru/guides/source-docs.md @@ -4,7 +4,7 @@ {% note alert %} -sourcedocs-инклюдер находится в процессе деприкации в пользу [generic-инклюдера](generic.md). +sourcedocs-инклюдер находится в процессе отключения в пользу [generic-инклюдера](generic.md). {% endnote %} diff --git a/ru/project/index.md b/ru/project/index.md index f9468512..05f0a664 100644 --- a/ru/project/index.md +++ b/ru/project/index.md @@ -1,3 +1,7 @@ +--- +tags: + - Структура +--- # Структура проекта Базовый проект включает [файл оглавления](./toc.md) и файлы с контентом. diff --git a/ru/project/navigation.md b/ru/project/navigation.md index 909b0388..af6d9723 100644 --- a/ru/project/navigation.md +++ b/ru/project/navigation.md @@ -1,3 +1,7 @@ +--- +tags: + - Стилизация +--- # Расширенная навигация Платформа поддерживает гибкую настройку верхней и нижней навигации («шапки» и «подвала») на странице. diff --git a/ru/project/toc-multiple.md b/ru/project/toc-multiple.md index 156a69d0..e553f521 100644 --- a/ru/project/toc-multiple.md +++ b/ru/project/toc-multiple.md @@ -1,3 +1,7 @@ +--- +tags: + - Структура +--- # Несколько оглавлений Можно разделить проект документации на части, сгруппировав статьи в несколько оглавлений и связав их перекрестными ссылками. diff --git a/ru/quickstart.md b/ru/quickstart.md index 8e17223e..f5316e65 100644 --- a/ru/quickstart.md +++ b/ru/quickstart.md @@ -1,3 +1,7 @@ +--- +tags: + - Инструкция +--- # Быстрый старт ## Подготовка {#prepare} diff --git a/ru/style/css-js.md b/ru/style/css-js.md index 34e5e4e6..ca87e4fe 100644 --- a/ru/style/css-js.md +++ b/ru/style/css-js.md @@ -1,3 +1,7 @@ +--- +tags: + - Стизилизация +--- # Подключение CSS и JavaScript {% note warning %} diff --git a/ru/style/theme.md b/ru/style/theme.md index 9499874f..3fee8529 100644 --- a/ru/style/theme.md +++ b/ru/style/theme.md @@ -1,3 +1,7 @@ +--- +tags: + - Стизилизация +--- # Темизация Темизация настраивает визуальное оформление документации. diff --git a/ru/toc.yaml b/ru/toc.yaml index 2948f187..c544d811 100644 --- a/ru/toc.yaml +++ b/ru/toc.yaml @@ -119,7 +119,7 @@ items: items: - name: Структура проекта href: project/index.md - - name: Оглавление + - name: Оглавление проекта href: project/toc.md items: - name: Несколько оглавлений @@ -130,9 +130,9 @@ items: href: project/navigation.md - name: Редиректы href: project/redirects.md - - name: Метаданные + - name: Метаданные статьи href: project/meta.md - - name: Оглавление страницы документации + - name: Оглавление статьи href: project/minitoc.md - name: Конфигурация проекта labeled: true diff --git a/ru/tools/docs/build.md b/ru/tools/docs/build.md index 73ad1191..999f06be 100644 --- a/ru/tools/docs/build.md +++ b/ru/tools/docs/build.md @@ -1,3 +1,7 @@ +--- +tags: + - Сборка +--- # Сборка документации Cборка проекта выполняется командой `yfm build` с параметрами: diff --git a/ru/tools/docs/content.md b/ru/tools/docs/content.md index 971afdc4..db4dfef3 100644 --- a/ru/tools/docs/content.md +++ b/ru/tools/docs/content.md @@ -1,3 +1,7 @@ +--- +tags: + - Сборка +--- # Сборка одного файла Команда `yfm content` обрабатывает **один** md-файл и выводит результат в `stdout` (или записывает в файл). В отличие от [`yfm build`](build.md), она не собирает полноценную страницу: для формата `html` выводится только **контент** — без оглавления, шапки и обвязки страницы. diff --git a/ru/tools/docs/portable.md b/ru/tools/docs/portable.md index b9089ab5..a66e7d1d 100644 --- a/ru/tools/docs/portable.md +++ b/ru/tools/docs/portable.md @@ -1,4 +1,8 @@ -# Portable-версия CLI +--- +tags: + - Инструкция +--- +# Как собрать portable-версию CLI Из пакета [@diplodoc/cli](https://www.npmjs.com/package/@diplodoc/cli) можно собрать один исполняемый файл для Windows, macOS или Linux. Внутри такого файла уже есть и сам CLI, и среда выполнения Node.js, поэтому на компьютере, где он запускается, не нужно ничего устанавливать: ни Node.js, ни npm. Интернет для работы тоже не требуется. diff --git a/ru/tools/docs/publish-s3.md b/ru/tools/docs/publish-s3.md index 2b6354db..b95b4a67 100644 --- a/ru/tools/docs/publish-s3.md +++ b/ru/tools/docs/publish-s3.md @@ -1,3 +1,7 @@ +--- +tags: + - Инструкция +--- # Выкладка на S3 Для публикации документации в [хранилище S3](https://cloud.yandex.ru/services/storage) используется команда `yfm publish`. diff --git a/ru/tools/docs/singlepage.md b/ru/tools/docs/singlepage.md index ee0a280a..52a02a68 100644 --- a/ru/tools/docs/singlepage.md +++ b/ru/tools/docs/singlepage.md @@ -1,3 +1,7 @@ +--- +tags: + - Сборка +--- # Одностраничная сборка {% note warning "Beta-функциональность" %} diff --git a/ru/tools/docs/translate-ai.md b/ru/tools/docs/translate-ai.md index e11ea698..45aeef4b 100644 --- a/ru/tools/docs/translate-ai.md +++ b/ru/tools/docs/translate-ai.md @@ -1,5 +1,7 @@ --- keywords: ['translate', 'ai', 'llm', 'yandexgpt', 'openai', 'openrouter', 'anthropic', 'перевод', 'машинный перевод'] +tags: + - Локализация --- # AI-перевод diff --git a/ru/tools/docs/translate.md b/ru/tools/docs/translate.md index 7b6726e2..d6fbc2d7 100644 --- a/ru/tools/docs/translate.md +++ b/ru/tools/docs/translate.md @@ -1,5 +1,7 @@ --- keywords: ['translate', 'xliff', 'cat', 'i18n', 'l10n', 'localization', 'internationalization'] +tags: + - Локализация --- # Локализация