@intlayer/docs 9.0.0-canary.4 → 9.0.0-canary.5

package/docs/ru/packages/intlayer/getMultilingualUrls.md

@@ -29,12 +29,28 @@ author: aymericzip
 
 ## Описание
 
+Функция `getMultilingualUrls` генерирует отображение многоязычных URL-адресов путём добавления префикса локали к заданному URL-адресу. Она может обрабатывать как абсолютные, так и относительные URL-адреса, применяя подходящий префикс локали на основе предоставленной конфигурации или значений по умолчанию.
+
+**Ключевые возможности:**
+
+- Требуется только 1 параметр: `url`
+- Опциональный объект `options` с параметрами `locales`, `defaultLocale` и `mode`
+- Использует конфигурацию интернационализации вашего проекта в качестве значений по умолчанию
+- Поддерживает несколько режимов маршрутизации: `prefix-no-default`, `prefix-all`, `no-prefix` и `search-params`
+- Возвращает объект отображения со всеми локалями в качестве ключей и соответствующими URL-адресами в качестве значений
+
+---
+
+## Описание
+
 Функция `getMultilingualUrls` генерирует отображение многоязычных URL, добавляя префикс с каждым поддерживаемым языком к заданному URL. Она может обрабатывать как абсолютные, так и относительные URL, применяя соответствующий префикс языка на основе предоставленной конфигурации или значений по умолчанию.
 
 ---
 
 ## Параметры
 
+## Параметры
+
 - `url: string`
   - **Описание**: Исходная строка URL, к которой будут добавлены префиксы языков.
   - **Тип**: `string`
@@ -54,6 +70,33 @@ author: aymericzip
   - **Тип**: `boolean`
   - **По умолчанию**: `prefixDefaultDefault`
 
+### Опциональные параметры
+
+- `options?: object`
+  - **Description**: Объект конфигурации для поведения локализации URL.
+  - **Type**: `object`
+  - **Required**: No (Optional)
+
+  - `options.locales?: Locales[]`
+    - **Description**: Массив поддерживаемых локалей. Если не предоставлен, использует настроенные локали из конфигурации вашего проекта.
+    - **Type**: `Locales[]`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md#middleware)
+
+  - `options.defaultLocale?: Locales`
+    - **Description**: Локаль по умолчанию для приложения. Если не предоставлена, использует настроенную локаль по умолчанию из конфигурации вашего проекта.
+    - **Type**: `Locales`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Description**: Режим маршрутизации URL для обработки локалей. Если не предоставлен, использует настроенный режим из конфигурации вашего проекта.
+    - **Type**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md#middleware)
+    - **Modes**:
+      - `prefix-no-default`: Без префикса для локали по умолчанию, с префиксом для всех остальных
+      - `prefix-all`: Префикс для всех локалей, включая локаль по умолчанию
+      - `no-prefix`: Без префикса локали в URL
+      - `search-params`: Использование параметров запроса для локали (например, `?locale=fr`)
+
 ### Возвращаемое значение
 
 - **Тип**: `IConfigLocales<string>`
@@ -63,6 +106,20 @@ author: aymericzip
 
 ## Пример использования
 
+### Базовое использование (использует конфигурацию проекта)
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getMultilingualUrls, Locales } from "intlayer";
+
+// Использует конфигурацию вашего проекта для локалей, defaultLocale и mode
+getMultilingualUrls("/dashboard");
+// Output (assuming project config has en, fr with mode 'prefix-no-default'):
+// {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard"
+// }
+```
+
 ### Относительные URL
 
 ```typescript codeFormat={["typescript", "esm", "commonjs"]}
@@ -97,6 +154,60 @@ getMultilingualUrls(
 
 ---
 
+### Различные режимы маршрутизации
+
+```typescript
+// prefix-no-default: Без префикса для локали по умолчанию
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// Output: {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// prefix-all: Префикс для всех локалей
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-all",
+});
+// Output: {
+//   en: "/en/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// no-prefix: Без префикса локали в URL-адресах
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "no-prefix",
+});
+// Output: {
+//   en: "/dashboard",
+//   fr: "/dashboard",
+//   es: "/dashboard"
+// }
+
+// search-params: Локаль в качестве параметра запроса
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params",
+});
+// Output: {
+//   en: "/dashboard?locale=en",
+//   fr: "/dashboard?locale=fr",
+//   es: "/dashboard?locale=es"
+// }
+```
+
+---
+
 ## Особые случаи
 
 - **Отсутствие сегмента языка:**

package/docs/ru/packages/next-intlayer/t.md

@@ -133,6 +133,40 @@ export const ServerComponentExample: FC = () => (
 
 ---
 
+### Встроенные переводы в атрибутах
+
+Функция `t` особенно полезна для встроенных переводов в атрибутах JSX.
+При локализации атрибутов, таких как `alt`, `title`, `href` или `aria-label`, вы можете использовать `t` непосредственно в атрибуте.
+
+```jsx
+<button
+  aria-label={t({
+    ru: "Отправить",
+    en: "Submit",
+    fr: "Soumettre",
+    es: "Enviar",
+  })}
+>
+  {t({
+    ru: "Отправить",
+    en: "Submit",
+    fr: "Soumettre",
+    es: "Enviar",
+  })}
+  <img
+    src="/path/to/image"
+    alt={t({
+      ru: "Красивый пейзаж",
+      en: "A beautiful scenery",
+      fr: "Un beau paysage",
+      es: "Un hermoso paisaje",
+    })}
+  />
+</button>
+```
+
+---
+
 ## Расширенные темы
 
 ### Интеграция с TypeScript

package/docs/ru/packages/react-intlayer/useDictionary.md

@@ -24,102 +24,6 @@ history:
 author: aymericzip
 ---
 
-# Интеграция с React: Документация по хуку `useDictionary`
-
-Этот раздел предоставляет подробные инструкции по использованию хука `useDictionary` в React-приложениях, позволяя эффективно работать с локализованным контентом без визуального редактора.
-
-## Импортирование `useDictionary` в React
-
-Хук `useDictionary` можно интегрировать в React-приложения, импортируя его в зависимости от контекста:
-
-- **Клиентский компонент:**
-
-  ```typescript codeFormat="typescript"
-  import { useDictionary } from "react-intlayer"; // Используется в клиентских React-компонентах
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useDictionary } from "react-intlayer"; // Используется в клиентских React-компонентах
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useDictionary } = require("react-intlayer"); // Используется в клиентских React-компонентах
-  ```
-
-- **Серверный компонент:**
-
-  ```typescript codeFormat="typescript"
-  import { useDictionary } from "react-intlayer/server"; // Используется в серверных React-компонентах
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useDictionary } from "react-intlayer/server"; // Используется в серверных React-компонентах
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useDictionary } = require("react-intlayer/server"); // Используется в серверных React-компонентах
-  ```
-
-## Параметры
-
-Хук принимает два параметра:
-
-1. **`dictionary`**: Объявленный объект словаря, содержащий локализованный контент для определённых ключей.
-2. **`locale`** (необязательный): Желаемая локаль. По умолчанию используется локаль текущего контекста.
-
-## Словарь
-
-Все объекты словарей должны быть объявлены в структурированных файлах контента для обеспечения типобезопасности и предотвращения ошибок во время выполнения. Вы можете найти [инструкции по настройке здесь](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md). Вот пример объявления контента:
-
-```typescript fileName="./component.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
-import { t, type Dictionary } from "intlayer";
-
-const componentContent = {
-  key: "component-example",
-  content: {
-    title: t({
-      en: "Client Component Example",
-      fr: "Exemple de composant client",
-      es: "Ejemplo de componente cliente",
-    }),
-    content: t({
-      en: "This is the content of a client component example",
-      fr: "Ceci est le contenu d'un exemple de composant client",
-      es: "Este es el contenido de un ejemplo de componente cliente",
-    }),
-  },
-} satisfies Dictionary;
-
-export default componentContent;
-```
-
-```json fileName="./component.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "component-example",
-  "content": {
-    "title": {
-      "nodeType": "translation",
-      "translation": {
-        "en": "Client Component Example",
-        "fr": "Exemple de composant client",
-        "es": "Ejemplo de componente cliente",
-        "ru": "Пример клиентского компонента"
-      }
-    },
-    "content": {
-      "nodeType": "translation",
-      "translation": {
-        "en": "This is the content of a client component example",
-        "fr": "Ceci est le contenu d'un exemple de composant client",
-        "es": "Este es el contenido de un ejemplo de componente cliente",
-        "ru": "Это содержимое примера клиентского компонента"
-      }
-    }
-  }
-}
-```
-
 ## Пример использования в React
 
 Ниже приведён пример использования хука `useDictionary` в React-компоненте:
@@ -162,14 +66,6 @@ const ServerComponentExample: FC<{ locale: string }> = ({ locale }) => {
 };
 ```
 
-## Примечания по атрибутам
-
-В отличие от интеграций с визуальными редакторами, такие атрибуты, как `buttonTitle.value`, здесь не применяются. Вместо этого напрямую обращайтесь к локализованным строкам, как они объявлены в вашем контенте.
-
-```jsx
-<button title={content.title}>{content.content}</button>
-```
-
 ## Дополнительные советы
 
 - **Типобезопасность**: Всегда используйте `Dictionary` для определения ваших словарей, чтобы обеспечить типобезопасность.

package/docs/ru/packages/react-intlayer/useIntlayer.md

@@ -29,49 +29,6 @@ author: aymericzip
 
 В этом разделе представлено подробное руководство по использованию хука `useIntlayer` в приложениях React, что позволяет эффективно локализовать контент.
 
-## Импорт `useIntlayer` в React
-
-Хук `useIntlayer` можно интегрировать в приложения React, импортируя его в зависимости от контекста:
-
-- **Клиентский компонент:**
-
-  ```typescript codeFormat="typescript"
-  import { useIntlayer } from "react-intlayer"; // Используется в клиентских компонентах React
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer"; // Используется в клиентских компонентах React
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer"); // Используется в клиентских компонентах React
-  ```
-
-- **Серверный компонент:**
-
-  ```typescript codeFormat="commonjs"
-  import { useIntlayer } from "react-intlayer/server"; // Используется в серверных компонентах React
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer/server"; // Используется в серверных компонентах React
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer/server"); // Используется в серверных компонентах React
-  ```
-
-## Параметры
-
-Хук принимает два параметра:
-
-1. **`key`**: Ключ словаря для получения локализованного контента.
-2. **`locale`** (необязательно): Желаемая локаль. По умолчанию используется локаль из контекста, если не указано.
-
-## Словарь
-
-Все ключи словаря должны быть объявлены в файлах декларации контента для повышения типобезопасности и избежания ошибок. Инструкции по настройке можно найти [здесь](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md).
-
 ## Пример использования в React
 
 Демонстрация использования хука `useIntlayer` в React-компоненте:
@@ -131,14 +88,6 @@ const ServerComponentExample = () => {
 };
 ```
 
-## Обработка атрибутов
-
-При локализации атрибутов корректно обращайтесь к значениям контента:
-
-```jsx
-<button title={content.buttonTitle.value}>{content.buttonText}</button>
-```
-
 ## Дополнительные ресурсы
 
 - **Визуальный редактор Intlayer**: Для более интуитивного управления контентом обратитесь к документации по визуальному редактору [здесь](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_visual_editor.md).

package/docs/ru/packages/react-intlayer/useLocale.md

@@ -72,6 +72,15 @@ export default LocaleSwitcher;
 
 ## Параметры и возвращаемые значения
 
+Когда вы вызываете хук `useLocale`, он возвращает объект, содержащий следующие свойства:
+
+- **`locale`**: Текущая локаль, установленная в React контексте.
+- **`defaultLocale`**: Основная локаль, определённая в конфигурации.
+- **`availableLocales`**: Список всех доступных локалей, определённых в конфигурации.
+- **`setLocale`**: Функция для обновления текущей локали в контексте приложения.
+
+## Параметры и возвращаемые значения
+
 При вызове хука `useLocale` он возвращает объект, содержащий следующие свойства:
 
 - **`locale`**: Текущая локаль, установленная в контексте React.

package/docs/ru/releases/v6.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Добро пожаловать в Intlayer v6! Этот релиз сосредоточен на производительности, опыте разработчика и надежности. Ниже приведены основные моменты, а также заметки по миграции и примеры для копирования.
 
+## Содержание
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Основные моменты
 
 - Новая команда: `npx intlayer content test` для обнаружения отсутствующих переводов
@@ -295,6 +299,24 @@ bun x intlayer live --with 'vite preview'
 
 ---
 
+## Параллельный процесс для отслеживания файлов на turbopack
+
+При использовании Turbopack на Next.js 14 и выше в качестве сервера разработки с командой `next dev --turbopack` изменения словарей не будут автоматически обнаруживаться по умолчанию.
+
+Это ограничение возникает потому, что Turbopack не может запускать webpack plugins параллельно для отслеживания изменений в ваших файлах контента.
+
+Чтобы обойти это, мы использовали команду `intlayer watch` с опцией `--with` для одновременного запуска сервера разработки и наблюдателя сборки Intlayer.
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    "dev": "npx intlayer watch --with 'next dev --turbopack'",
+  },
+}
+```
+
+---
+
 ## Заметки по миграции
 
 - Удалено: `dictionaryOutput` (ранее `i18next` или `next-intl`). Это вернется в виде подключаемых адаптеров в будущих версиях. Удалите это поле из вашей конфигурации.
@@ -313,6 +335,12 @@ bun x intlayer live --with 'vite preview'
 
 ---
 
+## Примечания миграции с v6 на v7
+
+Дополнительную информацию см. в [примечаниях миграции с v6 на v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/releases/v7.md).
+
+---
+
 ## Полезные ссылки
 
 - [Справочник CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/index.md)

package/docs/ru/releases/v7.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Добро пожаловать в Intlayer v7! Этот крупный релиз представляет значительные улучшения в производительности, безопасности типов и опыте разработчика. Ниже приведены основные моменты, а также заметки по миграции и практические примеры.
 
+## Оглавление
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Основные моменты
 
 - Стратегия кэширования для ускорения сборок
@@ -260,6 +264,126 @@ setLocale("en");
 
 ---
 
+## Автоматическое форматирование кода: конфигурация formatCommand
+
+v7 вводит опцию `formatCommand` в конфигурации редактора, позволяя вам автоматически форматировать файлы содержимого при их записи Intlayer. Это обеспечивает согласованный стиль кода и форматирование во всех файлах объявления контента.
+
+Если не установлено, Intlayer попытается автоматически определить команду форматирования. Путем попытки разрешить следующие команды: prettier, biome, eslint.
+
+### Конфигурация
+
+Опция `formatCommand` принимает строковый шаблон, где `{{file}}` будет заменена на фактический путь файла:
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    formatCommand: 'bun x biome format "{{file}}" --write --log-level none',
+  },
+};
+```
+
+### Поддерживаемые форматеры
+
+Вы можете использовать любой форматер кода, который принимает пути к файлам в качестве аргументов:
+
+**Using Biome:**
+
+```typescript
+formatCommand: 'bun x biome format "{{file}}" --write --log-level none';
+```
+
+**Using Prettier:**
+
+```typescript
+formatCommand: 'npx prettier --write "{{file}}" --log-level silent';
+```
+
+**Using ESLint:**
+
+```typescript
+formatCommand: 'npx eslint --fix "{{file}}" --quiet';
+```
+
+**Using Bun's built-in formatter:**
+
+```typescript
+formatCommand: 'bun format "{{file}}"';
+```
+
+### Преимущества
+
+- **Согласованное форматирование**: Все файлы содержимого автоматически форматируются в соответствии с рекомендациями стиля вашего проекта
+- **Опыт разработчика**: Нет необходимости вручную форматировать файлы после их создания Intlayer
+- **Согласованность команды**: Гарантирует, что все члены команды имеют одинаковое форматирование, применяемое к файлам содержимого
+- **Интеграция CI/CD**: Файлы содержимого сохраняют согласованное форматирование в автоматизированных рабочих процессах
+
+### Как это работает
+
+When Intlayer writes or updates a content declaration file (`.content.ts`, `.content.js`, etc.), it automatically runs the specified format command on the file. The `{{file}}` placeholder is replaced with the actual file path, and the command is executed in the project's base directory.
+
+---
+
+## Dictionary Configuration: Better organization and structure
+
+v7 представляет новый dedicated раздел конфигурации `dictionary`, который обеспечивает лучшую организацию параметров, связанных со словарем, и улучшенное управление содержимым.
+
+### Новая структура конфигурации словаря
+
+Свойство `fill` было перемещено из раздела `content` в новый раздел `dictionary`, обеспечивая более четкое разделение ответственности:
+
+**Конфигурация v6:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    autoFill: "./{{fileName}}.content.json",
+    contentDir: ["src"],
+  },
+};
+```
+
+**Конфигурация v7:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    contentDir: ["src"],
+  },
+  dictionary: {
+    fill: "./{{fileName}}.content.json",
+  },
+};
+```
+
+### Преимущества новой структуры
+
+- **Более четкая организация**: Параметры, характерные для словаря, теперь сгруппированы вместе
+- **Лучшее разделение ответственности**: Обнаружение содержимого и операции со словарем четко разделены
+- **Улучшенная поддерживаемость**: Легче понять и модифицировать конфигурации, связанные со словарем
+- **Будущая расширяемость**: Раздел словаря может вмещать дополнительные параметры, характерные для словаря
+- **Комплексное управление словарем**: Включает свойства, такие как `title`, `live`, `priority`, `tags`, `version` и `description` для создания и управления новыми словарями
+
+### Использование конфигурации
+
+Конфигурация словаря служит двум основным целям:
+
+1. **Значения по умолчанию**: Определение значений по умолчанию при создании файлов объявления контента
+2. **Поведение при отсутствии значения**: Предоставление резервных значений, когда определенные поля не определены, позволяя вам глобально определить поведение операций словаря
+
+Раздел словаря включает комплексные свойства для управления словарем:
+
+- **`fill`**: Поведение автозаполнения при генерации контента
+- **`title`**: Заголовок по умолчанию для новых словарей
+- **`live`**: Конфигурация синхронизации в реальном времени для обновлений
+- **`priority`**: Параметры приоритета для разрешения словаря
+- **`tags`**: Теги по умолчанию для организации контента
+- **`version`**: Управление версиями для обновлений словаря
+- **`description`**: Описание по умолчанию для нового контента
+
+Для получения дополнительной информации о файлах объявления контента и применении значений конфигурации см. [Документация по файлам контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/content_file.md).
+
+---
+
 ## Команда fill: обновленное поведение для лучшего управления контентом
 
 v7 вводит улучшенное поведение команды `fill`, обеспечивая более предсказуемое и гибкое управление контентом:
@@ -407,6 +531,10 @@ const content = {
 - **`middleware.prefixDefault`**: заменён на `routing.mode`
 - **`middleware.noPrefix`**: заменён на `routing.mode`
 
+### Новые конфигурации
+
+- **`editor.formatCommand`**: Новый параметр для автоматического форматирования кода файлов содержимого
+
 ### Сопоставление миграции
 
 #### Сопоставление конфигураций

package/docs/ru/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-14
+updatedAt: 2026-06-23
 title: Новый Intlayer v9 — Что нового?
 description: Узнайте, что нового в Intlayer v9. Представляем пакеты совместимости drop-in для популярных библиотек i18n, а также поддержку Collections, Variants и Dynamic Records.
 keywords:
@@ -216,6 +216,42 @@ export default {
 
 ---
 
+## Vite Plugin: Bundled Compiler & Proxy
+
+Plugin Vite `intlayer()` теперь объединяет **компилятор** и **proxy маршрутизации локалей** напрямую, поэтому большинству проектов нужен только один plugin в `vite.config.ts`:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compiler**: Активируется автоматически, когда задан параметр `compiler.enabled` и настроена путь `compiler.output`. Вам больше не нужно регистрировать `intlayerCompiler()` отдельно.
+- **Proxy**: Активируется автоматически на основе нового параметра `routing.enableProxy` (`true` по умолчанию). Он подключает middleware обнаружения локалей / перенаправления / переписи в разработке, preview и production SSR. Вам больше не нужно регистрировать `intlayerProxy()` отдельно.
+
+### Опция `routing.enableProxy`
+
+Новая опция `routing.enableProxy` контролирует, подключен ли прокси для маршрутизации локалей. По умолчанию установлено значение `true`. Отключите его, если вы хотите самостоятельно обрабатывать маршрутизацию локалей:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // По умолчанию: true
+  },
+};
+
+export default config;
+```
+
+Отдельные плагины `intlayerCompiler()` и `intlayerProxy()` остаются экспортированными для продвинутых конфигураций. Регистрация их вместе с `intlayer()` безопасна — каждый плагин дедублицирует себя и выполняется только один раз.
+
+---
+
 ## Примечания по миграции с v8
 
 Если вы обновляетесь с v8, обратите внимание, что v9 не содержит ломающих изменений (breaking changes). Однако вот ключевые изменения:

package/docs/ru/roadmap.md

@@ -29,6 +29,12 @@ Intlayer - это решение для управления контентом
 
 ---
 
+## Оглавление
+
+<TOC/>
+
+---
+
 ## Текущие возможности
 
 ### 1. Объявление контента

package/docs/tr/CI_CD.md

@@ -26,6 +26,10 @@ author: aymericzip
 
 Intlayer, içerik bildirim dosyalarınız için çevirilerin otomatik olarak oluşturulmasına izin verir. İş akışınıza bağlı olarak bunu başarmanın birden fazla yolu vardır.
 
+## İçindekiler
+
+<TOC/>
+
 ## CMS Kullanarak
 
 Intlayer ile, sadece tek bir yerel ayar yerel olarak bildirilirken, tüm çevirilerin CMS aracılığıyla uzaktan yönetildiği bir iş akışı benimseyebilirsiniz. Bu, içerik ve çevirileri kod tabanından tamamen ayırmaya izin verir, içerik editörleri için daha fazla esneklik sunar ve sıcak içerik yeniden yüklemesini etkinleştirir (değişiklikleri uygulamak için uygulamayı yeniden oluşturmaya gerek yoktur).