Skip to content

Commit

Permalink
feat(docs) Перевод документации Overview (#197)
Browse files Browse the repository at this point in the history
* feat(docs) Перевод документации Overview

* [autofix.ci] apply automated fixes

* Update docs/6.bridge/1.overview.md

Co-authored-by: Alex Peshkov <[email protected]>

* Update docs/6.bridge/1.overview.md

Co-authored-by: Alex Peshkov <[email protected]>

* Update docs/6.bridge/1.overview.md

Co-authored-by: Alex Peshkov <[email protected]>

* Update docs/6.bridge/1.overview.md

Co-authored-by: Evgeniy Gromin <[email protected]>

* Update docs/6.bridge/1.overview.md

Co-authored-by: Evgeniy Gromin <[email protected]>

---------

Co-authored-by: Ivan Bochkarev <[email protected]>
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
Co-authored-by: Alex Peshkov <[email protected]>
Co-authored-by: Evgeniy Gromin <[email protected]>
  • Loading branch information
5 people authored Jun 20, 2024
1 parent e3c9689 commit 693c858
Showing 1 changed file with 30 additions and 30 deletions.
60 changes: 30 additions & 30 deletions docs/6.bridge/1.overview.md
Original file line number Diff line number Diff line change
@@ -1,32 +1,32 @@
---
title: Overview
description: Reduce the differences with Nuxt 3 and reduce the burden of migration to Nuxt 3.
title: Обзор
description: Сократите разницу с Nuxt 3 и снизите нагрузку при миграции на Nuxt 3.
---

::note
If you're starting a fresh Nuxt 3 project, please skip this section and go to [Nuxt 3 Installation](/docs/getting-started/introduction).
Если вы начинаете новый проект Nuxt 3, пропустите этот раздел и перейдите к разделу [Установка Nuxt 3](/docs/getting-started/introduction).
::

::warning
Nuxt Bridge provides identical features to Nuxt 3 ([docs](/docs/guide/concepts/auto-imports)) but there are some limitations, notably that [`useAsyncData`](/docs/api/composables/use-async-data) and [`useFetch`](/docs/api/composables/use-fetch) composables are not available. Please read the rest of this page for details.
Nuxt Bridge предоставляет аналогичные функции Nuxt 3 ([документация](/docs/guide/concepts/auto-imports)), но есть некоторые ограничения, в частности, композаблы [`useAsyncData`](/docs/api/composables/use-async-data) и [`useFetch`](/docs/api/composables/use-fetch) недоступны. Пожалуйста, прочитайте остаток этой страницы для получения подробной информации.
::

Bridge is a forward-compatibility layer that allows you to experience many of the new Nuxt 3 features by simply installing and enabling a Nuxt module.
Bridge - это слой обратной совместимости, который позволяет вам использовать многие новые функции Nuxt 3, просто установив и включив модуль Nuxt.

Using Nuxt Bridge, you can make sure your project is (almost) ready for Nuxt 3 and you can gradually proceed with the transition to Nuxt 3.
Используя Nuxt Bridge, вы можете убедиться, что ваш проект (почти) готов к Nuxt 3, и вы можете постепенно переходить на него.

## First Step
## Первый шаг

### Upgrade Nuxt 2
### Обновление Nuxt 2

Make sure your dev server (`nuxt dev`) isn't running, remove any package lock files (`package-lock.json` and `yarn.lock`), and install the latest Nuxt 2 version:
Убедитесь, что ваш сервер разработки (`nuxt dev`) не работает, удалите любые файлы блокировки пакетов (`package-lock.json` и `yarn.lock`) и установите последнюю версию Nuxt 2:

```diff [package.json]
- "nuxt": "^2.16.3"
+ "nuxt": "^2.17.3"
```

Then, reinstall your dependencies:
Затем переустановите ваши зависимости:

::code-group

Expand All @@ -41,12 +41,12 @@ npm install
::

::note
Once the installation is complete, make sure both development and production builds are working as expected before proceeding.
После завершения установки убедитесь, что как сборка для разработки, так и для продакшена работают как ожидалось, прежде чем продолжать.
::

### Install Nuxt Bridge
### Установка Nuxt Bridge

Install `@nuxt/bridge` and `nuxi` as development dependencies:
Установите `@nuxt/bridge` и `nuxi` в качестве зависимостей для разработки:

::code-group

Expand All @@ -60,11 +60,11 @@ npm install -D @nuxt/bridge nuxi

::

### Update `nuxt.config`
### Обновите `nuxt.config`

Please make sure to avoid any CommonJS syntax such as `module.exports`, `require` or `require.resolve` in your config file. It will soon be deprecated and unsupported.
Пожалуйста, старайтесь избегать любого синтаксиса CommonJS, такого как `module.exports`, `require` или `require.resolve` в файле конфигурации. Это скоро будет объявлено устаревшим и не будет поддерживаться.

You can use static `import`, dynamic `import()` and `export default` instead. Using TypeScript by renaming to [`nuxt.config.ts`](/docs/guide/directory-structure/nuxt-config) is also possible and recommended.
Вместо этого вы можете использовать статический `import`, динамический `import()` и `export default`. Использование TypeScript путем переименования в [`nuxt.config.ts`](/docs/guide/directory-structure/nuxt-config) также возможно и рекомендуется.

```ts [nuxt.config.ts]
import { defineNuxtConfig } from '@nuxt/bridge'
Expand All @@ -74,9 +74,9 @@ export default defineNuxtConfig({
})
```

### Update Commands
### Обновите команды

The `nuxt` command should now be changed to the `nuxt2` command.
Команда `nuxt` теперь должна быть изменена на команду `nuxt2`.

```diff
{
Expand All @@ -91,31 +91,31 @@ The `nuxt` command should now be changed to the `nuxt2` command.
}
```

Try running `nuxt2` once here. You will see that the application works as before.
Попробуйте запустить `nuxt2` здесь один раз. Вы увидите, что приложение работает так же, как и раньше.

(If 'bridge' is set to false, your application will operate without any changes as before.)
(Если 'bridge' установлен в false, ваше приложение будет работать без изменений, как и раньше.)

## Upgrade Steps
## Шаги обновления

With Nuxt Bridge, the migration to Nuxt 3 can proceed in steps.
The below `Upgrade Steps` does not need to be done all at once.
С помощью Nuxt Bridge миграция на Nuxt 3 может проходить поэтапно.
Нижеприведенные `Шаги обновления` не нужно выполнять сразу.

- [TypeScript](/docs/bridge/typescript)

- [Migrate Legacy Composition API](/docs/bridge/bridge-composition-api)
- [Миграция устаревшего Composition API](/docs/bridge/bridge-composition-api)

- [Plugins and Middleware](/docs/bridge/plugins-and-middleware)
- [Плагины и Middleware](/docs/bridge/plugins-and-middleware)

- [Migrate New Composition API](/docs/bridge/nuxt3-compatible-api)
- [Миграция нового Composition API](/docs/bridge/nuxt3-compatible-api)

- [Meta Tags](/docs/bridge/meta)
- [Meta-теги](/docs/bridge/meta)

- [Runtime Config](/docs/bridge/runtime-config)
- [Конфигурация runtime](/docs/bridge/runtime-config)

- [Nitro](/docs/bridge/nitro)

- [Vite](/docs/bridge/vite)

## Migrate from CommonJS to ESM
## Миграция с CommonJS на ESM

Nuxt 3 natively supports TypeScript and ECMAScript Modules. Please check [Native ES Modules](/docs/guide/concepts/esm) for more info and upgrading.
Nuxt 3 изначально поддерживает TypeScript и модули ECMAScript. Пожалуйста, проверьте [Native ES Modules](/docs/guide/concepts/esm) для получения дополнительной информации и обновления.

0 comments on commit 693c858

Please sign in to comment.