diff --git a/docs/ru/guide/routing.md b/docs/ru/guide/routing.md index 36664de67eba..79fb1d9e6ca1 100644 --- a/docs/ru/guide/routing.md +++ b/docs/ru/guide/routing.md @@ -161,19 +161,21 @@ src/getting-started.md --> /getting-started.html ├─ packages │ ├─ pkg-a │ │ └─ src -│ │ ├─ pkg-a-code.ts -│ │ └─ pkg-a-docs.md +│ │ ├─ foo.md +│ │ └─ index.md │ └─ pkg-b │ └─ src -│ ├─ pkg-b-code.ts -│ └─ pkg-b-docs.md +│ ├─ bar.md +│ └─ index.md ``` И вы хотите, чтобы страницы VitePress генерировались следующим образом: ``` -packages/pkg-a/src/pkg-a-docs.md --> /pkg-a/index.html -packages/pkg-b/src/pkg-b-docs.md --> /pkg-b/index.html +packages/pkg-a/src/index.md --> /pkg-a/index.html +packages/pkg-a/src/foo.md --> /pkg-a/foo.html +packages/pkg-b/src/index.md --> /pkg-b/index.html +packages/pkg-b/src/bar.md --> /pkg-b/bar.html ``` Этого можно добиться, настроив опцию [`rewrites`](../reference/site-config#rewrites) следующим образом: @@ -182,8 +184,10 @@ packages/pkg-b/src/pkg-b-docs.md --> /pkg-b/index.html // .vitepress/config.js export default { rewrites: { - 'packages/pkg-a/src/pkg-a-docs.md': 'pkg-a/index.md', - 'packages/pkg-b/src/pkg-b-docs.md': 'pkg-b/index.md' + 'packages/pkg-a/src/index.md': 'pkg-a/index.md', + 'packages/pkg-a/src/foo.md': 'pkg-a/foo.md', + 'packages/pkg-b/src/index.md': 'pkg-b/index.md', + 'packages/pkg-b/src/bar.md': 'pkg-b/bar.md' } } ``` @@ -193,13 +197,25 @@ export default { ```ts export default { rewrites: { - 'packages/:pkg/src/(.*)': ':pkg/index.md' + 'packages/:pkg/src/:slug*': ':pkg/:slug*' } } ``` Пути перезаписи компилируются с помощью пакета `path-to-regexp` — обратитесь к [его документации](https://github.com/pillarjs/path-to-regexp#parameters) за более сложным синтаксисом. +Пути перезаписи компилируются с помощью пакета `path-to-regexp` — обратитесь к [его документации](https://github.com/pillarjs/path-to-regexp/tree/6.x#parameters) за более сложным синтаксисом. + +`rewrites` также может быть функцией, которая получает исходный путь и возвращает новый: + +```ts +export default { + rewrites(id) { + return id.replace(/^packages\/([^/]+)\/src\//, '$1/') + } +} +``` + ::: warning Относительные ссылки с переписыванием Когда переписывание включено, **относительные ссылки должны быть основаны на переписанных путях**. Например, чтобы создать относительную ссылку с `packages/pkg-a/src/pkg-a-code.md` на `packages/pkg-b/src/pkg-b-code.md`, нужно использовать: diff --git a/docs/ru/reference/default-theme-config.md b/docs/ru/reference/default-theme-config.md index 8bddb01658de..348791c02209 100644 --- a/docs/ru/reference/default-theme-config.md +++ b/docs/ru/reference/default-theme-config.md @@ -217,13 +217,13 @@ export default { socialLinks: [ { icon: 'github', link: 'https://github.com/vuejs/vitepress' }, { icon: 'twitter', link: '...' }, - // Вы также можете добавить пользовательские иконки, передав SVG в виде строки: + // Можно добавить пользовательские иконки, передав SVG в виде строки: { icon: { svg: 'Dribbble' }, link: '...', - // Вы также можете включить пользовательский ярлык для доступности (необязательно, но рекомендуется): + // Можно включить пользовательский ярлык для доступности (необязательно, но рекомендуется): ariaLabel: 'классная ссылка' } ] @@ -430,6 +430,13 @@ export interface DocFooter { Можно использовать для настройки aria-метки кнопки переключения языка в панели навигации. Это используется только в том случае, если вы используете [i18n](../guide/i18n). +## skipToContentLabel + +- Тип: `string` +- По умолчанию: `Skip to content` + +Можно использовать для настройки метки ссылки перехода к содержимому. Эта ссылка отображается, когда пользователь перемещается по сайту с помощью клавиатуры. + ## externalLinkIcon {#externallinkicon} - Тип: `boolean` diff --git a/docs/ru/reference/default-theme-search.md b/docs/ru/reference/default-theme-search.md index f11cc34de7ec..c91e4be46767 100644 --- a/docs/ru/reference/default-theme-search.md +++ b/docs/ru/reference/default-theme-search.md @@ -24,7 +24,11 @@ export default defineConfig({ ![скриншот модального окна поиска](/search.png) -В качестве альтернативы можно использовать [Algolia DocSearch](#algolia-search) или некоторые плагины сообщества, например или . +В качестве альтернативы можно использовать [Algolia DocSearch](#algolia-search) или некоторые плагины сообщества, например: + +- +- +- ### i18n {#local-search-i18n}