From de5b7e119e26c27473f6c3cd71226918d7893921 Mon Sep 17 00:00:00 2001 From: Mihail Koshkin Date: Wed, 10 Jun 2026 17:54:39 +0300 Subject: [PATCH] DOCSTOOLS-3375 ym goals descr --- ru/guides/content-analytics.md | 14 +++------- ru/project/analytics/ym.md | 47 ++++++++++++++++++++++++++++++++++ ru/settings.md | 10 +++++--- ru/syntax/term.md | 5 ---- ru/toc.yaml | 2 ++ 5 files changed, 59 insertions(+), 19 deletions(-) create mode 100644 ru/project/analytics/ym.md diff --git a/ru/guides/content-analytics.md b/ru/guides/content-analytics.md index ff85f810..b3231a93 100644 --- a/ru/guides/content-analytics.md +++ b/ru/guides/content-analytics.md @@ -41,19 +41,13 @@ ![](../_images/opengraph.png) -2. Добавьте счётчик в документационный проект, используя конфигурационный файл [`.yfm`](../settings.md#config). +2. Добавьте счётчик в документационный проект, используя [конфигурационный файл `.yfm`](../settings.md#analytics-metrika). Пример: - ``` - allowHTML: true - apply-presets: true - varsPreset: external - langs: ['ru', 'en'] - - docs-viewer: - metrika: 44444444 - project-name: your-project-name + ```yaml + analytics: + - id: 44444444 ``` ### Добавление метаинформации {#meta-information} diff --git a/ru/project/analytics/ym.md b/ru/project/analytics/ym.md new file mode 100644 index 00000000..cba682f1 --- /dev/null +++ b/ru/project/analytics/ym.md @@ -0,0 +1,47 @@ +# Отправка целей в Метрику + +После [подключения Метрики](../../settings.md#analytics-metrika) в проект в счётчик начинают отправляться [цели](https://yandex.ru/support/metrica/ru/general/goals) на события в интерфейсе документации. + +{% note info %} + +Чтобы цели сохранялись в Метрике, необходимо [добавить их в счётчик по инструкции](https://yandex.ru/support/metrica/ru/general/goal-js-event). + +{% endnote %} + +## Поддерживаемые цели + +`DOCS_EDIT-IN-VCS_CLICK` +: Нажатие на кнопку-ссылку "Редактировать". + +`DOCS_FOOTER-NEXT_CLICK` +: Переход на следующую страницу по ссылке "Следующая" в конце статьи. + +`DOCS_FOOTER-PREV_CLICK` +: Переход на предыдущую страницу по ссылке "Предыдущая" в конце статьи. + +`DOCS_HEADER-LOGO_CLICK` +: Нажатие на логотип. + +`DOCS_HEADER-SANDWICH-MENU_CLICK` +: Раскрытие меню оглавления в мобильной версии. + +`DOCS_HEADER-SETTINGS_CLICK` +: Открытие пункта меню "Настройки". + +`DOCS_LANG_CLICK` +: Открытие меню выбора языка. + +`DOCS_WIDESCREEN-MODE_CLICK` +: Включение/выключение полноэкранного режима. + +`DOCS_HIDE-PAGE-NAV_CLICK` +: Включение/выключение навигации по текущей статье. + +`DOCS_FONTSIZE-MODE_CLICK` +: Изменение размера текста. + +`DOCS_READING-MODE_CLICK` +: Переход в режим чтения. + +`DOCS_SEARCH_CLICK` +: Нажатие на поле ввода поискового запроса. diff --git a/ru/settings.md b/ru/settings.md index 55771698..b658ef64 100644 --- a/ru/settings.md +++ b/ru/settings.md @@ -192,7 +192,7 @@ extensions: || `gtm.mode` | Тип уведомления перед отправкой событий `base` или `notification`. | `string` `base` || -|| `metrika` | +|| `metrika` {#analytics-metrika} | Подключение счётчиков [Яндекс Метрики](https://metrika.yandex.ru/). @@ -221,6 +221,8 @@ analytics: {% endcut %} +В подключенные счётчики из интерфейса документации [отправляются цели](./project/analytics/ym.md). + | `object[]` — @@ -267,13 +269,13 @@ analytics: Могут ли всплывающие подсказки содержать контент с множественными переносами строк: -* ##false## — подсказки могут содержать только одиночные переносы строк, все определения терминов должны располагаться в конце файла (при нарушении этого условия сборка завершится с [ошибкой `YFM009`](./project/lint.md)). - * ##true## — подсказки могут содержать контент с множественными переносами строк. +* ##false## — подсказки могут содержать только одиночные переносы строк, все определения терминов должны располагаться в конце файла (при нарушении этого условия сборка завершится с [ошибкой `YFM009`](./project/lint.md)). + | `bool` -`false` || +`true` || |# ### Секция `interface` {#interface} diff --git a/ru/syntax/term.md b/ru/syntax/term.md index 17696071..b8aa97cd 100644 --- a/ru/syntax/term.md +++ b/ru/syntax/term.md @@ -17,11 +17,6 @@ [*ключ_термина_2]: Определение термина 2. ``` -В определении термина по умолчанию можно использовать **только одиночные переносы строки**. Включить поддержку множественных переносов строки в определениях можно одним из способов: - -* выполнить сборку с параметром `--multiline-term-definitions`; -* добавить `content: multilineTermDefinitions: true` в [файл `.yfm`](../settings.md). - **Результат** Использование [термина](*term) в тексте. diff --git a/ru/toc.yaml b/ru/toc.yaml index 10ede6d1..f60380d4 100644 --- a/ru/toc.yaml +++ b/ru/toc.yaml @@ -175,6 +175,8 @@ items: items: - name: Контентная аналитика href: guides/content-analytics.md + - name: Отправка целей в Метрику + href: project/analytics/ym.md - name: Настройка личного домена href: personal-domain-ya-cloud.md - name: Единый источник