Merge pull request #311 from JonikUl/update-v4

Обновление документации nuxt v4

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

@@ -49,9 +49,9 @@ export default defineNuxtConfig({
 })
 ```
 
-To select an environment when running a Nuxt CLI command, simply pass the name to the `--envName` flag, like so: `nuxi build --envName myCustomName`.
+Чтобы выбрать окружение при запуске команды Nuxt CLI, просто передайте его имя во флаг `--envName`, например: `nuxi build --envName myCustomName`.
 
-To learn more about the mechanism behind these overrides, please refer to the `c12` documentation on [environment-specific configuration](https://github.com/unjs/c12?tab=readme-ov-file#environment-specific-configuration).
+Чтобы узнать больше о механизме, лежащем в основе этих переопределений, обратитесь к документации `c12` по [конфигурации, зависящей от окружения](https://github.com/unjs/c12?tab=readme-ov-file#environment-specific-configuration).
 
 ::tip{icon="i-ph-video" to="https://www.youtube.com/watch?v=DFZI2iVCrNc" target="_blank"}
 Посмотрите видео от Александра Лихтера о переменных окружения в `nuxt.config.ts`.

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

@@ -88,13 +88,13 @@ async function addTodo() {
 Узнайте больше о `$fetch`.
 ::
 
-### Pass Client Headers to the API
+### Передача клиентских заголовков в API
 
-During server-side-rendering, since the `$fetch` request takes place 'internally' within the server, it won't include the user's browser cookies.
+Во время рендеринга на сервере, поскольку запрос `$fetch` выполняется "внутри" сервера, он не будет включать файлы cookie браузера пользователя.
 
-We can use [`useRequestHeaders`](/docs/api/composables/use-request-headers) to access and proxy cookies to the API from server-side.
+Мы можем использовать [`useRequestHeaders`](/docs/api/composables/use-request-headers) для доступа и проксирования файлов cookie в API со стороны сервера.
 
-The example below adds the request headers to an isomorphic `$fetch` call to ensure that the API endpoint has access to the same `cookie` header originally sent by the user.
+В приведенном ниже примере заголовки запроса добавляются к изоморфному вызову `$fetch`, чтобы гарантировать, что эндпоинт API имеет доступ к тому же заголовку `cookie`, который изначально был отправлен пользователем.
 
 ```vue
 <script setup lang="ts">
@@ -107,7 +107,7 @@ async function getCurrentUser() {
 ```
 
 ::caution
-Be very careful before proxying headers to an external API and just include headers that you need. Not all headers are safe to be bypassed and might introduce unwanted behavior. Here is a list of common headers that are NOT to be proxied:
+Будьте очень осторожны, прежде чем проксировать заголовки на внешний API, и включайте только те заголовки, которые вам нужны. Не все заголовки безопасны, некоторые могут привести к нежелательному поведению. Вот список распространенных заголовков, которые НЕ следует проксировать:
 
 - `host`, `accept`
 - `content-length`, `content-md5`, `content-type`
@@ -116,7 +116,7 @@ Be very careful before proxying headers to an external API and just include head
 ::
 
 ::tip
-You can also use [`useRequestFetch`](/docs/api/composables/use-request-fetch) to proxy headers to the call automatically.
+Вы также можете использовать [`useRequestFetch`](/docs/api/composables/use-request-fetch) для автоматической передачи заголовков вызову.
 ::
 
 ## `useFetch`
@@ -129,7 +129,7 @@ const { data: count } = await useFetch('/api/count')
 </script>
 
 <template>
-  <p>Page visits: {{ count }}</p>
+  <p>Посещения страницы: {{ count }}</p>
 </template>
 ```
 

docs/2.guide/2.directory-structure/1.pages.md

@@ -1,6 +1,6 @@
 ---
 title: "pages"
-description: "Nuxt предоставляет маршрутизацию на основе файлов в вашем приложении."
+description: "Nuxt предоставляет маршрутизацию на основе файлов в приложении."
 head.title: "pages/"
 navigation.icon: i-ph-folder
 ---
@@ -226,21 +226,21 @@ definePageMeta({
 
 :link-example{to="/docs/examples/routing/pages"}
 
-## Route Groups
+## Группы маршрутов
 
-In some cases, you may want to group a set of routes together in a way which doesn't affect file-based routing. For this purpose, you can put files in a folder which is wrapped in parentheses - `(` and `)`.
+В некоторых случаях вам может понадобиться сгруппировать набор маршрутов таким образом, чтобы это не повлияло на маршрутизацию на основе файлов. Для этой цели вы можете поместить файлы в директорию, заключенную в скобки - `(` и `)`.
 
-For example:
+Например:
 
-```bash [Directory structure]
+```bash [Структура директории]
 -| pages/
 ---| index.vue
 ---| (marketing)/
 -----| about.vue
 -----| contact.vue
 ```
 
-This will produce `/`, `/about` and `/contact` pages in your app. The `marketing` group is ignored for purposes of your URL structure.
+Это создаст в приложении страницы `/`, `/about` и `/contact`. Группа `marketing` игнорируется в структуре URL-адреса.
 
 ## Мета-данные страницы
 

docs/2.guide/3.going-further/1.experimental-features.md

@@ -59,16 +59,16 @@ export default defineNuxtConfig({
 
 ## emitRouteChunkError
 
-Emits `app:chunkError` hook when there is an error loading vite/webpack chunks. Default behavior is to perform a reload of the new route on navigation to a new route when a chunk fails to load.
+Вызывает хук `app:chunkError`, когда происходит ошибка загрузки чанков vite/webpack. Поведение по умолчанию — выполнить перезагрузку нового маршрута при переходе на новый маршрут, когда чанк не загружается.
 
-If you set this to `'automatic-immediate'` Nuxt will reload the current route immediatly, instead of waiting for a navigation. This is useful for chunk errors that are not triggered by navigation, e.g., when your Nuxt app fails to load a [lazy component](/docs/guide/directory-structure/components#dynamic-imports). A potential downside of this behavior is undesired reloads, e.g., when your app does not need the chunk that caused the error.
+Если вы установите для этого параметра значение `'automatic-immediate'`, Nuxt немедленно перезагрузит текущий маршрут, вместо того чтобы ждать перехода. Это полезно при ошибках чанков, которые не вызваны навигацией, например, когда приложению Nuxt не удается загрузить [ленивый компонент](/docs/guide/directory-structure/components#dynamic-imports). Потенциальным недостатком такого поведения является нежелательная перезагрузка, например, когда приложению не нужен фрагмент, вызвавший ошибку.
 
 Вы можете отключить автоматическую обработку, установив значение `false`, или обрабатывать ошибки чанков вручную, установив значение `manual`.
 
 ```ts twoslash [nuxt.config.ts]
 export default defineNuxtConfig({
   experimental: {
-    emitRouteChunkError: 'automatic' // или 'automatic-immediate', 'manual' или false
+    emitRouteChunkError: 'automatic' // 'automatic-immediate', 'manual' или false
   }
 })
 ```
@@ -336,7 +336,7 @@ globalThis.Buffer = globalThis.Buffer || Buffer
 
 Это работает только со статическими данными или строками/массивами, а не с переменными или условными присваиваниями. Дополнительную информацию и контекст см. в [оригинальном issue](https://github.com/nuxt/nuxt/issues/24770).
 
-It is also possible to scan page metadata only after all routes have been registered in `pages:extend`. Then another hook, `pages:resolved` will be called. To enable this behavior, set `scanPageMeta: 'after-resolve'`.
+Также возможно сканировать метаданные страницы только после того, как все маршруты зарегистрированы в `pages:extend`. Затем будет вызван другой хук, `pages:resolved`. Чтобы включить это поведение, установите `scanPageMeta: 'after-resolve'`.
 
 Вы можете отключить эту возможность, если она вызывает проблемы в вашем проекте.
 

docs/3.api/2.composables/use-runtime-hook.md

@@ -1,6 +1,6 @@
 ---
 title: useRuntimeHook
-description: Registers a runtime hook in a Nuxt application and ensures it is properly disposed of when the scope is destroyed.
+description: Регистрирует в приложении runtime-хук и гарантирует, что он будет должным образом удален при уничтожении области видимости.
 links:
   - label: Source
     icon: i-simple-icons-github
@@ -9,7 +9,7 @@ links:
 ---
 
 ::important
-This composable is available in Nuxt v3.14+.
+Этот композабл доступен в Nuxt версии 3.14+.
 ::
 
 ```ts [signature]
@@ -19,25 +19,25 @@ function useRuntimeHook<THookName extends keyof RuntimeNuxtHooks>(
 ): void
 ```
 
-## Usage
+## Использование
 
-### Parameters
+### Параметры
 
-- `name`: The name of the runtime hook to register. You can see the full list of [runtime Nuxt hooks here](/docs/api/advanced/hooks#app-hooks-runtime).
-- `fn`: The callback function to execute when the hook is triggered. The function signature varies based on the hook name.
+- `name`: Имя runtime-хука для регистрации. Вы можете ознакомиться с полным списком [runtime-хуков Nuxt здесь](/docs/api/advanced/hooks#app-hooks-runtime).
+- `fn`: Функция обратного вызова, выполняемая при срабатывании хука. Сигнатура функции зависит от имени хука.
 
-### Returns
+### Возвращаемые значения
 
-The composable doesn't return a value, but it automatically unregisters the hook when the component's scope is destroyed.
+Композабл не возвращает значение, но он автоматически отменяет регистрацию хука, когда область действия компонента уничтожается.
 
-## Example
+## Пример
 
 ```vue twoslash [pages/index.vue]
 <script setup lang="ts">
-// Register a hook that runs every time a link is prefetched, but which will be
-// automatically cleaned up (and not called again) when the component is unmounted
+// Регистрирует хук, который запускается каждый раз при предварительной загрузке ссылки, но который будет
+// автоматически очищен (и не будет вызываться снова) при размонтировании компонента
 useRuntimeHook('link:prefetch', (link) => {
-  console.log('Prefetching', link)
+  console.log('Предзагрузка', link)
 })
 </script>
 ```

docs/3.api/6.advanced/1.hooks.md

@@ -52,8 +52,8 @@ description: Nuxt предоставляет мощную систему хук
 `build:manifest`            | `manifest`                                               | Вызывается во время построения манифеста с помощью Vite и webpack. Это позволяет настраивать манифест, который Nitro будет использовать для рендеринга тегов `<script>` и `<link>` в конечном HTML.
 `builder:generateApp`       | `options`                                                | Вызывается перед генерацией приложения.
 `builder:watch`             | `event, path`                                            | Вызывается во время сборки в режиме разработки, когда наблюдатель обнаруживает изменения в файле или директории проекта.
-`pages:extend`              | `pages`                                                  | Called after page routes are scanned from the file system.
-`pages:resolved`         | `pages`                    | Called after page routes have been augmented with scanned metadata.
+`pages:extend`              | `pages`                                                  | Вызывается после сканирования маршрутов страниц из файловой системы.
+`pages:resolved`         | `pages`                    | Вызывается после того, как маршруты страниц были дополнены отсканированными метаданными.
 `pages:routerOptions`       | `{ files: Array<{ path: string, optional?: boolean }> }` | Вызывается при разрешении файлов `router.options`. Элементы, находящиеся позже в массиве, переопределяют предыдущие.
 `server:devHandler`         | `handler`                                                | Вызывается при регистрации middleware на dev-сервере Nitro.
 `imports:sources`           | `presets`                                                | Вызывается при настройке, позволяя модулям расширять источники.