Skip to content

Commit

Permalink
Исправление ошибок в getting-started/configuration (#247)
Browse files Browse the repository at this point in the history
* fix: fix mistakes in getting-started/configuration

Signed-off-by: Evgeniy Gromin <[email protected]>

* Fix docs/1.getting-started/3.configuration.md

Co-authored-by: alexeyvokin <[email protected]>

* [autofix.ci] apply automated fixes

* [autofix.ci] apply automated fixes (attempt 2/3)

---------

Signed-off-by: Evgeniy Gromin <[email protected]>
Co-authored-by: Bochkarev Ivan <[email protected]>
Co-authored-by: alexeyvokin <[email protected]>
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
  • Loading branch information
4 people authored Jul 19, 2024
1 parent cea9446 commit ced774b
Showing 1 changed file with 18 additions and 18 deletions.
36 changes: 18 additions & 18 deletions docs/1.getting-started/3.configuration.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Настройка
description: Nuxt по умолчанию содержит в себе настройки, чтобы сделать процесс разработки продуктивным.
description: Nuxt по умолчанию настроен так, чтобы повысить вашу продуктивность.
navigation.icon: i-ph-gear-duotone
---

Expand Down Expand Up @@ -29,9 +29,9 @@ export default defineNuxtConfig({
Вам не обязательно использовать TypeScript, чтобы создать приложение с Nuxt. Однако, очень рекомендуется использовать расширение `.ts` для файла `nuxt.config`. Таким образом, вы можете воспользоваться подсказками в IDE, чтобы избежать опечаток и ошибок при изменении конфигурации.
::

### Переменные среды
### Переопределение окружения

Вы можете настроить полностью типизованные переопределения для каждой среды в вашем nuxt.config
Вы можете настроить полностью типизованные переопределения для каждого окружения в вашем nuxt.config

```ts twoslash [nuxt.config.ts]
export default defineNuxtConfig({
Expand All @@ -47,27 +47,27 @@ export default defineNuxtConfig({
```

::tip{icon="i-ph-video-duotone" to="https://www.youtube.com/watch?v=DFZI2iVCrNc" target="_blank"}
Посмотрите видео от Александра Лихтера о переменных среды в `nuxt.config.ts`.
Посмотрите видео от Александра Лихтера о переменных окружения в `nuxt.config.ts`.
::

::note
Если вы создаете слои, вы также можете использовать ключ `$meta` для предоставления метаданных, которые вы или пользователи вашего слоя можете использовать.
::

### Переменные среды и приватные токены
### Переменные окружения и приватные токены

API `runtimeConfig` предоставляет значения, такие как переменные среды для всего остального вашего приложения. По умолчанию эти ключи доступны только на стороне сервера. Но ключи в `runtimeConfig.public` доступны также и на стороне клиента.
API `runtimeConfig` предоставляет значения, такие как переменные окружения, для всего остального вашего приложения. По умолчанию эти ключи доступны только на сервере. Но ключи в `runtimeConfig.public` доступны также и на клиенте.

Эти значения должны быть определены в `nuxt.config` и могут быть переписаны с помощью переменных среды.
Эти значения должны быть определены в `nuxt.config` и могут быть переписаны с помощью переменных окружения.

::code-group

```ts twoslash [nuxt.config.ts]
export default defineNuxtConfig({
runtimeConfig: {
// Приватные ключи, доступные только на стороне сервера
// Приватные ключи, доступные только на сервере
apiSecret: '123',
// Ключи внутри public также доступны и на стороне клиента
// Ключи внутри public также доступны и на клиенте
public: {
apiBase: '/api'
}
Expand All @@ -82,7 +82,7 @@ NUXT_API_SECRET=api_secret_token

::

Эти переменные станут доступны для всего приложения с помощью composable-функции [`useRuntimeConfig()`](/docs/api/composables/use-runtime-config).
Эти переменные станут доступны для всего приложения с помощью композабла [`useRuntimeConfig()`](/docs/api/composables/use-runtime-config).

```vue [pages/index.vue]
<script setup lang="ts">
Expand All @@ -94,13 +94,13 @@ const runtimeConfig = useRuntimeConfig()

## Настройки приложения

Файл `app.config.ts`, находится в исходном каталоге (по умолчанию в корне проекта), используется для отображения общедоступных переменных, которые могут быть определены во время сборки. Вопреки опциям `runtimeConfig`, их нельзя переопределить с помощью переменных среды.
Файл `app.config.ts`, находится в исходной директории (по умолчанию в корне проекта), используется для отображения общедоступных переменных, которые могут быть определены во время сборки. Вопреки опциям `runtimeConfig`, их нельзя переопределить с помощью переменных среды.

Минимальный файл конфигурации экспортирует функцию `defineAppConfig`, которая содержит объект с вашей конфигурацией. Функция `defineNuxtConfig` доступна глобально без импорта.

```ts [app.config.ts]
export default defineAppConfig({
title: 'Hello Nuxt',
title: 'Привет Nuxt',
theme: {
dark: true,
colors: {
Expand All @@ -110,7 +110,7 @@ export default defineAppConfig({
})
```

Эти переменные станут доступны для всего остального приложения с помощью composable-функции [`useAppConfig`](/docs/api/composables/use-app-config).
Эти переменные станут доступны для всего остального приложения с помощью композабла [`useAppConfig`](/docs/api/composables/use-app-config).

```vue [pages/index.vue]
<script setup lang="ts">
Expand All @@ -122,9 +122,9 @@ const appConfig = useAppConfig()

## `runtimeConfig` против `app.config`

Как указано выше, `runtimeConfig` и `app.config` оба используются для предоставления переменных остальной части вашего приложения. Чтобы определить, следует ли вам использовать одно или другое, вот некоторые рекомендации:
Как указано выше, `runtimeConfig` и `app.config` используются для предоставления переменных остальной части вашего приложения. Вот некоторые рекомендации, чтобы определить, следует ли вам использовать одно или другое:

- `runtimeConfig`: Приватные или публичные токены, которые необходимо указать после сборки с использованием переменных среды.
- `runtimeConfig`: Приватные или публичные токены, которые необходимо указать после сборки с использованием переменных окружения.
- `app.config`: Публичные токены, которые определяются во время сборки, конфигурация веб-сайта - например, тема, заголовок и любая конфигурация проекта, которая не является конфиденциальной.

Feature | `runtimeConfig` | `app.config`
Expand All @@ -139,7 +139,7 @@ Feature | `runtimeConfig` | `app.config`

## Внешние конфигурационные файлы

Nuxt использует файл [`nuxt.config.ts`](/docs/guide/directory-structure/nuxt-config) как единственный источник правды и пропускает чтение внешних файлов конфигурации. В процессе создания вашего проекта вам может потребоваться настроить их. В следующей таблице представлены общие конфигурации и, где это применимо, как их можно настроить с помощью Nuxt.
Nuxt использует файл [`nuxt.config.ts`](/docs/guide/directory-structure/nuxt-config) как единственный источник истины и пропускает чтение внешних файлов конфигурации. В процессе создания вашего проекта вам может потребоваться настроить их. В следующей таблице представлены общие конфигурации и, где это применимо, как их можно настроить с помощью Nuxt.

Имя | Файл конфигурации | Как настроить
----------------------------------|-------------------------|------------------------------------------------------------------------------
Expand Down Expand Up @@ -201,9 +201,9 @@ export default defineNuxtConfig({

:read-more{to="/docs/api/configuration/nuxt-config#loaders"}

### Включить эксперементальные функции Vue
### Включить экспериментальные функции Vue

Вам может потребоваться включить эксперементальные функции во Vue, такие как `propsDestructure`. Nuxt предоставляет легкий путь сделать это в `nuxt.config.ts`, вне зависимости от того, какой сборщик вы используете:
Вам может потребоваться включить экспериментальные функции во Vue, такие как `propsDestructure`. Nuxt предоставляет легкий путь сделать это в `nuxt.config.ts`, вне зависимости от того, какой сборщик вы используете:

```ts twoslash [nuxt.config.ts]
export default defineNuxtConfig({
Expand Down

0 comments on commit ced774b

Please sign in to comment.