diff --git a/docs/6.bridge/1.overview.md b/docs/6.bridge/1.overview.md index 8f3a018b2448..a933391126a4 100644 --- a/docs/6.bridge/1.overview.md +++ b/docs/6.bridge/1.overview.md @@ -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 @@ -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 @@ -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' @@ -74,9 +74,9 @@ export default defineNuxtConfig({ }) ``` -### Update Commands +### Обновите команды -The `nuxt` command should now be changed to the `nuxt2` command. +Команда `nuxt` теперь должна быть изменена на команду `nuxt2`. ```diff { @@ -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) для получения дополнительной информации и обновления.