@intlayer/docs 5.5.8 → 5.5.10

package/ru/intlayer_with_react_native+expo.md

@@ -18,15 +18,18 @@
 В вашем проекте React Native установите следующие пакеты:
 
 ```bash packageManager="npm"
-npm install intlayer react-intlayer react-native-intlayer
+npm install intlayer react-intlayer
+npm install --save-dev react-native-intlayer
 ```
 
 ```bash packageManager="pnpm"
-pnpm add intlayer react-intlayer react-native-intlayer
+pnpm add intlayer react-intlayer
+pnpm add --save-dev react-native-intlayer
 ```
 
 ```bash packageManager="yarn"
-yarn add intlayer react-intlayer react-native-intlayer
+yarn add intlayer react-intlayer
+yarn add --save-dev react-native-intlayer
 ```
 
 ### Пакеты

package/ru/intlayer_with_vite+preact.md

@@ -24,15 +24,18 @@
 Установите необходимые пакеты с помощью npm:
 
 ```bash packageManager="npm"
-npm install intlayer preact-intlayer vite-intlayer
+npm install intlayer preact-intlayer
+npm install --save-dev vite-intlayer
 ```
 
 ```bash packageManager="pnpm"
-pnpm add intlayer preact-intlayer vite-intlayer
+pnpm add intlayer preact-intlayer
+pnpm add --save-dev vite-intlayer
 ```
 
 ```bash packageManager="yarn"
-yarn add intlayer preact-intlayer vite-intlayer
+yarn add intlayer preact-intlayer
+yarn add --save-dev vite-intlayer
 ```
 
 - **intlayer**
@@ -547,13 +550,7 @@ module.exports = App;
 > Если вы хотите использовать ваш контент в атрибуте `string`, таком как `alt`, `title`, `href`, `aria-label` и т.д., вы должны вызвать значение функции, например:
 
 > ```jsx
->
-> ```
-
 > <img src={content.image.src.value} alt={content.image.value} />
-
-> ```
->
 > ```
 
 > Примечание: В Preact, `className` обычно пишется как `class`.
@@ -1237,23 +1234,15 @@ module.exports = LocaleSwitcher;
 ```
 
 > Ссылки на документацию:
-
+>
 > - [`useLocale` hook](https://github.com/aymericzip/intlayer/blob/main/docs/ru/packages/react-intlayer/useLocale.md) (API аналогичен для `preact-intlayer`)
-
 > - [`getLocaleName` hook](https://github.com/aymericzip/intlayer/blob/main/docs/ru/packages/intlayer/getLocaleName.md)
-
 > - [`getLocalizedUrl` hook](https://github.com/aymericzip/intlayer/blob/main/docs/ru/packages/intlayer/getLocalizedUrl.md)
-
 > - [`getHTMLTextDir` hook](https://github.com/aymericzip/intlayer/blob/main/docs/ru/packages/intlayer/getHTMLTextDir.md)
-
 > - [`hreflang` attribute](https://developers.google.com/search/docs/specialty/international/localized-versions?hl=ru)
-
 > - [`lang` attribute](https://developer.mozilla.org/ru/docs/Web/HTML/Global_attributes/lang)
-
 > - [`dir` attribute](https://developer.mozilla.org/ru/docs/Web/HTML/Global_attributes/dir)
-
 > - [`aria-current` attribute](https://developer.mozilla.org/ru/docs/Web/Accessibility/ARIA/Attributes/aria-current)
-
 > - [Popover API](https://developer.mozilla.org/ru/docs/Web/API/Popover_API)
 
 ---

package/ru/intlayer_with_vite+react.md

@@ -24,15 +24,18 @@
 Установите необходимые пакеты с помощью npm:
 
 ```bash packageManager="npm"
-npm install intlayer react-intlayer vite-intlayer
+npm install intlayer react-intlayer
+npm install --save-dev vite-intlayer
 ```
 
 ```bash packageManager="pnpm"
-pnpm add intlayer react-intlayer vite-intlayer
+pnpm add intlayer react-intlayer
+pnpm add --save-dev vite-intlayer
 ```
 
 ```bash packageManager="yarn"
-yarn add intlayer react-intlayer vite-intlayer
+yarn add intlayer react-intlayer
+yarn add --save-dev vite-intlayer
 ```
 
 - **intlayer**
@@ -528,13 +531,7 @@ module.exports = App;
 > Если вы хотите использовать ваш контент в атрибуте `string`, таком как `alt`, `title`, `href`, `aria-label` и т.д., вы должны вызвать значение функции, например:
 
 > ```jsx
->
-> ```
-
 > <img src={content.image.src.value} alt={content.image.value} />
-
-> ```
->
 > ```
 
 > Чтобы узнать больше о хуке `useIntlayer`, обратитесь к [документации](https://github.com/aymericzip/intlayer/blob/main/docs/ru/packages/react-intlayer/useIntlayer.md).
@@ -1176,21 +1173,14 @@ const LocaleSwitcher = () => {
 ```
 
 > Ссылки на документацию:
-
+>
 > - [`useLocale` hook](https://github.com/aymericzip/intlayer/blob/main/docs/ru/packages/react-intlayer/useLocale.md)
-
 > - [`getLocaleName` hook](https://github.com/aymericzip/intlayer/blob/main/docs/ru/packages/intlayer/getLocaleName.md)
-
 > - [`getLocalizedUrl` hook](https://github.com/aymericzip/intlayer/blob/main/docs/ru/packages/intlayer/getLocalizedUrl.md)
-
 > - [`getHTMLTextDir` hook](https://github.com/aymericzip/intlayer/blob/main/docs/ru/packages/intlayer/getHTMLTextDir.md)
-
 > - [`hrefLang` attribute](https://developers.google.com/search/docs/specialty/international/localized-versions?hl=ru)
-
 > - [`lang` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang)
-
 > - [`dir` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/dir)
-
 > - [`aria-current` attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-current)
 
 ---

package/ru/intlayer_with_vite+vue.md

@@ -24,15 +24,18 @@
 Установите необходимые пакеты с помощью npm:
 
 ```bash packageManager="npm"
-npm install intlayer vue-intlayer vite-intlayer
+npm install intlayer vue-intlayer
+npm install --save-dev vite-intlayer
 ```
 
 ```bash packageManager="pnpm"
-pnpm add intlayer vue-intlayer vite-intlayer
+pnpm add intlayer vue-intlayer
+pnpm add --save-dev vite-intlayer
 ```
 
 ```bash packageManager="yarn"
-yarn add intlayer vue-intlayer vite-intlayer
+yarn add intlayer vue-intlayer
+yarn add --save-dev vite-intlayer
 ```
 
 - **intlayer**
@@ -442,23 +445,29 @@ const count = ref(0);
 </template>
 ```
 
-> Если вы хотите использовать ваш контент в атрибуте, таком как `alt`, `title`, `href`, `aria-label` и т.д., вы должны вызвать значение функции с помощью `.value`, например:
+#### Доступ к содержимому в Intlayer Intlayer предлагает различные API для
 
-> ```html
->
-> ```
+доступа к вашему содержимому: - **Синтаксис на основе компонентов**
+(рекомендуется): Используйте синтаксис `<myContent />` или `<Component :is="myContent" />` для отображения содержимого как узла Intlayer. Это легко интегрируется с
+[Визуальным редактором](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_visual_editor.md)
+и [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_CMS.md).
 
-> <img src="./logo.svg" :alt="content.image.value" />
+- **Синтаксис на основе строк**: Используйте `{{ myContent }}` для рендеринга
+  содержимого как обычного текста без поддержки Визуального редактора.
+- **Синтаксис необработанного HTML**: Используйте `<div v-html="myContent" />` для рендеринга содержимого как необработанного HTML без поддержки Визуального
+  редактора.
+- **Синтаксис деструктуризации**: `useIntlayer` composable возвращает
+  прокси с содержимым. Этот прокси можно деструктурировать для доступа к
+  содержимому с сохранением реактивности.
+  - Используйте `const content = useIntlayer("myContent");` и `{{ content.myContent }}` / `<content.myContent />`.
+  - Или используйте `const { myContent } = useIntlayer("myContent");` и `{{ myContent }}` / `<myContent />` для деструктуризации содержимого.
 
-> ```
->
-> ```
+### (Необязательно) Шаг 6: Изменение языка
 
-### (Необязательно) Шаг 6: Измените язык вашего контента
-
-Чтобы изменить язык вашего контента, вы можете использовать функцию `setLocale`, предоставляемую композицией `useLocale`. Эта функция позволяет установить локаль приложения и обновить контент соответствующим образом.
-
-Создайте компонент для переключения между языками:
+вашего контента Чтобы изменить язык вашего контента, вы можете использовать
+функцию `setLocale`, предоставляемую `useLocale` composable. Эта функция
+позволяет установить локаль приложения и соответствующим образом обновить
+контент. Создайте компонент для переключения между языками:
 
 ```vue fileName="src/components/LocaleSwitcher.vue"
 <template>
@@ -529,7 +538,6 @@ const content = useIntlayer("app"); // Создайте соответствую
 
 ```plaintext
 - https://example.com/about
-
 - https://example.com/ru/about
 - https://example.com/fr/about
 ```

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

@@ -0,0 +1,31 @@
+# nuxt-intlayer: NPM пакет для интернационализации (i18n) Vue-приложения
+
+**Intlayer** — это набор пакетов, разработанных специально для JavaScript-разработчиков. Он совместим с такими фреймворками, как Vue, Vue и Express.js.
+
+**Пакет `nuxt-intlayer`** позволяет интернационализировать ваше Vue-приложение. Он предоставляет провайдеры контекста и хуки для интернационализации Vue.
+
+## Почему важно интернационализировать ваше Vue-приложение?
+
+Интернационализация вашего Vue-приложения необходима для эффективного обслуживания глобальной аудитории. Это позволяет вашему приложению предоставлять контент и сообщения на предпочитаемом языке каждого пользователя. Эта возможность улучшает пользовательский опыт и расширяет охват вашего приложения, делая его более доступным и актуальным для людей с разными языковыми предпочтениями.
+
+## Почему стоит интегрировать Intlayer?
+
+- **Управление контентом на основе JavaScript**: Используйте гибкость JavaScript для эффективного определения и управления вашим контентом.
+- **Безопасная типизация**: Используйте TypeScript, чтобы гарантировать точность и отсутствие ошибок в определениях вашего контента.
+- **Интегрированные файлы контента**: Держите переводы рядом с соответствующими компонентами, улучшая поддерживаемость и ясность.
+
+## Установка
+
+Установите необходимый пакет, используя предпочитаемый менеджер пакетов:
+
+```bash packageManager="npm"
+npm install nuxt-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add nuxt-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add nuxt-intlayer
+```

package/ru/roadmap.md

@@ -14,7 +14,7 @@ Intlayer , это решение для управления контентом
 - **Распределенная**: Альтернативно, разделите ваш контент на отдельные файлы на уровне компонентов или функций для лучшей поддерживаемости. Это позволяет держать контент рядом с соответствующим кодом (компоненты, тесты, Storybook и т.д.). Удаление компонента гарантирует, что любой связанный контент также будет удален, предотвращая накопление ненужных данных в вашем коде.
 
 > Ресурсы:
-
+>
 > - [Декларация контента](https://github.com/aymericzip/intlayer/blob/main/docs/ru/dictionary/get_started.md)
 
 ### 2. Интернационализация
@@ -23,7 +23,7 @@ Intlayer , это решение для управления контентом
 - Легкое управление переводами для всех этих локалей из одного места.
 
 > Ресурсы:
-
+>
 > - [Интернационализация](https://github.com/aymericzip/intlayer/blob/main/docs/ru/dictionary/translation.md)
 
 ### 3. Поддержка Markdown
@@ -32,7 +32,7 @@ Intlayer , это решение для управления контентом
 - Идеально подходит для блогов, статей, страниц документации или любых сценариев, где требуется форматирование текста.
 
 > Ресурсы:
-
+>
 > - [Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/ru/dictionary/markdown.md)
 
 ### 4. Условный рендеринг
@@ -41,7 +41,7 @@ Intlayer , это решение для управления контентом
 - Помогает создавать персонализированные впечатления без дублирования контента в нескольких файлах.
 
 > Ресурсы:
-
+>
 > - [Условный рендеринг](https://github.com/aymericzip/intlayer/blob/main/docs/ru/dictionary/condition.md)
 
 ### 5. Форматы декларации контента
@@ -86,7 +86,7 @@ Intlayer поддерживает **TypeScript** (также JavaScript) и **JS
 - Полностью совместим с новым Turbopack от Next.js, а также с традиционным Webpack.
 
 > Ресурсы:
-
+>
 > - [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_with_nextjs_15.md)
 
 ### 2. Vite
@@ -94,7 +94,7 @@ Intlayer поддерживает **TypeScript** (также JavaScript) и **JS
 - Аналогично Next.js, вы можете интегрировать Intlayer с Vite и использовать **middleware** для перенаправления пользователей на контент на основе их предпочтительного языка.
 
 > Ресурсы:
-
+>
 > - [Vite](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_with_vite+react.md)
 
 ### 3. Express
@@ -103,7 +103,7 @@ Intlayer поддерживает **TypeScript** (также JavaScript) и **JS
 - Персонализируйте электронные письма, сообщения об ошибках, push-уведомления и многое другое с локализованным текстом.
 
 > Ресурсы:
-
+>
 > - [Express](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_with_express.md)
 
 ---
@@ -120,7 +120,7 @@ Intlayer поддерживает **TypeScript** (также JavaScript) и **JS
 - Может быть размещен локально или развернут на удаленном сервере.
 
 > Ресурсы:
-
+>
 > - [Визуальный редактор](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_visual_editor.md)
 
 ### 2. Intlayer CMS (удаленный)
@@ -130,7 +130,7 @@ Intlayer поддерживает **TypeScript** (также JavaScript) и **JS
 - Взаимодействуйте с вашим контентом через интерфейс вашего живого приложения.
 
 > Ресурсы:
-
+>
 > - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_CMS.md)
 
 ---
@@ -142,7 +142,7 @@ Intlayer поддерживает **TypeScript** (также JavaScript) и **JS
 - Полезно для **CI/CD конвейеров**, обеспечивая синхронизацию контента с вашим кодом.
 
 > Ресурсы:
-
+>
 > - [CLI](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_cli.md)
 
 ---
@@ -159,7 +159,7 @@ Intlayer поддерживает **TypeScript** (также JavaScript) и **JS
 - При использовании удаленных словарей и Intlayer CMS вы можете **обновлять контент вашего приложения на лету**, без необходимости повторного развертывания.
 
 > Ресурсы:
-
+>
 > - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/ru/intlayer_CMS.md)
 
 ---

package/zh/autoFill.md

@@ -67,9 +67,8 @@ src/components/example/example.filled.content.ts
 ```
 
 > `.js`、`.ts`等文件的生成过程如下：
-
+>
 > - 如果文件已存在，Intlayer将使用AST（抽象语法树）分析它，以定位每个字段并插入缺失的翻译。
-
 > - 如果文件不存在，Intlayer将使用内容声明文件的默认模板生成它。
 
 ## 绝对路径

package/zh/intlayer_with_create_react_app.md

@@ -335,13 +335,7 @@ const App = () => (
 > 注意：如果您想在 `string` 属性中使用您的内容，例如 `alt`、`title`、`href`、`aria-label` 等，您必须调用函数的值，例如：
 
 > ```jsx
->
-> ```
-
 > <img src={content.image.src.value} alt={content.image.value} />
-
-> ```
->
 > ```
 
 > 要了解有关 `useIntlayer` 钩子的更多信息，请参阅 [文档](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/react-intlayer/useIntlayer.md)。
@@ -977,21 +971,14 @@ const LocaleSwitcher = () => {
 ```
 
 > 文档参考：
-
+>
 > - [`useLocale` 钩子](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/react-intlayer/useLocale.md)
-
 > - [`getLocaleName` 钩子](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/intlayer/getLocaleName.md)
-
 > - [`getLocalizedUrl` 钩子](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/intlayer/getLocalizedUrl.md)
-
 > - [`getHTMLTextDir` 钩子](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/intlayer/getHTMLTextDir.md)
-
 > - [`hrefLang` 属性](https://developers.google.com/search/docs/specialty/international/localized-versions?hl=zh)
-
 > - [`lang` 属性](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Global_attributes/lang)
-
 > - [`dir` 属性](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Global_attributes/dir)
-
 > - [`aria-current` 属性](https://developer.mozilla.org/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-current)
 
 ### （可选）第九步：切换 HTML 的语言和方向属性

package/zh/intlayer_with_nextjs_14.md

@@ -578,13 +578,7 @@ const ServerComponentExample = () => {
 > 如果您想在 `string` 属性中使用内容，例如 `alt`、`title`、`href`、`aria-label` 等，您必须调用函数的值，例如：
 
 > ```jsx
->
-> ```
-
 > <img src={content.image.src.value} alt={content.image.value} />
-
-> ```
->
 > ```
 
 > 要了解更多关于 `useIntlayer` 钩子的内容，请参考 [文档](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/next-intlayer/useIntlayer.md)。
@@ -1072,21 +1066,14 @@ const LocaleSwitcher = () => {
 ```
 
 > 文档参考:
-
+>
 > - [`useLocale` hook](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/next-intlayer/useLocale.md)
-
 > - [`getLocaleName` hook](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/intlayer/getLocaleName.md)
-
 > - [`getLocalizedUrl` hook](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/intlayer/getLocalizedUrl.md)
-
 > - [`getHTMLTextDir` hook](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/intlayer/getHTMLTextDir.md)
-
 > - [`hrefLang` 属性](https://developers.google.com/search/docs/specialty/international/localized-versions?hl=fr)
-
 > - [`lang` 属性](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang)
-
 > - [`dir` 属性](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/dir)
-
 > - [`aria-current` 属性](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-current)
 
 ### （可选）步骤11：创建一个本地化的链接组件

package/zh/intlayer_with_nextjs_15.md

@@ -590,13 +590,7 @@ const ServerComponentExample = () => {
 > 如果您想在 `string` 属性中使用您的内容，例如 `alt`、`title`、`href`、`aria-label` 等，您必须调用函数的值，例如：
 
 > ```jsx
->
-> ```
-
 > <img src={content.image.src.value} alt={content.image.value} />
-
-> ```
->
 > ```
 
 > 要了解有关 `useIntlayer` 钩子的更多信息，请参阅 [文档](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/next-intlayer/useIntlayer.md)。
@@ -1111,21 +1105,14 @@ export const LocaleSwitcher = () => {
 ```
 
 > 文档参考：
-
+>
 > - [`useLocale` 钩子](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/next-intlayer/useLocale.md)
-
 > - [`getLocaleName` 钩子](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/intlayer/getLocaleName.md)
-
 > - [`getLocalizedUrl` 钩子](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/intlayer/getLocalizedUrl.md)
-
 > - [`getHTMLTextDir` 钩子](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/intlayer/getHTMLTextDir.md)
-
 > - [`hrefLang` 属性](https://developers.google.com/search/docs/specialty/international/localized-versions?hl=zh)
-
 > - [`lang` 属性](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang)
-
 > - [`dir` 属性](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/dir)
-
 > - [`aria-current` 属性](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-current)
 
 ### (可选) 第 11 步：创建本地化链接组件

package/zh/intlayer_with_nextjs_page_router.md

@@ -534,13 +534,7 @@ const ComponentExample = () => {
 > 在 `string` 属性中使用翻译（例如 `alt`、`title`、`href`、`aria-label`）时，调用函数的值如下：
 
 > ```jsx
->
-> ```
-
 > <img src={content.image.src.value} alt={content.image.value} />
-
-> ```
->
 > ```
 
 > 要了解更多关于 `useIntlayer` 钩子的内容，请参考[文档](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/next-intlayer/useIntlayer.md)。
@@ -873,19 +867,13 @@ const LocaleSwitcher = () => {
 > `useLocalePageRouter` API 与 `useLocale` 相同。要了解更多关于 `useLocale` 钩子的内容，请参考[文档](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/next-intlayer/useLocale.md)。
 
 > 文档参考：
-
+>
 > - [`getLocaleName` 钩子](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/intlayer/getLocaleName.md)
-
 > - [`getLocalizedUrl` 钩子](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/intlayer/getLocalizedUrl.md)
-
 > - [`getHTMLTextDir` 钩子](https://github.com/aymericzip/intlayer/blob/main/docs/zh/packages/intlayer/getHTMLTextDir.md)
-
 > - [`hrefLang` 属性](https://developers.google.com/search/docs/specialty/international/localized-versions?hl=fr)
-
 > - [`lang` 属性](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang)
-
 > - [`dir` 属性](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/dir)
-
 > - [`aria-current` 属性](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-current)
 
 ### （可选）步骤 10：创建一个本地化的链接组件