From 87be25bd56939fc78f5679fedde46c5c5e55fae0 Mon Sep 17 00:00:00 2001 From: separatrix Date: Thu, 27 Aug 2026 16:23:15 +0300 Subject: [PATCH 1/2] feat: added tags info --- en/project/meta.md | 22 ++++++++++++++++++++++ ru/project/meta.md | 22 ++++++++++++++++++++++ 2 files changed, 44 insertions(+) diff --git a/en/project/meta.md b/en/project/meta.md index 7e96177d..2da8b11e 100644 --- a/en/project/meta.md +++ b/en/project/meta.md @@ -110,6 +110,28 @@ Only extending the list of values in [##csp##](../settings.md#resources-csp) is | `object` +— || +|| `tags` | List of page tags. After the build, tags are displayed below the article and added to the HTML as separate `` elements. + +If [search](./search.md) is configured for the project, each tag links to related articles. On the search page, you can select several tags; the results include articles that have at least one of them. + +During processing, tags are converted to lowercase, surrounding whitespace is removed, and duplicate values are merged. A tag can contain up to 32 characters. + +{% cut "Example" %} + +```yaml +--- +title: Working with tables +tags: + - Markdown + - Tables +--- +``` + +{% endcut %} + +| `string[]` + — || || `title` | Meta title of the page. diff --git a/ru/project/meta.md b/ru/project/meta.md index 7a62d838..672429b5 100644 --- a/ru/project/meta.md +++ b/ru/project/meta.md @@ -124,6 +124,28 @@ metadata: | `object` +— || +|| `tags` | Список тегов страницы. После сборки теги отображаются под текстом статьи и добавляются в HTML как отдельные элементы ``. + +Если в проекте настроен [поиск](./search.md), по тегу можно перейти к связанным с ним статьям. На странице поиска можно выбрать несколько тегов: в результаты попадут статьи хотя бы с одним из них. + +При обработке теги приводятся к нижнему регистру, пробелы по краям удаляются, а повторяющиеся значения объединяются. Максимальная длина тега — 32 символа. + +{% cut "Пример" %} + +```yaml +--- +title: Работа с таблицами +tags: + - Markdown + - Таблицы +--- +``` + +{% endcut %} + +| `string[]` + — || || `title` | Мета-заголовок страницы. From f2c3abd1d30e93e525d012c1d21555b83712b367 Mon Sep 17 00:00:00 2001 From: separatrix Date: Thu, 27 Aug 2026 17:10:48 +0300 Subject: [PATCH 2/2] fix: updated --- en/project/meta.md | 2 ++ ru/project/meta.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/en/project/meta.md b/en/project/meta.md index 2da8b11e..63acb9e5 100644 --- a/en/project/meta.md +++ b/en/project/meta.md @@ -117,6 +117,8 @@ If [search](./search.md) is configured for the project, each tag links to relate During processing, tags are converted to lowercase, surrounding whitespace is removed, and duplicate values are merged. A tag can contain up to 32 characters. +Tags that start with `_` are considered technical. They are not displayed below the article, added to the HTML as `article:tag`, or used in search. + {% cut "Example" %} ```yaml diff --git a/ru/project/meta.md b/ru/project/meta.md index 672429b5..9f38041c 100644 --- a/ru/project/meta.md +++ b/ru/project/meta.md @@ -131,6 +131,8 @@ metadata: При обработке теги приводятся к нижнему регистру, пробелы по краям удаляются, а повторяющиеся значения объединяются. Максимальная длина тега — 32 символа. +Теги, начинающиеся с `_`, считаются техническими. Они не отображаются под статьёй, не добавляются в HTML как `article:tag` и не участвуют в поиске. + {% cut "Пример" %} ```yaml