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: ''
},
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}