From cb5a5f5826bad143e69a1a0d06e47bdc6eb9013c Mon Sep 17 00:00:00 2001 From: Bugo Date: Sun, 7 Jul 2024 23:20:39 +0500 Subject: [PATCH 1/4] Update ru/guide/markdown.md --- docs/ru/guide/markdown.md | 39 ++++++++++++++++++++++++++++++++++++++- 1 file changed, 38 insertions(+), 1 deletion(-) diff --git a/docs/ru/guide/markdown.md b/docs/ru/guide/markdown.md index ea19da0f16aa..a021cd187c24 100644 --- a/docs/ru/guide/markdown.md +++ b/docs/ru/guide/markdown.md @@ -233,7 +233,7 @@ export default defineConfig({ Это специальный контейнер, который можно использовать для предотвращения конфликтов стилей и маршрутизаторов с VitePress. Это особенно полезно при документировании библиотек компонентов. Вы также можете посмотреть [whyframe](https://whyframe.dev/docs/integrations/vitepress) для лучшей изоляции. -**Syntax** +**Синтаксис** ```md ::: raw @@ -836,6 +836,43 @@ export default config Формат выбранного диапазона строк может быть следующим: `{3,}`, `{,10}`, `{1,10}` +Вы также можете использовать [блоки кода VS Code](https://code.visualstudio.com/docs/editor/codebasics#_folding), чтобы включить только соответствующую часть файла. Можно указать пользовательское имя блока после `#`, следующего за путём к файлу: + +**Разметка** + +```md +# Документация + +## Основы + + + +``` + +**Часть файла** (`parts/basics.md`) + +```md + +## Используемая строка 1 + +## Используемая строка 2 + +## Используемая строка 3 + +``` + +**Эквивалентный код** + +```md +# Документация + +## Основы + +## Используемая строка 1 + +## Используемая строка 3 +``` + ::: warning ПРЕДУПРЕЖДЕНИЕ Обратите внимание, что это не приводит к ошибкам, если ваш файл отсутствует. Поэтому при использовании этой функции убедитесь, что содержимое отображается так, как ожидается. ::: From 2e7d2f91b31ab50ee028e5f8fc826772303ff682 Mon Sep 17 00:00:00 2001 From: Bugo Date: Sun, 7 Jul 2024 23:21:00 +0500 Subject: [PATCH 2/4] Update ru/reference/default-theme-nav.md --- docs/ru/reference/default-theme-nav.md | 54 ++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) diff --git a/docs/ru/reference/default-theme-nav.md b/docs/ru/reference/default-theme-nav.md index 9ff776593205..915174f53e63 100644 --- a/docs/ru/reference/default-theme-nav.md +++ b/docs/ru/reference/default-theme-nav.md @@ -160,3 +160,57 @@ export default { ## Социальные ссылки {#social-links} См. [`socialLinks`](./default-theme-config#sociallinks). + +## Пользовательские компоненты + +Вы можете добавить пользовательские компоненты в панель навигации с помощью опции `component`. Ключ `component` должен быть именем компонента Vue и должен быть зарегистрирован глобально с помощью [Theme.enhanceApp](../guide/custom-theme#theme-interface). + +```js +// .vitepress/config.js +export default { + themeConfig: { + nav: [ + { + text: 'Мое меню', + items: [ + { + component: 'MyCustomComponent', + // Необязательные параметры для передачи компоненту + props: { + title: 'Мой пользовательский компонент' + } + } + ] + }, + { + component: 'AnotherCustomComponent' + } + ] + } +} +``` + +Затем необходимо зарегистрировать компонент глобально: + +```js +// .vitepress/theme/index.js +import DefaultTheme from 'vitepress/theme' + +import MyCustomComponent from './components/MyCustomComponent.vue' +import AnotherCustomComponent from './components/AnotherCustomComponent.vue' + +/** @type {import('vitepress').Theme} */ +export default { + extends: DefaultTheme, + enhanceApp({ app }) { + app.component('MyCustomComponent', MyCustomComponent) + app.component('AnotherCustomComponent', AnotherCustomComponent) + } +} +``` + +Ваш компонент будет отображаться на панели навигации. VitePress предоставляет следующие дополнительные параметры компонента: + +- `screenMenu`: необязательное булево значение, указывающее, находится ли компонент внутри мобильного навигационного меню + +Пример можно посмотреть в тестах e2e [здесь](https://github.com/vuejs/vitepress/tree/main/__tests__/e2e/.vitepress). \ No newline at end of file From fb650c71a0641a6484c7726a24bdaf78dce59fcc Mon Sep 17 00:00:00 2001 From: Bugo Date: Sun, 7 Jul 2024 23:21:16 +0500 Subject: [PATCH 3/4] Update ru/reference/default-theme-search.md --- docs/ru/reference/default-theme-search.md | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/docs/ru/reference/default-theme-search.md b/docs/ru/reference/default-theme-search.md index a88e9c1de498..3fbbd38c531f 100644 --- a/docs/ru/reference/default-theme-search.md +++ b/docs/ru/reference/default-theme-search.md @@ -39,18 +39,25 @@ export default defineConfig({ provider: 'local', options: { locales: { - ru: { + ru: { // используйте ключ `root`, если хотите перевести локаль по умолчанию translations: { button: { buttonText: 'Поиск', buttonAriaLabel: 'Поиск' }, modal: { - noResultsText: 'Нет результатов для', + displayDetails: 'Отобразить подробный список', resetButtonTitle: 'Сбросить поиск', + backButtonTitle: 'Закрыть поиск', + noResultsText: 'Нет результатов по запросу', footer: { selectText: 'выбрать', - navigateText: 'перейти' + selectKeyAriaLabel: 'выбрать', + navigateText: 'перейти', + navigateUpKeyAriaLabel: 'стрелка вверх', + navigateDownKeyAriaLabel: 'стрелка вниз', + closeText: 'закрыть', + closeKeyAriaLabel: 'esc' } } } From c69bef1d6b1161ca1bc3946375f84a604ed61235 Mon Sep 17 00:00:00 2001 From: Bugo Date: Sun, 7 Jul 2024 23:21:31 +0500 Subject: [PATCH 4/4] Update ru/reference/site-config.md --- docs/ru/reference/site-config.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/ru/reference/site-config.md b/docs/ru/reference/site-config.md index 5068bf842a55..b159c9113ca8 100644 --- a/docs/ru/reference/site-config.md +++ b/docs/ru/reference/site-config.md @@ -489,7 +489,7 @@ export default { ### appearance {#appearance} -- Тип: `boolean | 'dark' | 'force-dark' | import('@vueuse/core').UseDarkOptions` +- Тип: `boolean | 'dark' | 'force-dark' | 'force-auto' | import('@vueuse/core').UseDarkOptions` - По умолчанию: `true` Включать ли тёмный режим (путём добавления класса `.dark` к элементу ``). @@ -497,6 +497,8 @@ export default { - Если опция имеет значение `true`, тема по умолчанию будет определяться цветовой гаммой, предпочитаемой пользователем. - Если опция имеет значение `dark`, тема по умолчанию будет тёмной, если пользователь не переключит её вручную. - Если установить значение `false`, пользователи не смогут переключать тему. +- Если для опции установлено значение `force-dark`, тема всегда будет темной, и пользователи не смогут её переключать. +- Если для опции установлено значение `force-auto`, тема всегда будет определяться предпочитаемой пользователем цветовой схемой, и пользователи не смогут её переключать. Эта опция вставляет встроенный скрипт, который восстанавливает настройки пользователей из локального хранилища с помощью ключа `vitepress-theme-appearance`. Это гарантирует, что класс `.dark` будет применён до отрисовки страницы, чтобы избежать мерцания.