Skip to content

Commit

Permalink
docs(ru): update translations (#4422)
Browse files Browse the repository at this point in the history
  • Loading branch information
dragomano authored Dec 13, 2024
1 parent ff254dc commit 08ce34d
Show file tree
Hide file tree
Showing 3 changed files with 39 additions and 12 deletions.
34 changes: 25 additions & 9 deletions docs/ru/guide/routing.md
Original file line number Diff line number Diff line change
Expand Up @@ -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) следующим образом:
Expand All @@ -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'
}
}
```
Expand All @@ -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`, нужно использовать:
Expand Down
11 changes: 9 additions & 2 deletions docs/ru/reference/default-theme-config.md
Original file line number Diff line number Diff line change
Expand Up @@ -217,13 +217,13 @@ export default {
socialLinks: [
{ icon: 'github', link: 'https://github.com/vuejs/vitepress' },
{ icon: 'twitter', link: '...' },
// Вы также можете добавить пользовательские иконки, передав SVG в виде строки:
// Можно добавить пользовательские иконки, передав SVG в виде строки:
{
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>'
},
link: '...',
// Вы также можете включить пользовательский ярлык для доступности (необязательно, но рекомендуется):
// Можно включить пользовательский ярлык для доступности (необязательно, но рекомендуется):
ariaLabel: 'классная ссылка'
}
]
Expand Down Expand Up @@ -430,6 +430,13 @@ export interface DocFooter {

Можно использовать для настройки aria-метки кнопки переключения языка в панели навигации. Это используется только в том случае, если вы используете [i18n](../guide/i18n).

## skipToContentLabel

- Тип: `string`
- По умолчанию: `Skip to content`

Можно использовать для настройки метки ссылки перехода к содержимому. Эта ссылка отображается, когда пользователь перемещается по сайту с помощью клавиатуры.

## externalLinkIcon {#externallinkicon}

- Тип: `boolean`
Expand Down
6 changes: 5 additions & 1 deletion docs/ru/reference/default-theme-search.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,11 @@ export default defineConfig({

![скриншот модального окна поиска](/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}

Expand Down

0 comments on commit 08ce34d

Please sign in to comment.