@intlayer/docs 5.5.8

package/ru/packages/react-native-intlayer/index.md

@@ -0,0 +1,57 @@
+**Intlayer** , это набор пакетов, специально разработанных для JavaScript-разработчиков. Он совместим с такими фреймворками, как React, React и Express.js.
+
+**Пакет `react-native-intlayer`** позволяет интернационализировать ваше приложение Vite. Он включает плагин Metro для настройки конфигурации через переменные окружения в [Metro bundler](https://docs.expo.dev/guides/customizing-metro/).
+
+## Зачем интернационализировать ваше приложение React Native?
+
+Интернационализация вашего приложения React Native необходима для эффективного обслуживания глобальной аудитории. Это позволяет вашему приложению предоставлять контент и сообщения на предпочитаемом языке каждого пользователя. Эта возможность улучшает пользовательский опыт и расширяет охват вашего приложения, делая его более доступным и актуальным для людей из разных языковых сообществ.
+
+## Конфигурация
+
+Пакет `react-native-intlayer` работает без проблем с [`react-intlayer` пакетом](https://github.com/aymericzip/intlayer/blob/main/docs/ru/packages/react-intlayer/index.md) и [`intlayer` пакетом](https://github.com/aymericzip/intlayer/blob/main/docs/ru/packages/intlayer/index.md). Ознакомьтесь с соответствующей документацией для получения дополнительной информации.
+
+## Установка
+
+Установите необходимый пакет, используя предпочитаемый менеджер пакетов:
+
+```bash packageManager="npm"
+npm install react-native-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add react-native-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add react-native-intlayer
+```
+
+## Пример использования
+
+Посмотрите пример того, как включить плагины в вашу конфигурацию Vite.
+
+```js
+// metro.config.js
+const { getDefaultConfig } = require("expo/metro-config");
+const { configMetroIntlayer } = require("react-native-intlayer/metro");
+
+module.exports = (async () => {
+  const defaultConfig = getDefaultConfig(__dirname);
+
+  return await configMetroIntlayer(defaultConfig);
+})();
+```
+
+## Освоение интернационализации вашего приложения Vite
+
+Intlayer предоставляет множество функций, которые помогут вам интернационализировать ваше приложение Vite.
+
+**Чтобы узнать больше об этих функциях, обратитесь к [Руководству по интернационализации (i18n) React с Intlayer и React Native](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_with_react_native+expo.md) для приложения React Native.**
+
+## Узнайте больше о Intlayer
+
+- [Сайт Intlayer](https://intlayer.org)
+- [Документация Intlayer](https://intlayer.org/doc)
+- [GitHub Intlayer](https://github.com/aymericzip/intlayer)
+
+- [Задайте свои вопросы нашей умной документации](https://intlayer.org/docchat)

package/ru/packages/react-scripts-intlayer/index.md

@@ -0,0 +1,57 @@
+# react-scripts-intlayer: NPM Пакет для использования Intlayer в приложении React Create App
+
+**Intlayer** , это набор пакетов, разработанных специально для разработчиков на JavaScript. Он совместим с такими фреймворками, как React, React и Express.js.
+
+**Пакет `react-scripts-intlayer`** включает команды и плагины `react-scripts-intlayer` для интеграции Intlayer с приложением на основе Create React App. Эти плагины основаны на [craco](https://craco.js.org/) и включают дополнительную конфигурацию для сборщика [Webpack](https://webpack.js.org/).
+
+## Конфигурация
+
+Пакет `react-scripts-intlayer` работает без проблем с [`react-intlayer` пакетом](https://github.com/aymericzip/intlayer/blob/main/docs/ru/packages/react-intlayer/index.md) и [`intlayer` пакетом](https://github.com/aymericzip/intlayer/blob/main/docs/ru/packages/intlayer/index.md). Ознакомьтесь с соответствующей документацией для получения дополнительной информации.
+
+## Установка
+
+Установите необходимый пакет, используя предпочитаемый менеджер пакетов:
+
+```bash packageManager="npm"
+npm install react-scripts-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add react-scripts-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add react-scripts-intlayer
+```
+
+## Использование
+
+### CLI Команды
+
+Пакет `react-scripts-intlayer` предоставляет следующие CLI команды:
+
+- `npx react-scripts-intlayer build`: Собирает React приложение с конфигурацией Intlayer.
+- `npx react-scripts-intlayer start`: Запускает сервер разработки с конфигурацией Intlayer.
+
+### Замена скриптов в package.json
+
+Чтобы использовать пакет `react-scripts-intlayer`, вам нужно заменить скрипты в `package.json` следующими командами:
+
+```json fileName="package.json"
+{
+  "scripts": {
+    "start": "react-scripts-intlayer start",
+    "build": "react-scripts-intlayer build"
+  }
+}
+```
+
+## Использование пользовательской конфигурации Webpack
+
+`react-scripts-intlayer` основан на [craco](https://craco.js.org/), что позволяет вам настраивать конфигурацию Webpack.
+Если вам нужно настроить конфигурацию Webpack, вы также можете реализовать собственную настройку на основе плагина intlayer craco. [Смотрите пример здесь](https://github.com/aymericzip/intlayer/blob/main/examples/react-app/craco.config.js).
+
+## Прочитайте полный гид по Intlayer для React Create App
+
+Intlayer предоставляет множество функций, чтобы помочь вам интернационализировать ваше React приложение.
+[Смотрите, как использовать intlayer с React Create App](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_with_create_react_app.md).

package/ru/packages/solid-intlayer/index.md

@@ -0,0 +1,3 @@
+this doc will be automatically generated translated from the english doc
+
+see /docs/en/packages/solid-intlayer/index.md

package/ru/packages/svelte-intlayer/index.md

@@ -0,0 +1,3 @@
+this doc will be automatically generated translated from the english doc
+
+see /docs/en/packages/svelte-intlayer/index.md

package/ru/packages/vite-intlayer/index.md

@@ -0,0 +1,53 @@
+# vite-intlayer: Пакет NPM для интернационализации (i18n) приложения Vite
+
+**Intlayer** , это набор пакетов, разработанных специально для JavaScript-разработчиков. Он совместим с такими фреймворками, как React, React и Express.js.
+
+**Пакет `vite-intlayer`** позволяет интернационализировать ваше приложение Vite. Он включает плагин Vite для настройки конфигурации через переменные окружения в [сборщике Vite](https://vitejs.dev/guide/why.html#why-bundle-for-production). Также он предоставляет middleware для определения предпочтительного языка пользователя и перенаправления пользователя на соответствующий URL, как указано в [конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/ru/configuration.md).
+
+## Почему важно интернационализировать ваше приложение Vite?
+
+Интернационализация вашего приложения Vite необходима для эффективного обслуживания глобальной аудитории. Она позволяет вашему приложению предоставлять контент и сообщения на предпочтительном языке каждого пользователя. Эта возможность улучшает пользовательский опыт и расширяет охват вашего приложения, делая его более доступным и релевантным для людей с разным языковым фоном.
+
+## Конфигурация
+
+Пакет `vite-intlayer` работает без проблем с [`react-intlayer` пакетом](https://github.com/aymericzip/intlayer/blob/main/docs/ru/packages/react-intlayer/index.md) и [`intlayer` пакетом](https://github.com/aymericzip/intlayer/blob/main/docs/ru/packages/intlayer/index.md). Ознакомьтесь с соответствующей документацией для получения дополнительной информации.
+
+## Установка
+
+Установите необходимый пакет, используя предпочитаемый менеджер пакетов:
+
+```bash packageManager="npm"
+npm install vite-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add vite-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add vite-intlayer
+```
+
+## Пример использования
+
+Посмотрите пример того, как включить плагины в вашу конфигурацию Vite.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayerPlugin, intLayerMiddlewarePlugin } from "vite-intlayer";
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [intlayerPlugin(), intLayerMiddlewarePlugin()],
+});
+```
+
+> Плагин Vite `intlayerPlugin()` используется для интеграции Intlayer с Vite. Он обеспечивает создание файлов декларации контента и отслеживает их в режиме разработки. Он определяет переменные окружения Intlayer в приложении Vite. Кроме того, он предоставляет алиасы для оптимизации производительности.
+
+> Плагин `intLayerMiddlewarePlugin()` добавляет маршрутизацию на стороне сервера в ваше приложение. Этот плагин автоматически определяет текущую локаль на основе URL и устанавливает соответствующий cookie локали. Если локаль не указана, плагин определяет наиболее подходящую локаль на основе языковых предпочтений браузера пользователя. Если локаль не обнаружена, он перенаправляет на локаль по умолчанию.
+
+## Освоение интернационализации вашего приложения Vite
+
+Intlayer предоставляет множество функций, которые помогут вам интернационализировать ваше приложение Vite.
+
+**Чтобы узнать больше об этих функциях, обратитесь к [Руководству по интернационализации (i18n) React с Intlayer и Vite и React](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_with_vite+react.md) для приложений Vite и React.**

package/ru/packages/vue-intlayer/index.md

@@ -0,0 +1,3 @@
+this doc will be automatically generated translated from the english doc
+
+see /docs/en/packages/vue-intlayer/index.md

package/ru/per_locale_file.md

@@ -0,0 +1,298 @@
+# Intlayer поддерживает два способа объявления многоязычного контента:
+
+- Один файл со всеми переводами
+- Один файл на локаль (формат per-locale)
+
+Эта гибкость позволяет:
+
+- Легко мигрировать с других инструментов i18n
+- Поддерживать автоматизированные рабочие процессы перевода
+- Четко организовывать переводы в отдельные файлы для каждой локали
+
+## Один файл с несколькими переводами
+
+Этот формат идеально подходит для:
+
+- Быстрой итерации в коде.
+- Бесшовной интеграции с CMS.
+
+Это рекомендуемый подход для большинства случаев использования. Он централизует переводы, что упрощает итерацию и интеграцию с CMS.
+
+```tsx fileName="hello-world.content.ts" contentDeclarationFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  content: {
+    multilingualContent: t({
+      ru: "Заголовок моего компонента",
+      en: "Title of my component",
+      es: "Título de mi componente",
+    }),
+  },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.content.mjs" contentDeclarationFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  content: {
+    multilingualContent: t({
+      ru: "Заголовок моего компонента",
+      en: "Title of my component",
+      es: "Título de mi componente",
+    }),
+  },
+};
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.content.cjs" contentDeclarationFormat="json"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  content: {
+    multilingualContent: t({
+      ru: "Заголовок моего компонента",
+      en: "Title of my component",
+      es: "Título de mi componente",
+    }),
+  },
+};
+
+module.exports = helloWorldContent;
+```
+
+```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "content": {
+    "multilingualContent": {
+      "nodeType": "translation",
+      "translation": {
+        "ru": "Заголовок моего компонента",
+        "en": "Title of my component",
+        "es": "Título de mi componente"
+      }
+    }
+  }
+}
+```
+
+> Рекомендуется: Этот формат лучше всего подходит при использовании визуального редактора Intlayer или управлении переводами непосредственно в коде.
+
+## Формат Per-Locale
+
+Этот формат полезен, когда:
+
+- Вы хотите версионировать или переопределять переводы независимо.
+- Вы интегрируете машинные или ручные рабочие процессы перевода.
+
+Вы также можете разделить переводы на отдельные файлы для каждой локали, указав поле locale:
+
+```tsx fileName="hello-world.en.content.ts" contentDeclarationFormat="typescript"
+import { t, Locales, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH, // Важно
+  content: { multilingualContent: "Title of my component" },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```tsx fileName="hello-world.es.content.ts" contentDeclarationFormat="typescript"
+import { t, Locales, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.SPANISH, // Важно
+  content: { multilingualContent: "Título de mi componente" },
+};
+```
+
+```js fileName="hello-world.en.content.mjs" contentDeclarationFormat="esm"
+import { t, Locales } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH, // Важно
+  content: { multilingualContent: "Title of my component" },
+};
+
+export default helloWorldContent;
+```
+
+```tsx fileName="hello-world.es.content.mjs" contentDeclarationFormat="esm"
+import { t, Locales } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.SPANISH, // Важно
+  content: { multilingualContent: "Título de mi componente" },
+};
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.en.content.cjs" contentDeclarationFormat="commonjs"
+const { t, Locales } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH, // Важно
+  content: {
+    multilingualContent: "Title of my component",
+  },
+};
+
+module.exports = helloWorldContent;
+```
+
+```tsx fileName="hello-world.es.content.cjs" contentDeclarationFormat="commonjs"
+const { t, Locales } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.SPANISH, // Важно
+  content: {
+    multilingualContent: "Título de mi componente",
+  },
+};
+
+module.exports = helloWorldContent;
+```
+
+```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "en", // Важно
+  "content": {
+    "multilingualContent": "Title of my component",
+  },
+}
+```
+
+```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "es", // Важно
+  "content": {
+    "multilingualContent": "Título de mi componente",
+  },
+}
+```
+
+> Важно: Убедитесь, что поле locale определено. Оно указывает Intlayer, какой язык представляет файл.
+
+> Примечание: В обоих случаях файл декларации контента должен соответствовать шаблону именования `*.content.{ts,tsx,js,jsx,mjs,cjs,json}`, чтобы быть распознанным Intlayer. Суффикс `.[locale]` является необязательным и используется только как соглашение об именовании.
+
+## Смешивание форматов
+
+Вы можете смешивать оба подхода для одного и того же ключа контента. Например:
+
+Объявите контент по умолчанию или базовый контент статически (например, `index.content.ts`).
+
+Добавьте или переопределите контент для конкретной локали в `index.content.json`, `index.fr.content.ts` и т.д.
+
+Это особенно полезно, когда:
+
+- Вы хотите объявить базовый контент статически в своей кодовой базе и автоматически заполнить его переводами в CMS.
+
+```bash codeFormat="typescript"
+.
+└── Components
+    └── MyComponent
+        ├── index.content.ts
+        ├── index.content.json
+        └── index.ts
+```
+
+### Пример
+
+Вот файл декларации многоязычного контента:
+
+```tsx fileName="Components/MyComponent/index.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH,
+  content: {
+    multilingualContent: "Title of my component",
+    projectName: "My project",
+  },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```json fileName="Components/MyComponent/index.content.json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "content": {
+    "multilingualContent": {
+      "nodeType": "translation",
+      "translation": {
+        "ru": "Заголовок моего компонента",
+        "fr": "Titre de mon composant",
+        "es": "Título de mi componente"
+      }
+    }
+  }
+}
+```
+
+Intlayer автоматически объединяет многоязычные и локализованные файлы.
+
+```tsx fileName="Components/MyComponent/index.ts"
+import { getIntlayer, Locales } from "intlayer";
+
+const intlayer = getIntlayer("hello-world"); // Локаль по умолчанию - ENGLISH, поэтому будет возвращен контент на английском
+
+console.log(JSON.stringify(intlayer, null, 2));
+// Результат:
+// {
+//  "multilingualContent": "Title of my component",
+//  "projectName": "My project"
+// }
+
+const intlayer = getIntlayer("hello-world", Locales.SPANISH);
+
+console.log(JSON.stringify(intlayer, null, 2));
+// Результат:
+// {
+//  "multilingualContent": "Título de mi componente",
+//  "projectName": "My project"
+// }
+
+const intlayer = getIntlayer("hello-world", Locales.FRENCH);
+
+console.log(JSON.stringify(intlayer, null, 2));
+// Результат:
+// {
+//  "multilingualContent": "Titre de mon composant",
+//  "projectName": "My project"
+// }
+```
+
+### Автоматическая генерация переводов
+
+Используйте [intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_cli.md) для автоматического заполнения отсутствующих переводов на основе ваших предпочтительных сервисов.

package/ru/privacy_notice.md

@@ -0,0 +1,61 @@
+# Политика конфиденциальности Intlayer
+
+## Введение
+
+В Intlayer мы серьезно относимся к конфиденциальности. Это уведомление объясняет, как мы обрабатываем информацию, собранную через наш веб-сайт и CMS.
+
+## Контакт
+
+Если у вас есть вопросы или опасения по поводу конфиденциальности, пожалуйста, свяжитесь с нами по следующему адресу: [contact@intlayer.org](mailto:contact@intlayer.org).
+
+## Использование файлов cookie и технологий отслеживания
+
+Мы используем **Google Analytics** и **Meta (Facebook) Pixel** для анализа использования нашего веб-сайта и улучшения наших услуг. Эти инструменты создают статистику и другую информацию о веб-сайте с использованием файлов cookie, хранящихся на устройствах пользователей.
+
+Для получения дополнительной информации:
+
+- [Политика конфиденциальности Google](https://policies.google.com/privacy)
+- [Политика конфиденциальности Meta](https://www.facebook.com/privacy/policy)
+
+## Аутентификация и данные пользователей
+
+Доступ к CMS Intlayer требует аутентификации пользователей. Мы предлагаем как аутентификацию по электронной почте/паролю, так и вход через сторонние сервисы **Google** и **GitHub**.
+
+Во время процесса аутентификации мы собираем:
+
+- Адрес электронной почты
+- Отображаемое имя (или выбранное имя)
+
+Пользователи также могут получить доступ к CMS через токены доступа, связанные с их учетной записью. Эти токены привязаны к тем же данным аутентификации.
+
+## Хранение данных и безопасность
+
+Данные аутентификации пользователей хранятся в базе данных **MongoDB**, размещенной на **cloud.mongodb.com**:
+
+- **Регион:** AWS / Oregon (us-west-2)
+- **Тип:** Репликационный набор (3 узла)
+- **Безопасность паролей:** Все пароли хэшируются с использованием стандартов отрасли.
+
+Мы не храним никаких избыточных персональных данных, кроме тех, которые необходимы для аутентификации и безопасного доступа к CMS.
+
+## Передача данных третьим сторонам
+
+Мы **не** продаем и не передаем ваши персональные данные третьим сторонам, за исключением случаев, необходимых для аналитики (Google Analytics, Facebook Pixel) или в рамках процесса аутентификации (вход через Google или GitHub).
+
+## Права пользователей
+
+Как пользователь, вы имеете право:
+
+- Получить доступ к персональным данным, которые мы храним о вас
+- Запросить исправление или удаление ваших данных
+- Отозвать доступ или удалить свою учетную запись
+
+Для любых запросов, связанных с вашими данными, свяжитесь с нами по адресу [contact@intlayer.org](mailto:contact@intlayer.org).
+
+## Изменения в этом уведомлении
+
+Мы можем время от времени обновлять это уведомление о конфиденциальности. Пользователям рекомендуется регулярно проверять эту страницу, чтобы быть в курсе любых изменений.
+
+---
+
+Сообщите, если вы хотите более формальный тон, добавить упоминания о GDPR/CCPA или адаптировать текст для юридической страницы на вашем сайте.