@intlayer/docs 5.5.8

package/ru/dictionary/condition.md

@@ -0,0 +1,213 @@
+# Условный Контент / Условие в Intlayer
+
+## Как Работает Условие
+
+В Intlayer условный контент достигается с помощью функции `cond`, которая сопоставляет определенные условия (обычно булевы значения) с соответствующим контентом. Этот подход позволяет динамически выбирать контент на основе заданного условия. При интеграции с React Intlayer или Next Intlayer соответствующий контент автоматически выбирается в зависимости от условия, предоставленного во время выполнения.
+
+## Настройка Условного Контента
+
+Чтобы настроить условный контент в вашем проекте Intlayer, создайте модуль контента, который включает ваши условные определения. Ниже приведены примеры в различных форматах.
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+import { cond, type Dictionary } from "intlayer";
+
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "мой контент, когда условие истинно",
+      false: "мой контент, когда условие ложно",
+      fallback: "мой контент, когда условие не выполнено", // Необязательно
+    }),
+  },
+} satisfies Dictionary;
+
+export default myConditionalContent;
+```
+
+```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+import { cond } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "мой контент, когда условие истинно",
+      false: "мой контент, когда условие ложно",
+      fallback: "мой контент, когда условие не выполнено", // Необязательно
+    }),
+  },
+};
+
+export default myConditionalContent;
+```
+
+```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+const { cond } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "мой контент, когда условие истинно",
+      false: "мой контент, когда условие ложно",
+      fallback: "мой контент, когда условие не выполнено", // Необязательно
+    }),
+  },
+};
+
+module.exports = myConditionalContent;
+```
+
+```json5 fileName="**/*.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "my_key",
+  "content": {
+    "myCondition": {
+      "nodeType": "condition",
+      "condition": {
+        "true": "мой контент, когда условие истинно",
+        "false": "мой контент, когда условие ложно",
+        "fallback": "мой контент, когда условие не выполнено", // Необязательно
+      },
+    },
+  },
+}
+```
+
+> Если fallback не указан, последняя объявленная ключевая запись будет использоваться в качестве fallback, если условие не выполнено.
+
+## Использование Условного Контента с React Intlayer
+
+Чтобы использовать условный контент в React-компоненте, импортируйте и используйте хук `useIntlayer` из пакета `react-intlayer`. Этот хук извлекает контент для указанного ключа и позволяет передавать условие для выбора соответствующего результата.
+
+```tsx fileName="**/*.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const ConditionalComponent: FC = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* Вывод: мой контент, когда условие истинно */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* Вывод: мой контент, когда условие ложно */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* Вывод: мой контент, когда условие не выполнено */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* Вывод: мой контент, когда условие не выполнено */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+```javascript fileName="**/*.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const ConditionalComponent = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* Вывод: мой контент, когда условие истинно */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* Вывод: мой контент, когда условие ложно */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* Вывод: мой контент, когда условие не выполнено */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* Вывод: мой контент, когда условие не выполнено */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+```javascript fileName="**/*.cjs" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const ConditionalComponent = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* Вывод: мой контент, когда условие истинно */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* Вывод: мой контент, когда условие ложно */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* Вывод: мой контент, когда условие не выполнено */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* Вывод: мой контент, когда условие не выполнено */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+module.exports = ConditionalComponent;
+```
+
+## Дополнительные Ресурсы
+
+Для получения более подробной информации о настройке и использовании обратитесь к следующим ресурсам:
+
+- [Документация Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_cli.md)
+- [Документация React Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_with_create_react_app.md)
+- [Документация Next Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_with_nextjs_15.md)
+
+Эти ресурсы предоставляют дополнительные сведения о настройке и использовании Intlayer в различных средах и фреймворках.

package/ru/dictionary/content_extention_customization.md

@@ -0,0 +1,81 @@
+# Настройка Расширений Контента
+
+## Расширения Файлов Контента
+
+Intlayer позволяет настраивать расширения для файлов декларации контента. Эта настройка обеспечивает гибкость в управлении крупными проектами и помогает избежать конфликтов с другими модулями.
+
+### Расширения по Умолчанию
+
+По умолчанию, Intlayer отслеживает все файлы с следующими расширениями для декларации контента:
+
+- `.content.json`
+- `.content.ts`
+- `.content.tsx`
+- `.content.js`
+- `.content.jsx`
+- `.content.mjs`
+- `.content.mjx`
+- `.content.cjs`
+- `.content.cjx`
+
+Эти расширения подходят для большинства приложений. Однако, если у вас есть специфические потребности, вы можете определить пользовательские расширения, чтобы оптимизировать процесс сборки и снизить риск конфликтов с другими компонентами.
+
+### Настройка Расширений Контента
+
+Чтобы настроить расширения файлов, которые Intlayer использует для идентификации файлов декларации контента, вы можете указать их в конфигурационном файле Intlayer. Этот подход полезен для крупных проектов, где ограничение области отслеживания улучшает производительность сборки.
+
+Пример, как определить пользовательские расширения контента в вашей конфигурации:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  content: {
+    fileExtensions: [".my_content.ts", ".my_content.tsx"], // Ваши пользовательские расширения
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  content: {
+    fileExtensions: [".my_content.cjs", ".my_content.cjx"], // Ваши пользовательские расширения
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  content: {
+    fileExtensions: [".my_content.mjs", ".my_content.mjx"], // Ваши пользовательские расширения
+  },
+};
+
+module.exports = config;
+```
+
+В этом примере конфигурация указывает два пользовательских расширения: `.my_content.ts` и `.my_content.tsx`. Intlayer будет отслеживать только файлы с этими расширениями для построения словарей.
+
+### Преимущества Пользовательских Расширений
+
+- **Производительность Сборки**: Сокращение области отслеживаемых файлов может значительно улучшить производительность сборки в крупных проектах.
+- **Избежание Конфликтов**: Пользовательские расширения помогают предотвратить конфликты с другими файлами JavaScript или TypeScript в вашем проекте.
+- **Организация**: Пользовательские расширения позволяют организовать файлы декларации контента в соответствии с потребностями вашего проекта.
+
+### Руководство по Пользовательским Расширениям
+
+При настройке пользовательских расширений файлов контента учитывайте следующие рекомендации:
+
+- **Уникальность**: Выбирайте расширения, которые уникальны в вашем проекте, чтобы избежать конфликтов.
+- **Последовательное Именование**: Используйте последовательные соглашения об именовании для улучшения читаемости и сопровождения кода.
+- **Избегайте Общих Расширений**: Воздержитесь от использования общих расширений, таких как `.ts` или `.js`, чтобы предотвратить конфликты с другими модулями или библиотеками.
+
+## Заключение
+
+Настройка расширений файлов контента в Intlayer , это ценная функция для оптимизации производительности и предотвращения конфликтов в крупных приложениях. Следуя рекомендациям, изложенным в этой документации, вы сможете эффективно управлять декларациями контента и обеспечить их плавную интеграцию с другими частями вашего проекта.

package/ru/dictionary/enumeration.md

@@ -0,0 +1,221 @@
+# Перечисление / Множественное число
+
+## Как работает перечисление
+
+В Intlayer перечисление достигается с помощью функции `enu`, которая сопоставляет определенные ключи с их соответствующим содержанием. Эти ключи могут представлять числовые значения, диапазоны или пользовательские идентификаторы. При использовании с React Intlayer или Next Intlayer соответствующее содержимое автоматически выбирается на основе локали приложения и определенных правил.
+
+## Настройка перечисления
+
+Чтобы настроить перечисление в вашем проекте Intlayer, необходимо создать модуль содержимого, который включает определения перечислений. Вот пример простого перечисления для количества автомобилей:
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+import { enu, type Dictionary } from "intlayer";
+
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "Меньше минус одного автомобиля",
+      "-1": "Минус один автомобиль",
+      "0": "Нет автомобилей",
+      "1": "Один автомобиль",
+      ">5": "Несколько автомобилей",
+      ">19": "Много автомобилей",
+      "fallback": "Резервное значение", // Необязательно
+    }),
+  },
+} satisfies Dictionary;
+
+export default carEnumeration;
+```
+
+```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+import { enu } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "Меньше минус одного автомобиля",
+      "-1": "Минус один автомобиль",
+      "0": "Нет автомобилей",
+      "1": "Один автомобиль",
+      ">5": "Несколько автомобилей",
+      ">19": "Много автомобилей",
+      "fallback": "Резервное значение", // Необязательно
+    }),
+  },
+};
+
+export default carEnumeration;
+```
+
+```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+const { enu } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "Меньше минус одного автомобиля",
+      "-1": "Минус один автомобиль",
+      "0": "Нет автомобилей",
+      "1": "Один автомобиль",
+      ">5": "Несколько автомобилей",
+      ">19": "Много автомобилей",
+      "fallback": "Резервное значение", // Необязательно
+    }),
+  },
+};
+
+module.exports = carEnumeration;
+```
+
+```json fileName="**/*.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "car_count",
+  "content": {
+    "numberOfCar": {
+      "nodeType": "enumeration",
+      "enumeration": {
+        "<-1": "Меньше минус одного автомобиля",
+        "-1": "Минус один автомобиль",
+        "0": "Нет автомобилей",
+        "1": "Один автомобиль",
+        ">5": "Несколько автомобилей",
+        ">19": "Много автомобилей",
+        "fallback": "Резервное значение" // Необязательно
+      }
+    }
+  }
+}
+```
+
+В этом примере `enu` сопоставляет различные условия с определенным содержимым. При использовании в компоненте React Intlayer может автоматически выбирать соответствующее содержимое на основе заданной переменной.
+
+> Порядок объявления важен в перечислениях Intlayer. Первая подходящая декларация будет выбрана. Если применимо несколько условий, убедитесь, что они расположены в правильном порядке, чтобы избежать неожиданного поведения.
+
+> Если резервное значение не объявлено, функция вернет `undefined`, если ни один из ключей не совпадает.
+
+## Использование перечисления с React Intlayer
+
+Чтобы использовать перечисление в компоненте React, вы можете воспользоваться хуком `useIntlayer` из пакета `react-intlayer`. Этот хук извлекает правильное содержимое на основе указанного идентификатора. Вот пример использования:
+
+```tsx fileName="**/*.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const CarComponent: FC = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // Вывод: Нет автомобилей
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // Вывод: Несколько автомобилей
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // Вывод: Много автомобилей
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // Вывод: Резервное значение
+        }
+      </p>
+    </div>
+  );
+};
+```
+
+```javascript fileName="**/*.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const CarComponent = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // Вывод: Нет автомобилей
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // Вывод: Несколько автомобилей
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // Вывод: Много автомобилей
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // Вывод: Резервное значение
+        }
+      </p>
+    </div>
+  );
+};
+
+export default CarComponent;
+```
+
+```javascript fileName="**/*.cjs" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const CarComponent = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // Вывод: Нет автомобилей
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // Вывод: Несколько автомобилей
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // Вывод: Много автомобилей
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // Вывод: Резервное значение
+        }
+      </p>
+    </div>
+  );
+};
+
+module.exports = CarComponent;
+```
+
+В этом примере компонент динамически изменяет свой вывод в зависимости от количества автомобилей. Правильное содержимое выбирается автоматически в зависимости от указанного диапазона.
+
+## Дополнительные ресурсы
+
+Для получения более подробной информации о конфигурации и использовании обратитесь к следующим ресурсам:
+
+- [Документация Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_cli.md)
+- [Документация React Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_with_create_react_app.md)
+- [Документация Next Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_with_nextjs_15.md)
+
+Эти ресурсы предоставляют дополнительную информацию о настройке и использовании Intlayer в различных средах и с различными фреймворками.