Skip to content

docs: [RU] Translation update #283

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 17 commits into from
May 30, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/ru/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ Vue.js — это фреймворк для создания приложени

Если вы интересуетесь серверным рендерингом только для того, чтобы улучшить SEO на нескольких маркетинговых страницах (например, `/`, `/about`, `/contact`, и т.д.), вам скорее всего будет достаточно __пререндеринга__. Вместо того, чтобы заставлять веб-сервер компилировать HTML на лету, пререндеринг просто сгенерирует статичные HTML-файлы для указанных маршрутов на этапе сборки. Преимуществом пререндеринга будет простота реализации, кроме того этот подход позволит вам оставить фронтенд полностью статичным.

Если вы используете Webpack, то для добавления пререндеринга достаточно установить плагин [prerender-spa-plugin](https://github.com/chrisvfritz/prerender-spa-plugin). Он был тщательно протестирован с приложениями Vue, а его [создатель](https://github.com/chrisvfritz) — член основной команды разработки Vue.
Если вы используете Webpack, то для добавления пререндеринга достаточно установить плагин [prerender-spa-plugin](https://github.com/chrisvfritz/prerender-spa-plugin). Он был тщательно протестирован с приложениями Vue.

## Об этом руководстве

Expand Down
6 changes: 3 additions & 3 deletions docs/ru/api/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ renderer.renderToString(vm, context?, callback?): ?Promise<string>
renderer.renderToStream(vm[, context]): stream.Readable
```

Рендерит экземпляр Vue в [Node.js readable stream](https://nodejs.org/dist/latest-v8.x/docs/api/stream.html#stream_readable_streams). Объект контекста опционален. Подробнее в разделе [Стриминг](../guide/streaming.md).
Рендерит экземпляр Vue в [Node.js readable stream](https://nodejs.org/dist/latest-v10.x/docs/api/stream.html#stream_readable_streams). Объект контекста опционален. Подробнее в разделе [Стриминг](../guide/streaming.md).

## Класс: BundleRenderer

Expand All @@ -78,7 +78,7 @@ bundleRenderer.renderToString([context, callback]): ?Promise<string>
bundleRenderer.renderToStream([context]): stream.Readable
```

Рендерит сборку в [Node.js readable stream](https://nodejs.org/dist/latest-v8.x/docs/api/stream.html#stream_readable_streams). Объект контекста опционален. Подробнее в разделе [Стриминг](../guide/streaming.md).
Рендерит сборку в [Node.js readable stream](https://nodejs.org/dist/latest-v10.x/docs/api/stream.html#stream_readable_streams). Объект контекста опционален. Подробнее в разделе [Стриминг](../guide/streaming.md).

## Опции рендерера

Expand Down Expand Up @@ -212,7 +212,7 @@ const renderer = createBundleRenderer(bundle, {

С опцией `runInNewContext: 'once'` (добавлено в версии 2.3.1+), сборка выполняется в отдельном контексте `global`, но только один раз при запуске. Это обеспечивает лучшую изоляцию кода приложения поскольку предотвращает случайно загрязнение объекта `global` серверного процесса. Предостережения заключаются в следующем:

1. Зависимости, которые изменяют `global` (например, полифиллы) не должны быть объявлены внешними зависимостями в этом режиме;
1. Зависимости, которые изменяют `global` (например, полифилы) не должны быть объявлены внешними зависимостями в этом режиме;
2. Значения, возвращаемые при выполнении сборки будут использовать разные глобальные конструкторы, например, ошибка внутри сборки не будет экземпляром `Error` в серверном процессе.

См. также: [Структура исходного кода](../guide/structure.md)
Expand Down
2 changes: 1 addition & 1 deletion docs/ru/guide/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ npm install vue vue-server-renderer --save

#### Примечания

- Рекомендуется использовать Node.js версии 6+.
- Рекомендуется использовать Node.js версии 10+.
- `vue-server-renderer` и `vue` должны иметь одинаковые версии.
- `vue-server-renderer` зависит от некоторых нативных модулей Node.js и поэтому может использоваться только в Node.js. Возможно в будущем мы предоставим более простую сборку, которая сможет быть запущена в других средах исполнения JavaScript.

Expand Down
4 changes: 2 additions & 2 deletions docs/ru/guide/build-config.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ module.exports = merge(baseConfig, {
externals: nodeExternals({
// не выделяйте зависимости, которые должны обрабатываться Webpack.
// здесь вы можете добавить больше типов файлов, например сырые *.vue файлы
// нужно также указывать белый список зависимостей изменяющих `global` (например, полифиллы)
// нужно также указывать белый список зависимостей изменяющих `global` (например, полифилы)
whitelist: /\.css$/
}),

Expand Down Expand Up @@ -64,7 +64,7 @@ const renderer = createBundleRenderer('/path/to/vue-ssr-server-bundle.json', {

Обратите внимание, что в параметре `externals` мы указываем белый список CSS файлов. Это связано с тем, что CSS, импортированный из зависимостей всё равно должен быть обработан Webpack. Если вы импортируете любые другие типы файлов, которые также полагаются на Webpack (например, `*.vue`, `*.sass`), вы должны их также добавить в белый список.

Если вы используете `runInNewContext: 'once'` или `runInNewContext: true`, вам также требуется добавить в белый список являются полифиллы, которые изменяют `global`, например `babel-polyfill`. Это связано с тем, что при использовании режима нового контекста, **код внутри серверной сборки имеет свой собственный объект `global`**. Поскольку это не будет нужно на сервере при использовании Node 7.6+, на самом деле проще просто импортировать его в клиентской точке входа.
Если вы используете `runInNewContext: 'once'` или `runInNewContext: true`, вам также требуется добавить в белый список являются полифилы, которые изменяют `global`, например `babel-polyfill`. Это связано с тем, что при использовании режима нового контекста, **код внутри серверной сборки имеет свой собственный объект `global`**. Поскольку это не будет нужно на сервере при использовании Node 7.6+, на самом деле проще просто импортировать его в клиентской точке входа.

## Конфигурация клиентской части

Expand Down
2 changes: 1 addition & 1 deletion docs/ru/guide/caching.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ export default {
}
```

Обратите внимание, что подлежащий кэшированию компонент **также должен определять уникальную опцию `name`**. С уникальным именем ключ кэша таким образом является компоненто-зависимым: вам не нужно беспокоиться о двух компонентах, возвращающих одинаковый ключ.
Обратите внимание, что подлежащий кэшированию компонент **также должен определять уникальную опцию `name`**. С уникальным именем ключ кэша таким образом является компонентно-зависимым: вам не нужно беспокоиться о двух компонентах, возвращающих одинаковый ключ.

Ключ, возвращаемый из `serverCacheKey` должен содержать достаточную информацию для представления формы результата рендеринга. Указанное выше является хорошей реализацией, если результат рендеринга определяется исключительно с помощью `props.item.id`. Однако, если элемент с таким же идентификатором может со временем меняться или результат рендеринга также зависит от других данных, вам необходимо изменить реализацию `serverCacheKey`, чтобы учитывать и другие переменные.

Expand Down
10 changes: 3 additions & 7 deletions docs/ru/guide/data.md
Original file line number Diff line number Diff line change
Expand Up @@ -240,7 +240,7 @@ export default {

// Только на стороне сервера
serverPrefetch () {
this.registerFoo()
this.$store.registerModule('foo', fooStoreModule)
return this.fooInc()
},

Expand All @@ -251,7 +251,8 @@ export default {
const alreadyIncremented = !!this.$store.state.foo

// Регистрируем модуль foo
this.registerFoo()
// Сохраняем предыдущее состояние, если оно внедрялось на стороне сервера
this.$store.registerModule('foo', fooStoreModule, { preserveState: true })

if (!alreadyIncremented) {
this.fooInc()
Expand All @@ -265,11 +266,6 @@ export default {
},

methods: {
registerFoo () {
// Сохраняем предыдущее состояние, если оно внедрялось на стороне сервера
this.$store.registerModule('foo', fooStoreModule, { preserveState: true })
},

fooInc () {
return this.$store.dispatch('foo/inc')
}
Expand Down
2 changes: 1 addition & 1 deletion docs/ru/guide/non-node.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

Для обоих вариантов необходимо сначала подготовить окружение создав моки для объектов `global` и `process`, с переменной `process.env.VUE_ENV` установленной в значение `"server"`, и переменной `process.env.NODE_ENV` установленной в значение `"development"` или `"production"`.

При использовании Nashorn также может потребоваться предоставить полифилл для `Promise` или `setTimeout` с использованием нативных таймеров Java.
При использовании Nashorn также может потребоваться предоставить полифил для `Promise` или `setTimeout` с использованием нативных таймеров Java.

Пример использования в php-v8js:

Expand Down