feat(docs) Перевод Nitro (#158)

* feat(docs) Перевод Nitro

* fix(docs) Исправление ссылок

* fix(docs) Исправление ссылок

* feat(docs) Исправил замечания после ревью

---------

Co-authored-by: Ivan Bochkarev <[email protected]>

docs/1.getting-started/5.seo-meta.md

@@ -99,7 +99,7 @@ const title = ref('Привет, мир!')
 </template>
 ```
 
-## Типы
+## Типы {#types}
 
 Ниже приведены нереактивные типы, используемые для [`useHead`](/docs/api/composables/use-head), [`app.head`](/docs/api/nuxt-config#head) и компонентов.
 ```ts

docs/1.getting-started/6.data-fetching.md

@@ -318,7 +318,7 @@ watch(() => route.path, (path) => {
 </script>
 ```
 
-#### Наблюдение
+#### Наблюдение {#watch}
 
 Чтобы повторно запускать функцию получения данных при каждом изменении других реактивных значений в вашем приложении, используйте опцию `watch`. Вы можете использовать ее для одного или нескольких _наблюдаемых_ элементов.
 
@@ -347,7 +347,7 @@ const { data, error, refresh } = await useFetch(`/api/users/${id.value}`, {
 
 Если вам нужно изменить URL на основе реактивного значения, вместо него лучше использовать [вычисляемый URL](#computed-url).
 
-#### Вычисляемый URL
+#### Вычисляемый URL {#computed-url}
 
 Иногда вам может потребоваться вычислить URL из реактивных значений и обновлять данные каждый раз, когда они меняются. Вместо того чтобы жонглировать данными, вы можете прикрепить каждый параметр как реактивное значение. Nuxt будет автоматически использовать реактивное значение и обновлять данные при каждом его изменении.
 
@@ -398,7 +398,7 @@ const { data, pending, status } = useLazyFetch(() => `/api/users/${id.value}`, {
 
 Если вам нужно принудительно обновлять данные при изменении других реактивных значений, вы также можете [следить за другими значениями](#watch).
 
-### Не срочно
+### Не срочно {#not-immediate}
 
 Композабл `useFetch` начнет получать данные в момент вызова. Вы можете предотвратить это, установив `immediate: false`, например, чтобы дождаться взаимодействия с пользователем.
 

docs/3.api/1.components/4.nuxt-link.md

@@ -136,7 +136,7 @@ links:
 Значения по умолчанию могут быть перезаписаны, см. раздел [перезапись значений по умолчанию](#overwriting-defaults), если вы хотите их изменить.
 ::
 
-## Перезапись значений по умолчанию
+## Перезапись значений по умолчанию {#overwriting-defaults}
 
 ### В Nuxt Config
 

docs/3.api/3.utils/define-page-meta.md

@@ -192,7 +192,7 @@ definePageMeta({
 </script>
 ```
 
-### Использование пользовательского регулярного выражения
+### Использование пользовательского регулярного выражения {#using-a-custom-regular-expression}
 
 Пользовательское регулярное выражение является хорошим способом разрешения конфликтов между пересекающимися маршрутами, например:
 

docs/3.api/5.kit/11.nitro.md

@@ -1,18 +1,18 @@
 ---
 title: "Nitro"
-description: Nuxt Kit provides a set of utilities to help you work with Nitro. These functions allow you to add server handlers, plugins, and prerender routes.
+description: Nuxt Kit предоставляет набор утилит, которые помогут вам работать с Nitro. Эти функции позволяют вам добавлять серверные обработчики, плагины и маршруты для предварительного рендеринга.
 links:
   - label: Исходники
     icon: i-simple-icons-github
     to: https://github.com/nuxt/nuxt/blob/main/packages/kit/src/nitro.ts
     size: xs
 ---
 
-Nitro is an open source TypeScript framework to build ultra-fast web servers. Nuxt 3 (and, optionally, Nuxt Bridge) uses Nitro as its server engine. You can use `useNitro` to access the Nitro instance, `addServerHandler` to add a server handler, `addDevServerHandler` to add a server handler to be used only in development mode, `addServerPlugin` to add a plugin to extend Nitro's runtime behavior, and `addPrerenderRoutes` to add routes to be prerendered by Nitro.
+Nitro - это TypeScript фреймворк с открытым исходный кодом для создания сверхбыстрых веб-серверов. Nuxt 3 (и, по желанию, Nuxt Bridge) использует Nitro в качестве своего серверного движка. Вы можете использовать `useNitro` для доступа к экземпляру Nitro, `addServerHandler` для добавления обработчика сервера, `addDevServerHandler` для добавления обработчика сервера, который будет использоваться только в режиме разработки, `addServerPlugin` для добавления плагина для расширения поведения Nitro во время выполнения и `addPrerenderRoutes` для добавления маршрутов для предварительного рендеринга Nitro.
 
 ## `addServerHandler`
 
-Adds a nitro server handler. Use it if you want to create server middleware or custom route.
+Добавляет обработчик сервера Nitro. Используйте его, если вы хотите создать серверную middleware или настраиваемый маршрут.
 
 ### Тип
 
@@ -36,37 +36,37 @@ export interface NitroEventHandler {
 
 **Обязательный**: `true`
 
-A handler object with the following properties:
+Объект обработчика со следующими свойствами:
 
-- `handler` (required)
+- `handler` (обязательный)
 
   **Тип**: `string`
 
-  Path to event handler.
+  Путь к обработчику событий.
 
 - `route` (опциональный)
 
   **Тип**: `string`
 
-  Path prefix or route. If an empty string used, will be used as a middleware.
+  Префикс пути или маршрут. Если используется пустая строка, то будет использоваться middleware.
 
 - `middleware` (опциональный)
 
   **Тип**: `boolean`
 
-  Specifies this is a middleware handler. Middleware are called on every route and should normally return nothing to pass to the next handlers.
+  Указывает, что это обработчик middleware. Middleware вызываются на каждом маршруте и обычно не должны возвращать ничего для передачи следующим обработчикам.
 
 - `lazy` (опциональный)
 
   **Тип**: `boolean`
 
-  Use lazy loading to import handler.
+  Использовать ленивую загрузку для импорта обработчика.
 
 - `method` (опциональный)
 
   **Тип**: `string`
 
-  Router method matcher. If handler name contains method name, it will be used as a default value.
+  Метод сопоставления маршрутизатора. Если имя обработчика содержит имя метода, оно будет использоваться в качестве значения по умолчанию.
 
 ### Примеры
 
@@ -100,7 +100,7 @@ export default defineEventHandler(() => {
 
 ## `addDevServerHandler`
 
-Adds a nitro server handler to be used only in development mode. This handler will be excluded from production build.
+Добавляет обработчик сервера Nitro, который будет использоваться только в режиме разработки. Этот обработчик будет исключен из сборки для продакшена.
 
 ### Тип
 
@@ -121,19 +121,19 @@ export interface NitroDevEventHandler {
 
 **Обязательный**: `true`
 
-A handler object with the following properties:
+Объект обработчика с следующими свойствами:
 
-- `handler` (required)
+- `handler` (обязательный)
 
   **Тип**: `string`
 
-  The event handler.
+  Обработчик события.
 
 - `route` (опциональный)
 
   **Тип**: `string`
 
-  Path prefix or route. If an empty string used, will be used as a middleware.
+  Префикс пути или маршрут. Если используется пустая строка, будет использоваться в качестве middleware.
 
 ### Примеры
 
@@ -149,7 +149,7 @@ export default defineNuxtModule({
     addDevServerHandler({
       handler: () => {
         return {
-          body: `Response generated at ${new Date().toISOString()}`
+          body: `Ответ, сгенерированный в ${new Date().toISOString()}`
         }
       },
       route: '/_handler'
@@ -180,14 +180,14 @@ export default defineNuxtModule({
 
 ## `useNitro`
 
-Returns the Nitro instance.
+Возвращает экземпляр Nitro.
 
 ::warning
-You can call `useNitro()` only after `ready` hook.
+Вы можете вызывать `useNitro()` только после хука `ready`.
 ::
 
 ::note
-Changes to the Nitro instance configuration are not applied.
+Изменения в конфигурации экземпляра Nitro не применяются.
 ::
 
 ### Тип
@@ -221,7 +221,7 @@ export default defineNuxtModule({
     nuxt.hook('ready', () => {
       const nitro = useNitro()
       if (nitro.options.static && nuxt.options.experimental.payloadExtraction === undefined) {
-        console.warn('Using experimental payload extraction for full-static output. You can opt-out by setting `experimental.payloadExtraction` to `false`.')
+        console.warn('Использование экспериментального извлечения полезной нагрузки для полностью статического вывода. Вы можете отказаться от этого, установив `experimental.payloadExtraction` в значение `false`.')
         nuxt.options.experimental.payloadExtraction = true
       }
       nitro.options.replace['process.env.NUXT_PAYLOAD_EXTRACTION'] = String(!!nuxt.options.experimental.payloadExtraction)
@@ -237,10 +237,10 @@ export default defineNuxtModule({
 
 ## `addServerPlugin`
 
-Add plugin to extend Nitro's runtime behavior.
+Добавление плагина для расширения runtime-поведения Nitro.
 
 ::tip
-You can read more about Nitro plugins in the [Nitro documentation](https://nitro.unjs.io/guide/plugins).
+Вы можете прочитать больше о плагинах Nitro в [Nitro документации](https://nitro.unjs.io/guide/plugins).
 ::
 
 ### Тип
@@ -257,7 +257,7 @@ function addServerPlugin (plugin: string): void
 
 **Обязательный**: `true`
 
-Path to the plugin. The plugin must export a function that accepts Nitro instance as an argument.
+Путь к плагину. Плагин должен экспортировать функцию, принимающую экземпляр Nitro в качестве аргумента.
 
 ### Примеры
 
@@ -277,15 +277,15 @@ export default defineNuxtModule({
 ```ts [runtime/plugin.ts]
 export default defineNitroPlugin((nitroApp) => {
   nitroApp.hooks.hook("request", (event) => {
-    console.log("on request", event.path);
+    console.log("при запросе", event.path);
   });
 
   nitroApp.hooks.hook("beforeResponse", (event, { body }) => {
-    console.log("on response", event.path, { body });
+    console.log("при ответе", event.path, { body });
   });
 
   nitroApp.hooks.hook("afterResponse", (event, { body }) => {
-    console.log("on after response", event.path, { body });
+    console.log("после ответа", event.path, { body });
   });
 });
 ```
@@ -310,7 +310,7 @@ function function addPrerenderRoutes (routes: string | string[]): void
 
 **Обязательный**: `true`
 
-A route or an array of routes to prerender.
+Добавляет маршруты для предварительного рендеринга в Nitro.
 
 ### Примеры
 
@@ -336,7 +336,7 @@ export default defineNuxtModule({
 
 ## `addServerImportsDir`
 
-Add a directory to be scanned for auto-imports by Nitro.
+Добавьте директорию, которая будет сканироваться Nitro на предмет автоимпорта.
 
 ### Тип
 
@@ -352,7 +352,7 @@ function addServerImportsDir (dirs: string | string[], opts: { prepend?: boolean
 
 **Обязательный**: `true`
 
-A directory or an array of directories to register to be scanned by Nitro
+Директория или массив директорий, которые необходимо зарегистрировать для сканирования Nitro
 
 ### Примеры
 
@@ -373,8 +373,8 @@ export default defineNuxtModule({
 
 ## `addServerScanDir`
 
-Add directories to be scanned by Nitro. It will check for subdirectories, which will be registered
-just like the `~/server` folder is.
+Добавьте директории, которые будут сканироваться Nitro. Nitro будет проверять подкаталоги, которые будут зарегистрированы
+так же, как и папка `~/server`.
 
 ### Тип
 
@@ -390,7 +390,7 @@ function addServerScanDir (dirs: string | string[], opts: { prepend?: boolean })
 
 **Обязательный**: `true`
 
-A directory or an array of directories to register to be scanned for by Nitro as server dirs.
+Директория или массив директорий, которые Nitro хочет зарегистрировать в качестве серверных директорий.
 
 ### Примеры
 

docs/3.api/5.kit/4.autoimports.md

@@ -57,7 +57,7 @@ interface Import {
 
 An object or an array of objects with the following properties:
 
-- `from` (required)
+- `from` (обязательный)
 
   **Тип**: `string`
 
@@ -113,7 +113,7 @@ An object or an array of objects with the following properties:
 
   Using this as the from when generating type declarations.
 
-- `name` (required)
+- `name` (обязательный)
 
   **Тип**: `string`
 
@@ -235,15 +235,15 @@ type PresetImport = Omit<Import, 'from'> | string | [name: string, as?: string,
 
 An object or an array of objects with the following properties:
 
-- `imports` (required)
+- `imports` (обязательный)
 
   **Тип**: `PresetImport | ImportSource[]`
 
   **Обязательный**: `true`
 
   An object or an array of objects, which can be import names, import objects or import sources.
 
-- `from` (required)
+- `from` (обязательный)
 
   **Тип**: `string`
 
@@ -299,7 +299,7 @@ An object or an array of objects with the following properties:
 
   Using this as the from when generating type declarations.
 
-- `name` (required)
+- `name` (обязательный)
 
   **Тип**: `string`
 

docs/3.api/5.kit/5.components.md

@@ -73,7 +73,7 @@ interface Component {
 
 An object with the following properties:
 
-- `path` (required)
+- `path` (обязательный)
 
   **Тип**: `string`
 
@@ -214,13 +214,13 @@ interface AddComponentOptions {
 
 An object with the following properties:
 
-- `name` (required)
+- `name` (обязательный)
 
   **Тип**: `string`
 
   Component name.
 
-- `filePath` (required)
+- `filePath` (обязательный)
 
   **Тип**: `string`
 

docs/3.api/5.kit/7.pages.md

@@ -222,13 +222,13 @@ interface AddRouteMiddlewareOptions {
 
 A middleware object or an array of middleware objects with the following properties:
 
-- `name` (required)
+- `name` (обязательный)
 
   **Тип**: `string`
 
   Middleware name.
 
-- `path` (required)
+- `path` (обязательный)
 
   **Тип**: `string`
 

docs/3.api/5.kit/9.plugins.md

@@ -42,7 +42,7 @@ interface AddPluginOptions { append?: boolean }
 
 A plugin object or a string with the path to the plugin. If a string is provided, it will be converted to a plugin object with `src` set to the string value. If a plugin object is provided, it must have the following properties:
 
-- `src` (required)
+- `src` (обязательный)
 
   **Тип**: `string`