docs(ru): update translations (#4422)

pull/4423/head
Bugo 1 month ago committed by GitHub
parent ff254dcbe6
commit 08ce34d9a2
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

@ -161,19 +161,21 @@ src/getting-started.md --> /getting-started.html
├─ packages ├─ packages
│ ├─ pkg-a │ ├─ pkg-a
│ │ └─ src │ │ └─ src
│ │ ├─ pkg-a-code.ts │ │ ├─ foo.md
│ │ └─ pkg-a-docs.md │ │ └─ index.md
│ └─ pkg-b │ └─ pkg-b
│ └─ src │ └─ src
│ ├─ pkg-b-code.ts │ ├─ bar.md
│ └─ pkg-b-docs.md │ └─ index.md
``` ```
И вы хотите, чтобы страницы VitePress генерировались следующим образом: И вы хотите, чтобы страницы VitePress генерировались следующим образом:
``` ```
packages/pkg-a/src/pkg-a-docs.md --> /pkg-a/index.html packages/pkg-a/src/index.md --> /pkg-a/index.html
packages/pkg-b/src/pkg-b-docs.md --> /pkg-b/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) следующим образом: Этого можно добиться, настроив опцию [`rewrites`](../reference/site-config#rewrites) следующим образом:
@ -182,8 +184,10 @@ packages/pkg-b/src/pkg-b-docs.md --> /pkg-b/index.html
// .vitepress/config.js // .vitepress/config.js
export default { export default {
rewrites: { rewrites: {
'packages/pkg-a/src/pkg-a-docs.md': 'pkg-a/index.md', 'packages/pkg-a/src/index.md': 'pkg-a/index.md',
'packages/pkg-b/src/pkg-b-docs.md': 'pkg-b/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 ```ts
export default { export default {
rewrites: { 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#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 Относительные ссылки с переписыванием ::: warning Относительные ссылки с переписыванием
Когда переписывание включено, **относительные ссылки должны быть основаны на переписанных путях**. Например, чтобы создать относительную ссылку с `packages/pkg-a/src/pkg-a-code.md` на `packages/pkg-b/src/pkg-b-code.md`, нужно использовать: Когда переписывание включено, **относительные ссылки должны быть основаны на переписанных путях**. Например, чтобы создать относительную ссылку с `packages/pkg-a/src/pkg-a-code.md` на `packages/pkg-b/src/pkg-b-code.md`, нужно использовать:

@ -217,13 +217,13 @@ export default {
socialLinks: [ socialLinks: [
{ icon: 'github', link: 'https://github.com/vuejs/vitepress' }, { icon: 'github', link: 'https://github.com/vuejs/vitepress' },
{ icon: 'twitter', link: '...' }, { icon: 'twitter', link: '...' },
// Вы также можете добавить пользовательские иконки, передав SVG в виде строки: // Можно добавить пользовательские иконки, передав SVG в виде строки:
{ {
icon: { icon: {
svg: '<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Dribbble</title><path d="M12...6.38z"/></svg>' svg: '<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Dribbble</title><path d="M12...6.38z"/></svg>'
}, },
link: '...', link: '...',
// Вы также можете включить пользовательский ярлык для доступности (необязательно, но рекомендуется): // Можно включить пользовательский ярлык для доступности (необязательно, но рекомендуется):
ariaLabel: 'классная ссылка' ariaLabel: 'классная ссылка'
} }
] ]
@ -430,6 +430,13 @@ export interface DocFooter {
Можно использовать для настройки aria-метки кнопки переключения языка в панели навигации. Это используется только в том случае, если вы используете [i18n](../guide/i18n). Можно использовать для настройки aria-метки кнопки переключения языка в панели навигации. Это используется только в том случае, если вы используете [i18n](../guide/i18n).
## skipToContentLabel
- Тип: `string`
- По умолчанию: `Skip to content`
Можно использовать для настройки метки ссылки перехода к содержимому. Эта ссылка отображается, когда пользователь перемещается по сайту с помощью клавиатуры.
## externalLinkIcon {#externallinkicon} ## externalLinkIcon {#externallinkicon}
- Тип: `boolean` - Тип: `boolean`

@ -24,7 +24,11 @@ export default defineConfig({
![скриншот модального окна поиска](/search.png) ![скриншот модального окна поиска](/search.png)
В качестве альтернативы можно использовать [Algolia DocSearch](#algolia-search) или некоторые плагины сообщества, например <https://www.npmjs.com/package/vitepress-plugin-search> или <https://www.npmjs.com/package/vitepress-plugin-pagefind>. В качестве альтернативы можно использовать [Algolia DocSearch](#algolia-search) или некоторые плагины сообщества, например:
- <https://www.npmjs.com/package/vitepress-plugin-search>
- <https://www.npmjs.com/package/vitepress-plugin-pagefind>
- <https://www.npmjs.com/package/@orama/plugin-vitepress>
### i18n {#local-search-i18n} ### i18n {#local-search-i18n}

Loading…
Cancel
Save