@intlayer/docs 6.1.5 → 6.1.6

package/docs/ru/intlayer_with_vite+preact.md

@@ -1052,38 +1052,38 @@ const App = () => (
 module.exports = App;
 ```
 
-Параллельно вы также можете использовать `intlayerMiddlewarePlugin` для добавления маршрутизации на стороне сервера в ваше приложение. Этот плагин автоматически определит текущую локаль на основе URL и установит соответствующее cookie с локалью. Если локаль не указана, плагин определит наиболее подходящую локаль на основе языковых предпочтений браузера пользователя. Если локаль не будет обнаружена, произойдет перенаправление на локаль по умолчанию.
+Параллельно вы также можете использовать `intlayerMiddleware` для добавления маршрутизации на стороне сервера в ваше приложение. Этот плагин автоматически определит текущую локаль на основе URL и установит соответствующее cookie с локалью. Если локаль не указана, плагин определит наиболее подходящую локаль на основе языковых предпочтений браузера пользователя. Если локаль не будет обнаружена, произойдет перенаправление на локаль по умолчанию.
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat="typescript"
 import { defineConfig } from "vite";
 import preact from "@preact/preset-vite";
-import { intlayer, intlayerMiddlewarePlugin } from "vite-intlayer";
+import { intlayer, intlayerMiddleware } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [preact(), intlayer(), intlayerMiddlewarePlugin()],
+  plugins: [preact(), intlayer(), intlayerMiddleware()],
 });
 ```
 
 ```javascript {3,7} fileName="vite.config.mjs" codeFormat="esm"
 import { defineConfig } from "vite";
 import preact from "@preact/preset-vite";
-import { intlayer, intlayerMiddlewarePlugin } from "vite-intlayer";
+import { intlayer, intlayerMiddleware } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [preact(), intlayer(), intlayerMiddlewarePlugin()],
+  plugins: [preact(), intlayer(), intlayerMiddleware()],
 });
 ```
 
 ```javascript {3,7} fileName="vite.config.cjs" codeFormat="commonjs"
 const { defineConfig } = require("vite");
 const preact = require("@preact/preset-vite");
-const { intlayer, intlayerMiddlewarePlugin } = require("vite-intlayer");
+const { intlayer, intlayerMiddleware } = require("vite-intlayer");
 
 // https://vitejs.dev/config/
 module.exports = defineConfig({
-  plugins: [preact(), intlayer(), intlayerMiddlewarePlugin()],
+  plugins: [preact(), intlayer(), intlayerMiddleware()],
 });
 ```
 
@@ -1635,9 +1635,9 @@ module.exports = { LocalizedLink, checkIsExternalLink };
 
 Intlayer использует расширение модулей (module augmentation), чтобы получить преимущества TypeScript и сделать вашу кодовую базу более надежной.
 
-![alt text](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png)
+![Autocompletion](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)
 
-![alt text](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png)
+![Translation error](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png?raw=true)
 
 Убедитесь, что ваша конфигурация TypeScript включает автоматически сгенерированные типы.
 

package/docs/ru/intlayer_with_vite+react.md

@@ -1008,38 +1008,38 @@ const App = () => (
 );
 ```
 
-Параллельно вы также можете использовать `intlayerMiddlewarePlugin` для добавления маршрутизации на стороне сервера в ваше приложение. Этот плагин автоматически определит текущую локаль на основе URL и установит соответствующее cookie с локалью. Если локаль не указана, плагин определит наиболее подходящую локаль на основе языковых предпочтений браузера пользователя. Если локаль не будет обнаружена, произойдет перенаправление на локаль по умолчанию.
+Параллельно вы также можете использовать `intlayerMiddleware` для добавления маршрутизации на стороне сервера в ваше приложение. Этот плагин автоматически определит текущую локаль на основе URL и установит соответствующее cookie с локалью. Если локаль не указана, плагин определит наиболее подходящую локаль на основе языковых предпочтений браузера пользователя. Если локаль не будет обнаружена, произойдет перенаправление на локаль по умолчанию.
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat="typescript"
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-import { intlayer, intlayerMiddlewarePlugin } from "vite-intlayer";
+import { intlayer, intlayerMiddleware } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [react(), intlayer(), intlayerMiddlewarePlugin()],
+  plugins: [react(), intlayer(), intlayerMiddleware()],
 });
 ```
 
 ```javascript {3,7} fileName="vite.config.mjs" codeFormat="esm"
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-import { intlayer, intlayerMiddlewarePlugin } from "vite-intlayer";
+import { intlayer, intlayerMiddleware } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [react(), intlayer(), intlayerMiddlewarePlugin()],
+  plugins: [react(), intlayer(), intlayerMiddleware()],
 });
 ```
 
 ```javascript {3,7} fileName="vite.config.cjs" codeFormat="commonjs"
 const { defineConfig } = require("vite");
 const react = require("@vitejs/plugin-react-swc");
-const { intlayer, intlayerMiddlewarePlugin } = require("vite-intlayer");
+const { intlayer, intlayerMiddleware } = require("vite-intlayer");
 
 // https://vitejs.dev/config/
 module.exports = defineConfig({
-  plugins: [react(), intlayer(), intlayerMiddlewarePlugin()],
+  plugins: [react(), intlayer(), intlayerMiddleware()],
 });
 ```
 
@@ -1603,9 +1603,9 @@ Link.displayName = "Link";
 
 Intlayer использует расширение модулей (module augmentation), чтобы использовать преимущества TypeScript и сделать вашу кодовую базу более надежной.
 
-![alt text](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png)
+![Autocompletion](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)
 
-![alt text](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png)
+![Translation error](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png?raw=true)
 
 Убедитесь, что ваша конфигурация TypeScript включает автоматически сгенерированные типы.
 

package/docs/ru/intlayer_with_vite+vue.md

@@ -675,46 +675,46 @@ import LocaleSwitcher from "@components/LocaleSwitcher.vue"; // Импорт п
 </template>
 ```
 
-Параллельно вы также можете использовать `intlayerMiddlewarePlugin` для добавления маршрутизации на стороне сервера в ваше приложение. Этот плагин автоматически определит текущую локаль на основе URL и установит соответствующий cookie с локалью. Если локаль не указана, плагин определит наиболее подходящую локаль на основе языковых предпочтений браузера пользователя. Если локаль не будет обнаружена, произойдет перенаправление на локаль по умолчанию.
+Параллельно вы также можете использовать `intlayerMiddleware` для добавления маршрутизации на стороне сервера в ваше приложение. Этот плагин автоматически определит текущую локаль на основе URL и установит соответствующий cookie с локалью. Если локаль не указана, плагин определит наиболее подходящую локаль на основе языковых предпочтений браузера пользователя. Если локаль не будет обнаружена, произойдет перенаправление на локаль по умолчанию.
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat="typescript"
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-import { intlayer, intlayerMiddlewarePlugin } from "vite-intlayer";
+import { intlayer, intlayerMiddleware } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [vue(), intlayer(), intlayerMiddlewarePlugin()],
+  plugins: [vue(), intlayer(), intlayerMiddleware()],
 });
 ```
 
 ```javascript {3,7} fileName="vite.config.mjs" codeFormat="esm"
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-import { intlayer, intlayerMiddlewarePlugin } from "vite-intlayer";
+import { intlayer, intlayerMiddleware } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [vue(), intlayer(), intlayerMiddlewarePlugin()],
+  plugins: [vue(), intlayer(), intlayerMiddleware()],
 });
 ```
 
 ```javascript {3,7} fileName="vite.config.cjs" codeFormat="commonjs"
 const { defineConfig } = require("vite");
 const vue = require("@vitejs/plugin-vue");
-const { intlayer, intlayerMiddlewarePlugin } = require("vite-intlayer");
+const { intlayer, intlayerMiddleware } = require("vite-intlayer");
 
 // https://vitejs.dev/config/
 module.exports = defineConfig({
-  plugins: [vue(), intlayer(), intlayerMiddlewarePlugin()],
+  plugins: [vue(), intlayer(), intlayerMiddleware()],
 });
 const { defineConfig } = require("vite");
 const vue = require("@vitejs/plugin-vue");
-const { intlayer, intlayerMiddlewarePlugin } = require("vite-intlayer");
+const { intlayer, intlayerMiddleware } = require("vite-intlayer");
 
 // https://vitejs.dev/config/
 module.exports = defineConfig({
-  plugins: [vue(), intlayer(), intlayerMiddlewarePlugin()],
+  plugins: [vue(), intlayer(), intlayerMiddleware()],
 });
 ```
 
@@ -1019,9 +1019,9 @@ const { myMarkdownContent } = useIntlayer("my-component");
 
 Intlayer использует расширение модулей (module augmentation), чтобы использовать преимущества TypeScript и сделать ваш код более надежным.
 
-![alt text](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png)
+![Autocompletion](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)
 
-![alt text](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png)
+![Translation error](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png?raw=true)
 
 Убедитесь, что ваша конфигурация TypeScript включает автоматически сгенерированные типы.
 

package/docs/ru/vs_code_extension.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-03-17
-updatedAt: 2025-09-22
+updatedAt: 2025-09-30
 title: Официальное расширение VS Code
 description: Узнайте, как использовать расширение Intlayer в VS Code для улучшения вашего рабочего процесса разработки. Быстро переходите между локализованным контентом и эффективно управляйте своими словарями.
 keywords:
@@ -21,94 +21,38 @@ slugs:
 
 ## Обзор
 
-[**Intlayer**](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension) — официальное расширение Visual Studio Code для **Intlayer**, созданное для улучшения опыта разработчика при работе с локализованным контентом в ваших проектах.
+[**Intlayer**](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension) — официальное расширение Visual Studio Code для **Intlayer**, разработанное для улучшения опыта разработчика при работе с локализованным контентом в ваших проектах.
 
-![Расширение Intlayer для VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vs_code_extension_demo.gif)
+![Расширение Intlayer для VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vs_code_extension_demo.gif?raw=true)
 
 Ссылка на расширение: [https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)
 
 ## Возможности
 
-### Мгновенная навигация
+![Заполнение словарей](https://github.com/aymericzip/intlayer-vs-code-extension/blob/master/assets/vscode_extention_fill_active_dictionary.gif?raw=true)
 
-**Поддержка перехода к определению** – Используйте `⌘ + Click` (Mac) или `Ctrl + Click` (Windows/Linux) по ключу `useIntlayer`, чтобы мгновенно открыть соответствующий файл с контентом.  
-**Бесшовная интеграция** – Работает без усилий с проектами на **react-intlayer** и **next-intlayer**.  
-**Поддержка нескольких языков** – Поддерживает локализованный контент на разных языках.  
-**Интеграция с VS Code** – Плавно интегрируется с навигацией и палитрой команд VS Code.
+- **Мгновенная навигация** – Быстрый переход к нужному файлу контента при клике на ключ `useIntlayer`.
+- **Заполнение словарей** – Заполнение словарей контентом из вашего проекта.
 
-### Команды управления словарями
+![Список команд](https://github.com/aymericzip/intlayer-vs-code-extension/blob/master/assets/vscode_extention_list_commands.gif?raw=true)
 
-Управляйте своими словарями контента прямо из VS Code:
+- **Простой доступ к командам Intlayer** – Легко собирайте, отправляйте, загружайте, заполняйте и тестируйте словари контента.
 
-- **Сборка словарей** – Генерируйте файлы контента на основе структуры вашего проекта.
-- **Отправка словарей** – Загружайте актуальное содержимое словарей в ваш репозиторий.
-- **Получение словарей** – Синхронизируйте актуальное содержимое словарей из репозитория с вашей локальной средой.
-- **Заполнение словарей** – Заполняйте словари контентом из вашего проекта.
-- **Тестирование словарей** – Определяйте отсутствующие или неполные переводы.
+![Создание файла контента](https://github.com/aymericzip/intlayer-vs-code-extension/blob/master/assets/vscode_extention_create_content_file.gif?raw=true)
 
-### Генератор деклараций контента
+- **Генератор деклараций контента** – Создавайте файлы словарей контента в различных форматах (`.ts`, `.esm`, `.cjs`, `.json`).
 
-Легко генерируйте структурированные файлы словарей в различных форматах:
+![Тестирование словарей](https://github.com/aymericzip/intlayer-vs-code-extension/blob/master/assets/vscode_extention_test_missing_dictionary.gif?raw=true)
 
-Если вы сейчас работаете над компонентом, он сгенерирует для вас файл `.content.{ts,tsx,js,jsx,mjs,cjs,json}`.
+- **Тестирование словарей** – Проверяйте словари на наличие отсутствующих переводов.
 
-Пример компонента:
+![Пересобрать словарь](https://github.com/aymericzip/intlayer-vs-code-extension/blob/master/assets/vscode_extention_rebuild_dictionary.gif?raw=true)
 
-```tsx fileName="src/components/MyComponent/index.tsx"
-const MyComponent = () => {
-  const { myTranslatedContent } = useIntlayer("my-component");
+- **Держите ваши словари в актуальном состоянии** – Обновляйте словари с последним содержимым из вашего проекта.
 
-  return <span>{myTranslatedContent}</span>;
-};
-```
-
-Сгенерированный файл в формате TypeScript:
-
-```tsx fileName="src/components/MyComponent/index.content.ts"
-import { t, type Dictionary } from "intlayer";
-
-const componentContent = {
-  key: "my-component",
-  content: {
-    myTranslatedContent: t({
-      en: "Hello World",
-      es: "Hola Mundo",
-      fr: "Bonjour le monde",
-    }),
-  },
-};
-
-export default componentContent;
-```
-
-Доступные форматы:
-
-- **TypeScript (`.ts`)**
-- **ES Module (`.esm`)**
-- **CommonJS (`.cjs`)**
-- **JSON (`.json`)**
-
-### Вкладка Intlayer (Панель активности)
+![Вкладка Intlayer (Панель активности)](https://github.com/aymericzip/intlayer-vs-code-extension/blob/master/assets/vscode_extention_search_dictionary.gif?raw=true)
 
-Откройте вкладку Intlayer, нажав на значок Intlayer в панели активности VS Code. Она содержит два представления:
-
-- **Поиск**: Живая строка поиска для быстрого фильтра словарей и их содержимого. При вводе результаты обновляются мгновенно.
-- **Словари**: Древовидное представление ваших окружений/проектов, ключей словарей и файлов, вносящих записи. Вы можете:
-  - Кликнуть по файлу, чтобы открыть его в редакторе.
-  - Использовать панель инструментов для выполнения действий: Build, Pull, Push, Fill, Refresh, Test и Create Dictionary File.
-  - Использовать контекстное меню для действий, специфичных для элемента:
-    - Для словаря: Pull или Push
-    - Для файла: Fill Dictionary
-  - При переключении редакторов дерево покажет соответствующий файл, если он принадлежит словарю.
-
-## Установка
-
-Вы можете установить **Intlayer** напрямую из Marketplace VS Code:
-
-1. Откройте **VS Code**.
-2. Перейдите в **Marketplace расширений**.
-3. Найдите **"Intlayer"**.
-4. Нажмите **Установить**.
+- **Вкладка Intlayer (Панель активности)** – Просматривайте и ищите словари через специальную боковую вкладку с панелью инструментов и контекстными действиями (Сборка, Загрузка, Отправка, Заполнение, Обновление, Тестирование, Создание файла).
 
 ## Использование
 
@@ -121,63 +65,58 @@ export default componentContent;
    const content = useIntlayer("app");
    ```
 
-3. Выполните **Command-click** (`⌘+Click` на macOS) или **Ctrl+Click** (на Windows/Linux) по ключу (например, `"app"`).
+3. **Командный клик** (`⌘+Click` на macOS) или **Ctrl+Click** (на Windows/Linux) по ключу (например, `"app"`).
 4. VS Code автоматически откроет соответствующий файл словаря, например, `src/app.content.ts`.
 
-### Управление словарями контента
-
 ### Вкладка Intlayer (Панель активности)
 
 Используйте боковую вкладку для просмотра и управления словарями:
 
-- Откройте значок Intlayer в панели активности.
-- В **Поиске** введите текст для фильтрации словарей и записей в реальном времени.
-- В разделе **Словари** просматривайте окружения, словари и файлы. Используйте панель инструментов для команд Build, Pull, Push, Fill, Refresh, Test и Create Dictionary File. Щелкните правой кнопкой мыши для контекстных действий (Pull/Push для словарей, Fill для файлов). Текущий файл редактора автоматически отображается в дереве, когда это применимо.
+- Откройте иконку Intlayer на панели активности.
+- В поле **Поиск** введите текст для фильтрации словарей и записей в реальном времени.
+- В разделе **Словари** просматривайте окружения, словари и файлы. Используйте панель инструментов для действий: Сборка, Загрузка, Отправка, Заполнение, Обновление, Тестирование и Создание файла словаря. Щелкните правой кнопкой мыши для контекстных действий (Загрузка/Отправка для словарей, Заполнение для файлов). Текущий файл редактора автоматически подсвечивается в дереве, если применимо.
 
-#### Сборка словарей
+### Доступ к командам
 
-Сгенерируйте все файлы содержимого словарей с помощью:
+Вы можете получить доступ к командам через **Палитру команд**.
 
 ```sh
 Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)
 ```
 
-Найдите команду **Build Dictionaries** и выполните её.
-
-#### Отправка словарей
-
-Загрузите последнее содержимое словарей:
-
-1. Откройте **Палитру команд**.
-2. Найдите **Push Dictionaries**.
-3. Выберите словари для отправки и подтвердите.
-
-#### Получение словарей
+- **Сборка словарей**
+- **Отправка словарей**
+- **Загрузка словарей**
+- **Заполнение словарей**
+- **Тестирование словарей**
+- **Создание файла словаря**
 
-Синхронизируйте последнее содержимое словарей:
+### Загрузка переменных окружения
 
-1. Откройте **Палитру команд**.
-2. Найдите **Pull Dictionaries**.
-3. Выберите словари для загрузки.
+Intlayer рекомендует хранить ваши ключи API ИИ, а также идентификатор клиента Intlayer и секрет в переменных окружения.
 
-#### Заполнение словарей
+Расширение может загружать переменные окружения из вашего рабочего пространства для выполнения команд Intlayer с правильным контекстом.
 
-Заполните словари содержимым из вашего проекта:
+- **Порядок загрузки (по приоритету)**: `.env.<env>.local` → `.env.<env>` → `.env.local` → `.env`
+- **Без разрушения**: существующие значения `process.env` не перезаписываются.
+- **Область действия**: файлы разрешаются из настроенной базовой директории (по умолчанию корень рабочего пространства).
 
-1. Откройте **Палитру команд**.
-2. Найдите **Fill Dictionaries**.
-3. Выполните команду для заполнения словарей.
+#### Выбор активного окружения
 
-#### Тестирование словарей
+- **Палитра команд**: откройте палитру и выполните команду `Intlayer: Select Environment`, затем выберите окружение (например, `development`, `staging`, `production`). Расширение попытается загрузить первый доступный файл из приведённого выше списка приоритетов и покажет уведомление, например «Загружено окружение из .env.<env>.local».
+- **Настройки**: перейдите в `Настройки → Расширения → Intlayer` и установите:
+  - **Окружение**: имя окружения, используемое для разрешения файлов `.env.<env>*`.
+  - (Опционально) **Файл Env**: явный путь к файлу `.env`. При указании он имеет приоритет над списком, определённым автоматически.
 
-Проверьте словари и найдите отсутствующие переводы:
+#### Моно-репозитории и пользовательские директории
 
-1. Откройте **Палитру команд**.
-2. Найдите **Test Dictionaries**.
-3. Просмотрите обнаруженные проблемы и исправьте их при необходимости.
+Если ваши файлы `.env` находятся за пределами корня рабочего пространства, установите **Базовый каталог** в `Настройки → Расширения → Intlayer`. Загрузчик будет искать файлы `.env` относительно этого каталога.
 
-## История документа
+## История документации
 
-| Версия | Дата       | Изменения             |
-| ------ | ---------- | --------------------- |
-| 5.5.10 | 2025-06-29 | Инициализация истории |
+| Версия | Дата       | Изменения                              |
+| ------ | ---------- | -------------------------------------- |
+| 6.1.5  | 2025-09-30 | Добавлено демонстрационное gif         |
+| 6.1.0  | 2025-09-24 | Добавлен раздел выбора окружения       |
+| 6.0.0  | 2025-09-22 | Вкладка Intlayer / команды Fill & Test |
+| 5.5.10 | 2025-06-29 | Инициализация истории                  |

package/docs/tr/component_i18n.md

@@ -0,0 +1,186 @@
+---
+createdAt: 2024-03-07
+updatedAt: 2025-09-30
+title: React ve Next.js'te bir bileşeni çok dilli (i18n kütüphanesi) yapma
+description: Intlayer ile çok dilli bir React veya Next.js bileşeni oluşturmak için yerelleştirilmiş içeriğin nasıl beyan edileceğini ve alınacağını öğrenin.
+keywords:
+  - i18n
+  - bileşen
+  - react
+  - çok dilli
+  - next.js
+  - intlayer
+slugs:
+  - doc
+  - component
+  - i18n
+applicationTemplate: https://github.com/aymericzip/intlayer-vite-react-template
+youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
+---
+
+# Intlayer ile bir bileşeni çok dilli (i18n) nasıl yaparsınız
+
+Bu rehber, iki yaygın kurulumda bir UI bileşenini çok dilli yapmak için gereken asgari adımları gösterir:
+
+- React (Vite/SPA)
+- Next.js (App Router)
+
+Öncelikle içeriğinizi beyan edecek, ardından bileşeninizde içeriği alacaksınız.
+
+## 1) İçeriğinizi beyan edin (React ve Next.js için ortak)
+
+Bileşeninizin yakınında bir içerik beyan dosyası oluşturun. Bu, çevirileri kullanıldıkları yere yakın tutar ve tür güvenliğini sağlar.
+
+```ts fileName="component.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+const componentContent = {
+  key: "component-example",
+  content: {
+    title: t({
+      en: "Hello",
+      fr: "Bonjour",
+      es: "Hola",
+    }),
+    description: t({
+      en: "A multilingual React component",
+      fr: "Un composant React multilingue",
+      es: "Un componente React multilingüe",
+    }),
+  },
+} satisfies Dictionary;
+
+export default componentContent;
+```
+
+Yapılandırma dosyalarını tercih ediyorsanız JSON da desteklenmektedir.
+
+```json fileName="component.content.json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "component-example",
+  "content": {
+    "title": {
+      "nodeType": "translation",
+      "translation": { "en": "Hello", "fr": "Bonjour", "es": "Hola" }
+    },
+    "description": {
+      "nodeType": "translation",
+      "translation": {
+        "en": "A multilingual React component",
+        "fr": "Un composant React multilingue",
+        "es": "Un componente React multilingüe"
+      }
+    }
+  }
+}
+```
+
+## 2) İçeriğinizi alın
+
+### Durum A — React uygulaması (Vite/SPA)
+
+Varsayılan yaklaşım: Anahtarla almak için `useIntlayer` kullanın. Bu, bileşenleri hafif ve tipli tutar.
+
+```tsx fileName="ComponentExample.tsx"
+import { useIntlayer } from "react-intlayer";
+
+export function ComponentExample() {
+  const content = useIntlayer("component-example");
+  return (
+    <div>
+      <h1>{content.title}</h1>
+      <p>{content.description}</p>
+    </div>
+  );
+}
+```
+
+Sunucu tarafı render veya sağlayıcı dışında: `react-intlayer/server` kullanın ve gerektiğinde açık bir `locale` parametresi geçin.
+
+```tsx fileName="ServerRenderedExample.tsx"
+import { useIntlayer } from "react-intlayer/server";
+
+export function ServerRenderedExample({ locale }: { locale: string }) {
+  const content = useIntlayer("component-example", locale);
+  return (
+    <>
+      <h1>{content.title}</h1>
+      <p>{content.description}</p>
+    </>
+  );
+}
+```
+
+Alternatif: Çağrı noktasında yapıyı yan yana koymayı tercih ederseniz, `useDictionary` tüm tanımlı nesneyi okuyabilir.
+
+```tsx fileName="ComponentWithDictionary.tsx"
+import { useDictionary } from "react-intlayer";
+import componentContent from "./component.content";
+
+export function ComponentWithDictionary() {
+  const { title, description } = useDictionary(componentContent);
+  return (
+    <div>
+      <h1>{title}</h1>
+      <p>{description}</p>
+    </div>
+  );
+}
+```
+
+### Durum B — Next.js (App Router)
+
+Veri güvenliği ve performans için sunucu bileşenlerini tercih edin. Sunucu dosyalarında `next-intlayer/server` içinden `useIntlayer` kullanın, istemci bileşenlerinde ise `next-intlayer` içinden `useIntlayer` kullanın.
+
+```tsx fileName="app/[locale]/example/ServerComponent.tsx"
+import { useIntlayer } from "next-intlayer/server";
+
+export default function ServerComponent() {
+  const content = useIntlayer("component-example");
+  return (
+    <>
+      <h1>{content.title}</h1>
+      <p>{content.description}</p>
+    </>
+  );
+}
+```
+
+```tsx fileName="app/[locale]/example/ClientComponent.tsx"
+"use client";
+
+import { useIntlayer } from "next-intlayer";
+
+export function ClientComponent() {
+  const content = useIntlayer("component-example");
+  return (
+    <div>
+      <h1>{content.title}</h1>
+      <p>{content.description}</p>
+    </div>
+  );
+}
+```
+
+İpucu: Sayfa meta verileri ve SEO için, içeriği `getIntlayer` kullanarak da alabilir ve çok dilli URL’leri `getMultilingualUrls` ile oluşturabilirsiniz.
+
+## Neden Intlayer’ın bileşen yaklaşımı en iyisidir
+
+- **Birlikte konumlandırma**: İçerik beyanları bileşenlerin yakınında bulunur, sürüklenmeyi azaltır ve tasarım sistemleri arasında yeniden kullanımı artırır.
+- **Tip güvenliği**: Anahtarlar ve yapılar güçlü şekilde tiplenmiştir; eksik çeviriler çalışma zamanında değil, derleme zamanında ortaya çıkar.
+- **Sunucu-öncelikli**: Daha iyi güvenlik ve performans için sunucu bileşenlerinde doğal olarak çalışır; istemci kancaları ergonomik kalır.
+- **Ağaç sarsma (Tree-shaking)**: Sadece bileşen tarafından kullanılan içerik paketlenir, böylece büyük uygulamalarda yükler küçük tutulur.
+- **Geliştirici Deneyimi (DX) ve araçlar**: Dahili ara katman yazılımı, SEO yardımcıları ve isteğe bağlı Görsel Editör/Yapay Zeka çevirileri günlük işleri kolaylaştırır.
+
+Next.js odaklı karşılaştırmalar ve kalıplar için bakınız: https://intlayer.org/blog/next-i18next-vs-next-intl-vs-intlayer
+
+## İlgili rehberler ve referanslar
+
+- React kurulumu (Vite): https://intlayer.org/doc/environment/vite-and-react
+- React Router v7: https://intlayer.org/doc/environment/vite-and-react/react-router-v7
+- TanStack Başlangıç: https://intlayer.org/doc/environment/vite-and-react/tanstack-start
+- Next.js kurulumu: https://intlayer.org/doc/environment/nextjs
+- Neden Intlayer vs. next-intl vs. next-i18next: https://intlayer.org/blog/next-i18next-vs-next-intl-vs-intlayer
+
+Bu sayfalar uçtan uca kurulum, sağlayıcılar, yönlendirme ve SEO yardımcılarını içerir.

package/docs/tr/how_works_intlayer.md

@@ -74,7 +74,7 @@ const MyComponent = () => {
 
 Bu kanca yerel ayar algılamayı sizin için yönetecek ve mevcut yerel ayar için içeriği döndürecektir. Bu kancayı kullanarak, markdown'ı yorumlayabilir, çoğullaştırmayı yönetebilir ve daha fazlasını yapabilirsiniz.
 
-> Intlayer'ın tüm özelliklerini görmek için [sözlük dokümantasyonunu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/get_started.md) okuyabilirsiniz.
+> Intlayer'ın tüm özelliklerini görmek için [sözlük dokümantasyonunu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/content_file.md) okuyabilirsiniz.
 
 ## Uzak içerik
 

package/docs/tr/index.md

@@ -51,7 +51,7 @@ Intlayer, uygulamanızı çevirmek için esnek, modern bir yaklaşım sunar. Bel
 
 Çok dilli içeriğinizi kodunuzun yakınında organize edin, böylece her şey tutarlı ve sürdürülebilir kalır.
 
-- **[Başlarken](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/get_started.md)**  
+- **[Başlarken](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/content_file.md)**  
   Intlayer'da içeriğinizi bildirmenin temellerini öğrenin.
 
 - **[Çeviri](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/translation.md)**  

package/docs/tr/intlayer_cli.md

@@ -40,7 +40,7 @@ pnpm add intlayer-cli -g
 
 ## intlayer-cli paketi
 
-`intlayer-cli` paketi [intlayer bildirimlerinizi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/get_started.md) sözlüklere dönüştürmeyi amaçlar.
+`intlayer-cli` paketi [intlayer bildirimlerinizi](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/content_file.md) sözlüklere dönüştürmeyi amaçlar.
 
 Bu paket tüm intlayer dosyalarını dönüştürecek, örneğin `src/**/*.content.{ts|js|mjs|cjs|json}`. [Intlayer bildirim dosyalarınızı nasıl bildireceğinizi görün](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).