Skip to content

Commit

Permalink
docs(ru): update translations (vuejs#4257)
Browse files Browse the repository at this point in the history
  • Loading branch information
dragomano authored Oct 9, 2024
1 parent 78c4d3d commit 6ea60f5
Show file tree
Hide file tree
Showing 12 changed files with 43 additions and 37 deletions.
2 changes: 1 addition & 1 deletion docs/ru/guide/asset-handling.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@

Вы можете ссылаться на статические ресурсы в ваших файлах разметки, компоненты `*.vue` в теме, стили и обычные файлы `.css`, используя абсолютные пути (основанные на корне проекта) или относительные пути (основанные на вашей файловой системе). Последнее похоже на поведение, к которому вы привыкли, если использовали Vite, Vue CLI или `file-loader` в webpack.

Распространенные типы файлов изображений, мультимедиа и шрифтов определяются и включаются в качестве ресурсов автоматически.
Распространённые типы файлов изображений, мультимедиа и шрифтов определяются и включаются в качестве ресурсов автоматически.

::: tip Связанные файлы не рассматриваются как ресурсы
PDF-файлы или другие документы, на которые есть ссылки в файлах с разметкой, не рассматриваются автоматически как ресурсы. Чтобы сделать связанные файлы доступными, вы должны вручную поместить их в каталог [`public`](#the-public-directory) вашего проекта.
Expand Down
4 changes: 2 additions & 2 deletions docs/ru/guide/data-loading.md
Original file line number Diff line number Diff line change
Expand Up @@ -175,7 +175,7 @@ export default {
}
```

**Types**
**Типы**

```ts
interface ContentOptions<T = ContentData[]> {
Expand Down Expand Up @@ -226,7 +226,7 @@ interface ContentOptions<T = ContentData[]> {

## Загрузчики типизированных данных {#typed-data-loaders}

При использовании TypeScript вы можете ввести свой загрузчик и экспортировать `data` следующим образом:
При использовании TypeScript можно ввести свой загрузчик и экспортировать `data` следующим образом:

```ts
import { defineLoader } from 'vitepress'
Expand Down
16 changes: 8 additions & 8 deletions docs/ru/guide/deploy.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ outline: deep

# Развёртывание вашего сайта VitePress {#deploy-your-vitepress-site}

Следующие руководства основаны на некоторых общих предположениях:
Следующие инструкции основаны на некоторых общих предположениях:

- Сайт VitePress находится в директории `docs` вашего проекта.
- Вы используете выходной каталог сборки по умолчанию (`.vitepress/dist`).
Expand All @@ -19,7 +19,7 @@ outline: deep
}
```

## Создание и локальное тестирование {#build-and-test-locally}
## Сборка и локальное тестирование {#build-and-test-locally}

1. Выполните эту команду, чтобы собрать документацию:

Expand All @@ -33,9 +33,9 @@ outline: deep
$ npm run docs:preview
```

Команда `preview` загрузит локальный статический веб-сервер, который будет обслуживать выходной каталог `.vitepress/dist` по адресу `http://localhost:4173`. Вы можете использовать это, чтобы убедиться, что всё выглядит хорошо, прежде чем отправлять в производство.
Команда `preview` загрузит локальный статический веб-сервер, который будет обслуживать выходной каталог `.vitepress/dist` по адресу `http://localhost:4173`. Вы можете использовать его для теста, чтобы убедиться, что всё выглядит хорошо, прежде чем отправлять в производство.

3. Вы можете настроить порт сервера, передав `--port` в качестве аргумента.
3. Можно указать порт сервера, передав `--port` в качестве аргумента.

```json
{
Expand All @@ -55,11 +55,11 @@ outline: deep

## Заголовки кэша HTTP {#http-cache-headers}

Если вы контролируете HTTP-заголовки на своем рабочем сервере, вы можете настроить заголовки `cache-control` для достижения лучшей производительности при повторных посещениях.
Если вы контролируете HTTP-заголовки на своем рабочем сервере, можно настроить заголовки `cache-control` для достижения лучшей производительности при повторных посещениях.

В производственной сборке используются хэшированные имена файлов для статических ресурсов (JavaScript, CSS и другие импортированные ресурсы, не находящиеся в `public`). Если вы просмотрите предварительную версию с помощью сетевой вкладки devtools вашего браузера, вы увидите файлы типа `app.4f283b18.js`.
В производственной сборке используются хэшированные имена файлов для статических ресурсов (JavaScript, CSS и другие импортированные ресурсы, не находящиеся в `public`). Если вы просмотрите предварительную версию с помощью вкладки «Network» («Сеть») инструментов разработчика вашего браузера, вы увидите файлы типа `app.4f283b18.js`.

Этот хэш `4f283b18` генерируется из содержимого этого файла. Один и тот же хэшированный URL гарантированно обслуживает одно и то же содержимое файла — если содержимое меняется, то и URL тоже. Это означает, что вы можете смело использовать самые сильные заголовки кэша для этих файлов. Все такие файлы будут помещены в каталог `assets/` в выходном каталоге, поэтому вы можете настроить для них следующий заголовок:
Этот хэш `4f283b18` генерируется из содержимого этого файла. Один и тот же хэшированный URL гарантированно обслуживает одно и то же содержимое файла — если содержимое меняется, то и URL тоже. Это означает, что можно смело использовать самые сильные настройки кэширования для этих файлов. Все такие файлы будут помещены в каталог `assets/` в выходном каталоге, поэтому вы можете настроить для них следующий заголовок:

```
Cache-Control: max-age=31536000,immutable
Expand Down Expand Up @@ -198,7 +198,7 @@ Cache-Control: max-age=31536000,immutable

### GitLab Pages {#gitlab-pages}

1. Установите значение `../public` для параметра `outDir` в конфигурации VitePress. Настройте опцию `base` на `'/<репозиторий>/'`, если вы хотите развернуть ваш проект по адресу `https://<имя пользователя>.gitlab.io/<репозиторий>/`. Вам не нужна опция `base`, если вы выполняете развёртывание на личном домене, страницах пользователя или группы или если в GitLab включен параметр «Использовать уникальный домен».
1. Установите значение `../public` для параметра `outDir` в конфигурации VitePress. Настройте опцию `base` на `'/<репозиторий>/'`, если вы хотите развернуть ваш проект по адресу `https://<имя пользователя>.gitlab.io/<репозиторий>/`. Вам не нужна опция `base`, если вы выполняете развёртывание на личном домене, страницах пользователя или группы, или если в GitLab включен параметр «Использовать уникальный домен».

2. Создайте файл с именем `.gitlab-ci.yml` в корне вашего проекта с приведённым ниже содержимым. Это позволит создавать и развёртывать ваш сайт каждый раз, когда вы вносите изменения в его содержимое:

Expand Down
6 changes: 3 additions & 3 deletions docs/ru/guide/extending-default-theme.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,15 @@ outline: deep

# Расширение темы по умолчанию {#extending-the-default-theme}

Тема VitePress по умолчанию оптимизирована для документации и может быть настроена по своему усмотрению. Полный список опций можно найти в главе [Настройки темы по умолчанию](../reference/default-theme-config).
Тема VitePress по умолчанию оптимизирована для документации и может быть настроена по вашему усмотрению. Полный список опций можно найти в главе [Настройки темы по умолчанию](../reference/default-theme-config).

Однако есть ряд случаев, когда одной лишь конфигурации будет недостаточно. Например:

1. Вам нужно изменить стили CSS;
2. Вам нужно изменить экземпляр приложения Vue, например, чтобы зарегистрировать глобальные компоненты;
3. Вам нужно внедрить пользовательский контент в тему через слоты макета.

Эти расширенные настройки потребуют использования пользовательской темы, которая «расширяет» тема по умолчанию.
Эти расширенные настройки потребуют использования пользовательской темы, которая «расширяет» тему по умолчанию.

::: tip СОВЕТ
Прежде чем приступить к работе, обязательно прочитайте главу [Пользовательская тема](./custom-theme), чтобы понять, как работают пользовательские темы.
Expand Down Expand Up @@ -124,7 +124,7 @@ export default {
} satisfies Theme
```

Поскольку мы используем Vite, вы также можете использовать [глобальную функцию импорта](https://vitejs.dev/guide/features.html#glob-import) Vite для автоматической регистрации каталога компонентов.
Поскольку мы используем Vite, можно применять [глобальную функцию импорта](https://vitejs.dev/guide/features.html#glob-import) Vite для автоматической регистрации каталога компонентов.

## Слоты макета {#layout-slots}

Expand Down
2 changes: 1 addition & 1 deletion docs/ru/guide/frontmatter.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ editLink: true
---
```

Многие параметры конфигурации сайта или темы по умолчанию имеют соответствующие опции в блоке метаданных. Вы можете использовать метаданные, чтобы переопределить определённое поведение только для текущей страницы. Подробности см. в [Справочнике по настройке метаданных](../reference/frontmatter-config).
Многие параметры конфигурации сайта или темы по умолчанию имеют соответствующие опции в блоке метаданных. Вы можете использовать метаданные, чтобы переопределить заданное поведение только для текущей страницы. Подробности см. в [Справочнике по настройке метаданных](../reference/frontmatter-config).

Вы также можете определить собственные метаданные, которые будут использоваться в динамических выражениях Vue на странице.

Expand Down
8 changes: 4 additions & 4 deletions docs/ru/guide/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ VitePress — это пакет, предназначенный только д

### Мастер настройки {#setup-wizard}

VitePress поставляется с мастером настройки командной строки, который поможет вам создать базовый проект. После установки запустите мастер, запустив его:
VitePress поставляется с мастером настройки командной строки, который поможет вам создать базовый проект. После установки запустите мастер, выполнив команду:

::: code-group

Expand Down Expand Up @@ -133,13 +133,13 @@ export default {
}
```

Вы также можете настроить поведение темы с помощью опции `themeConfig`. Загляните в главу [Настройка сайта](../reference/site-config) для получения подробной информации обо всех параметрах конфигурации.
Вы также можете настроить поведение темы с помощью опции `themeConfig`. Загляните в главу [Конфигурация сайта](../reference/site-config) для получения подробной информации обо всех настраиваемых параметрах.

### Исходные файлы {#source-files}

Файлы Markdown за пределами директории `.vitepress` считаются **исходными файлами**.

VitePress использует **маршрутизацию на основе файлов**: Каждый файл `.md` компилируется в соответствующий файл `.html` с тем же путем. Например, `index.md` будет скомпилирован в `index.html`, и его можно будет посетить по корневому пути `/` результирующего сайта VitePress.
VitePress использует **маршрутизацию на основе файлов**: Каждый файл `.md` компилируется в соответствующий файл `.html` с тем же путём. Например, `index.md` будет скомпилирован в `index.html`, и его можно будет посетить по корневому пути `/` результирующего сайта VitePress.

VitePress также предоставляет возможность генерировать чистые URL-адреса, переписывать пути и динамически генерировать страницы. Всё это будет рассмотрено в [Руководстве по маршрутизации](./routing).

Expand All @@ -159,7 +159,7 @@ VitePress также предоставляет возможность гене
}
```

Скрипт `docs:dev` запустит локальный dev-сервер с мгновенными горячими обновлениями. Запустите его с помощью следующей команды:
Скрипт `docs:dev` запустит локальный dev-сервер с мгновенными горячими обновлениями. Выполните следующую команду:

::: code-group

Expand Down
Loading

0 comments on commit 6ea60f5

Please sign in to comment.