@intlayer/docs 9.4.4 → 9.5.1

package/blog/ru/list_i18n_technologies/frameworks/react-native.md

@@ -23,8 +23,6 @@ author: aymericzip
 
 В условиях все более глобального рынка предоставление вашего React Native приложения на нескольких языках может значительно улучшить доступность и удовлетворение пользователей. Интернационализация (i18n) является центральной для эффективного управления переводами, позволяя вам отображать текст, форматы дат и времени, валюту и многое другое, специфичное для языка, без усложнения вашего кода. В этой статье мы рассмотрим различные подходы к i18n, начиная от специализированных библиотек до более общих решений, и поможем вам найти то, что лучше всего соответствует вашему проекту React Native.
 
----
-
 ## Что такое интернационализация (i18n)?
 
 Интернационализация, или i18n, включает в себя структурирование приложения так, чтобы оно могло легко адаптироваться к различным языкам, региональным форматам и культурным нормам. В React Native i18n включает в себя обработку строк для кнопок и меток, а также форматирование дат, времени, валют и многого другого в соответствии с локалью пользователя. Правильно подготовленные приложения React Native позволяют вам без проблем интегрировать дополнительные языки и специфическое поведение для локали позже , без серьезных рефакторов.
@@ -32,8 +30,6 @@ author: aymericzip
 Для более глубокого погружения в концепции интернационализации ознакомьтесь с нашей статьей:  
 [Что такое интернационализация (i18n)? Определение и проблемы](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ru/what_is_internationalization.md).
 
----
-
 ## Проблема перевода для приложений React Native
 
 Работа с переводами в React Native вводит свои уникальные соображения:
@@ -53,8 +49,6 @@ author: aymericzip
 - **Обновления приложений и обновления по воздуху (OTA)**  
   Если вы используете CodePush или другой механизм обновления OTA, вам нужно спланировать, как обновления перевода или новые языки будут доставляться без необходимости полного обновления в магазине приложений.
 
----
-
 ## Ведущие решения i18n для React Native
 
 Ниже представлены несколько популярных подходов к управлению многоязычным контентом в React Native. Каждый из них направлен на упрощение вашего рабочего процесса перевода различными способами.
@@ -88,8 +82,6 @@ author: aymericzip
 - **Сообщество и экосистема**  
   Это относительно новое решение, поэтому вы можете обнаружить меньше примеров, созданных сообществом, или готовых плагинов по сравнению с давно устоявшимися библиотеками.
 
----
-
 ### 2. React-i18next
 
 > Вебсайт: [https://react.i18next.com/](https://react.i18next.com/)
@@ -122,8 +114,6 @@ author: aymericzip
 - **Производительность**  
   Хотя React-i18next в целом работает хорошо, вам следует обратить внимание на то, как вы организуете и загружаете ресурсы перевода, чтобы избежать излишней нагрузки на мобильные устройства.
 
----
-
 ### 3. React Intl (от FormatJS)
 
 > Вебсайт: [https://formatjs.io/docs/react-intl/](https://formatjs.io/docs/react-intl/)
@@ -156,8 +146,6 @@ author: aymericzip
 - **Примеры сообщества**  
   Хотя библиотека широко используется, примеров специфического использования для React Native может быть меньше, чем для React веб. Вам, вероятно, потребуется адаптировать существующую документацию и шаблоны для работы в среде нативного приложения.
 
----
-
 ### 4. LinguiJS
 
 > Вебсайт: [https://lingui.js.org/](https://lingui.js.org/)
@@ -190,8 +178,6 @@ author: aymericzip
 - **Организация кода**  
   Важно решить, как разбивать ваши каталоги сообщений (по экрану, функции или языку), чтобы поддерживать ясность в более крупных приложениях.
 
----
-
 ## Заключительные мысли
 
 При выборе решения i18n для вашего приложения React Native:

package/blog/ru/list_i18n_technologies/frameworks/react.md

@@ -23,16 +23,12 @@ author: aymericzip
 
 В сегодняшнем цифровом пространстве расширение охвата вашего веб-сайта для глобальной аудитории является обязательным. Для разработчиков, создающих на React, внедрение международной локализации (i18n) является ключом к эффективному управлению переводами при сохранении структуры приложения, ценности SEO и пользовательского опыта. В этой статье мы исследуем различные подходы к i18n , от специализированных библиотек до пользовательских решений на коде , помогая вам решить, что лучше всего подходит для потребностей вашего проекта.
 
----
-
 ## Что такое международная локализация (i18n)?
 
 Международная локализация, сокращенно i18n, это процесс проектирования и подготовки вашего веб-сайта для поддержки нескольких языков и культурных контекстов. В React это означает настройку вашего приложения так, чтобы строки, форматы дат, числовые форматы и даже макет можно было легко адаптировать для пользователей из разных регионов. Подготовка вашего React-приложения для i18n закладывает основу для чистой интеграции переводов и других функций локализации.
 
 Узнайте больше о i18n, прочитав нашу статью: [Что такое международная локализация (i18n)? Определение и проблемы](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ru/what_is_internationalization.md).
 
----
-
 ## Проблема перевода для приложений React
 
 Перевод React-сайта представляет несколько проблем:
@@ -43,8 +39,6 @@ author: aymericzip
 - **Управление состоянием и контекстом:** Обеспечение того, чтобы правильный язык сохранялся по маршрутам и компонентам, требует продуманного управления состоянием.
 - **Нагрузка на разработку:** Поддержание файлов перевода, обеспечение точности контекста и масштабируемость вашего приложения , это постоянные соображения.
 
----
-
 ## Ведущие решения i18n для React
 
 Ниже приведены несколько популярных подходов к управлению многоязычным контентом в приложениях React, каждый из которых предназначен для упрощения процесса перевода различными способами.
@@ -69,8 +63,6 @@ author: aymericzip
 
 - **Сообщество и экосистема**: Хотя экосистема и растет, она новее, поэтому плагины и инструменты, созданные сообществом, могут быть более ограничены по сравнению с более устоявшимися решениями.
 
----
-
 ### 2. React-i18next
 
 Веб-сайт: [https://react.i18next.com/](https://react.i18next.com/)
@@ -93,8 +85,6 @@ author: aymericzip
 - **Экосистема плагинов**: Доступен широкий экосистема плагинов и промежуточных программ, что также означает, что вам придется просмотреть различные пакеты, чтобы найти подходящие инструменты.
 - **Серверные компоненты**: Требует дополнительной настройки, чтобы обеспечить корректный выбор локалей для серверных компонентов, особенно если вы используете фреймворки, отличные от Next.js.
 
----
-
 ### 3. React Intl (от FormatJS)
 
 Веб-сайт: [https://formatjs.io/docs/react-intl/](https://formatjs.io/docs/react-intl/)
@@ -137,8 +127,6 @@ author: aymericzip
 - **Сообщество и плагины**: Экосистема растет, но все еще меньше по сравнению с i18next или FormatJS.
 - **Серверные компоненты**: Может требовать более явной настройки, чтобы гарантировать, что серверные компоненты получают правильные данные локали.
 
----
-
 ### Заключительные мысли
 
 При выборе библиотеки i18n для React:

package/blog/ru/list_i18n_technologies/frameworks/svelte.md

@@ -23,16 +23,12 @@ author: aymericzip
 
 По мере того как веб продолжает связывать людей по всему миру, предоставление контента на нескольких языках становится всё более важным. Для разработчиков, работающих с **Svelte**, внедрение i18n необходимо для эффективного управления переводами, поддержания чистого кода и соблюдения хороших практик SEO. В этой статье мы погружаемся в различные решения и рабочие процессы i18n для Svelte , помогая вам выбрать то, что наилучшим образом подходит для нужд вашего проекта.
 
----
-
 ## Что такое интернационализация (i18n)?
 
 Интернационализация, обычно сокращаемая как i18n, это процесс проектирования и создания вашего приложения так, чтобы оно могло легко адаптироваться к различным языкам, регионам и культурным конвенциям. В Svelte это обычно означает настройку строк перевода, локализацию дат, времени и чисел, а также обеспечение того, чтобы пользовательский интерфейс мог динамически переключаться между различными локалями без значительных переработок кода.
 
 Чтобы узнать больше о основах i18n, прочтите нашу статью: [Что такое интернационализация (i18n)? Определение и вызовы](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ru/what_is_internationalization.md).
 
----
-
 ## Переводческие проблемы для приложений на Svelte
 
 Перевод приложения на Svelte может представлять несколько трудностей:
@@ -43,8 +39,6 @@ author: aymericzip
 - **Состояние и маршрутизация**: Сохранение правильного языка на нескольких маршрутах и динамических страницах часто требует организации глобального состояния, защит маршрутов или пользовательских хуков в SvelteKit.
 - **Поддерживаемость**: По мере роста вашей кодовой базы и файлов перевода поддерживать всё в упорядоченном и синхронизированном состоянии становится непрерывным усилием.
 
----
-
 ## Ведущие решения i18n для Svelte
 
 Svelte не предоставляет встроенного решения i18n (как это делает Angular), но сообщество создало разнообразные надежные библиотеки и паттерны. Ниже приведены несколько популярных подходов.
@@ -69,8 +63,6 @@ Svelte не предоставляет встроенного решения i18
 
 - **Сообщество и экосистема**: Хотя экосистема постоянно растет, она всё еще относительно новая, поэтому количество плагинов и инструментов от сообщества может быть более ограниченным по сравнению с более устоявшимися решениями.
 
----
-
 ### 2. svelte-i18n
 
 Репозиторий: [https://github.com/kaisermann/svelte-i18n](https://github.com/kaisermann/svelte-i18n)
@@ -91,8 +83,6 @@ Svelte не предоставляет встроенного решения i18
 - **Настройка SSR**: Конфигурация SSR для SEO может потребовать дополнительных шагов для обеспечения правильного обнаружения локали на стороне сервера.
 - **Производительность**: Хотя библиотека гибка во время выполнения, большое количество загруженных сразу переводов может повлиять на время начальной загрузки , рассмотрите стратегии ленивой загрузки или кэширования.
 
----
-
 ### 3. svelte-intl-precompile
 
 Репозиторий: [https://github.com/cibernox/svelte-intl-precompile](https://github.com/cibernox/svelte-intl-precompile)
@@ -113,8 +103,6 @@ Svelte не предоставляет встроенного решения i18
 - **Динамический контент**: Если вам нужны переводы на лету для пользовательского контента, этот подход может потребовать дополнительных шагов для обновлений во время выполнения.
 - **Кривая обучения**: Комбинация извлечения сообщений и предварительной компиляции может быть немного сложнее для новичков.
 
----
-
 ### 4. i18next с Svelte / SvelteKit
 
 Веб-сайт: [https://www.i18next.com/](https://www.i18next.com/)
@@ -135,8 +123,6 @@ Svelte не предоставляет встроенного решения i18
 - **Накладные расходы**: i18next мощен, но для небольших проектов Svelte некоторые из его функций могут быть избыточными.
 - **Маршрутизация и состояние**: Обработка маршрутов языка, скорее всего, будет включать пользовательские хуки или промежуточные слои в SvelteKit.
 
----
-
 ### Заключительные мысли
 
 Выбирая стратегию i18n для вашего приложения на Svelte:

package/blog/ru/list_i18n_technologies/frameworks/vue.md

@@ -23,16 +23,12 @@ author: aymericzip
 
 В условиях все более глобализованного цифрового ландшафта расширение аудитории вашего сайта на Vue.js для пользователей на нескольких языках стало не просто желательной функцией, а конкурентной необходимостью. Интернационализация (i18n) дает возможность разработчикам управлять переводами и адаптировать свои приложения для различных локалей, сохраняя при этом ценность SEO, пользовательский опыт и структурируемый код. В этой статье мы рассмотрим различные подходы , от специализированных библиотек до решений на заказ , которые помогут вам плавно интегрировать i18n в ваш проект на Vue.js.
 
----
-
 ## Что такое интернационализация (i18n)?
 
 Интернационализация (i18n) , это практика подготовки программного обеспечения (или вебсайта) для нескольких языков и культурных традиций. В экосистеме Vue.js это включает в себя установление того, как текст, даты, числа, валюта и другие локализуемые элементы могут быть адаптированы к различным локалям. Настройка i18n с самого начала обеспечит организованную, масштабируемую структуру для добавления новых языков и учета будущих нужд локализации.
 
 Чтобы узнать больше о базовых понятиях i18n, ознакомьтесь с нашим справочником: [Что такое интернационализация (i18n)? Определение и вызовы](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ru/what_is_internationalization.md).
 
----
-
 ## Проблема перевода для приложений Vue
 
 Перевод приложения Vue.js приносит свои собственные проблемы:
@@ -43,14 +39,10 @@ author: aymericzip
 - **Контекст состояния и реактивность:** Обеспечение того, чтобы текущая локаль поддерживалась по маршрутам и компонентам , реактивное обновление текстов и форматов , требует обдуманного подхода, особенно при работе с Vuex или Pinia для управления состоянием.
 - **Затраты на разработку:** Поддержание переводов организованными, последовательными и актуальными быстро может стать значительной задачей, если не управлять ей осторожно.
 
----
-
 ## Ведущие решения i18n для Vue.js
 
 Ниже представлены несколько популярных библиотек и подходов, которые вы можете использовать для интеграции интернационализации в свои приложения Vue. Каждый из них нацелен на упрощение процессов перевода, SEO и производительности по-разному.
 
----
-
 ### 1. Intlayer
 
 > Вебсайт: [https://intlayer.org/](https://intlayer.org/)
@@ -94,8 +86,6 @@ author: aymericzip
 - **Экосистема плагинов**  
   Хотя она и мощная, вам может понадобиться внимательно выбирать из множества плагинов или модулей (Nuxt I18n, Vue I18n и т. д.), чтобы создать идеальную настройку.
 
----
-
 ### 3. LinguiJS (Интеграция с Vue)
 
 > Вебсайт: [https://lingui.js.org/](https://lingui.js.org/)
@@ -123,8 +113,6 @@ author: aymericzip
 - **Меньшее сообщество**  
   По сравнению с Vue I18n, здесь относительно меньше экосистемы. Официально поддерживаемые плагины и сторонние добавления могут быть более ограниченными.
 
----
-
 ## Заключительные мысли
 
 При выборе решения i18n для вашего приложения на Vue.js:

package/blog/ru/next-i18next_vs_next-intl_vs_intlayer.md

@@ -40,16 +40,12 @@ author: aymericzip
 
 > Одна из распространённых ошибок разработчиков, считать, что `next-intl`, это версия `react-intl` для Next.js. Это не так, `next-intl` поддерживается [Amann](https://github.com/amannn), а `react-intl` поддерживается [FormatJS](https://github.com/formatjs/formatjs).
 
----
-
 ## Кратко
 
 - **next-intl**, лёгкое и простое форматирование сообщений с надёжной поддержкой Next.js. Обычно используются централизованные каталоги; опыт разработчика (DX) простой, но безопасность и масштабное сопровождение в основном остаются вашей ответственностью.
 - **next-i18next**, i18next в обёртке Next.js. Зрелая экосистема и функции через плагины (например, ICU), но конфигурация может быть многословной, а каталоги имеют тенденцию к централизации по мере роста проектов.
 - **Intlayer**, компонентно-ориентированная модель контента для Next.js, **строгая типизация TS**, **проверки во время сборки**, **tree-shaking**, **встроенные middleware и SEO-помощники**, опциональный **Визуальный редактор/CMS** и **переводы с помощью ИИ**.
 
----
-
 | Library                | GitHub Stars                                                                                                                                                                     | Total Commits                                                                                                                                                                        | Last Commit                                                                                                                                           | First Version | NPM Version                                                                                                         | NPM Downloads                                                                                                                  |
 | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
 | `aymericzip/intlayer`  | [![GitHub Repo stars](https://img.shields.io/github/stars/aymericzip/intlayer?style=for-the-badge&label=%E2%AD%90%20stars)](https://github.com/aymericzip/intlayer/stargazers)   | [![GitHub commit activity](https://img.shields.io/github/commit-activity/t/aymericzip/intlayer?style=for-the-badge&label=commits)](https://github.com/aymericzip/intlayer/commits)   | [![Last Commit](https://img.shields.io/github/last-commit/aymericzip/intlayer?style=for-the-badge)](https://github.com/aymericzip/intlayer/commits)   | April 2024    | [![npm](https://img.shields.io/npm/v/intlayer?style=for-the-badge)](https://www.npmjs.com/package/intlayer)         | [![npm downloads](https://img.shields.io/npm/dm/intlayer?style=for-the-badge)](https://www.npmjs.com/package/intlayer)         |
@@ -59,8 +55,6 @@ author: aymericzip
 
 > Значки обновляются автоматически. Снимки будут меняться со временем.
 
----
-
 ## Сравнение функций бок о бок (с акцентом на Next.js)
 
 | Функция                                                   | `next-intlayer` (Intlayer)                                                                                                                          | `next-intl`                                                                                                                     | `next-i18next`                                                                                                                  |
@@ -86,16 +80,12 @@ author: aymericzip
 | **Управление крупными проектами**                         | ✅ Поощряет модульность, подходит для дизайн-систем                                                                                                 | ✅ Модульное с настройкой                                                                                                       | ✅ Модульное с настройкой                                                                                                       |
 | **Тестирование отсутствующих переводов (CLI/CI)**         | ✅ CLI: `npx intlayer content test` (аудит, удобный для CI)                                                                                         | ⚠️ Не встроено; в документации предлагается `npx @lingual/i18n-check`                                                           | ⚠️ Не встроено; полагаться на инструменты i18next / runtime `saveMissing`                                                       |
 
----
-
 ## Введение
 
 Next.js предоставляет встроенную поддержку интернационализированной маршрутизации (например, сегменты локали). Но эта функция сама по себе не выполняет переводы. Вам все равно нужна библиотека для отображения локализованного контента вашим пользователям.
 
 Существует множество библиотек для i18n, но в мире Next.js сегодня три из них набирают популярность: next-i18next, next-intl и Intlayer.
 
----
-
 ## Архитектура и масштабируемость
 
 - **next-intl / next-i18next**: По умолчанию используют **централизованные каталоги** для каждой локали (плюс **пространства имён** в i18next). Хорошо работает на начальных этапах, но часто становится большой общей областью с растущей связанностью и частой сменой ключей.
@@ -103,8 +93,6 @@ Next.js предоставляет встроенную поддержку ин
 
 **Почему это важно:** В больших кодовых базах или при использовании дизайн-систем **модульный контент** масштабируется лучше, чем монолитные каталоги.
 
----
-
 ## Размеры бандлов и зависимости
 
 После сборки приложения, бандл, это JavaScript, который браузер загрузит для отображения страницы. Размер бандла, следовательно, важен для производительности приложения.
@@ -172,8 +160,6 @@ Next.js предоставляет встроенную поддержку ин
 | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
 | ![оптимизированный бандл](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true) | ![неоптимизированный бандл](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle_no_optimization.png?raw=true) |
 
----
-
 ## TypeScript и безопасность
 
 <Columns>
@@ -198,12 +184,11 @@ Next.js предоставляет встроенную поддержку ин
 - **Генерирует строгие типы** на основе вашего контента. **Автодополнение в IDE** и **ошибки на этапе компиляции** ловят опечатки и отсутствующие ключи до деплоя.
 
   </Column>
+
 </Columns>
 
 **Почему это важно:** Строгая типизация сдвигает ошибки **влево** (CI/сборка), а не **вправо** (во время выполнения).
 
----
-
 ## Обработка отсутствующих переводов
 
 **next-intl**
@@ -220,8 +205,6 @@ Next.js предоставляет встроенную поддержку ин
 
 **Почему это важно:** Обнаружение пробелов во время сборки предотвращает появление «непонятных строк» в продакшене и соответствует строгим требованиям к выпуску.
 
----
-
 ## Маршрутизация, middleware и стратегия URL
 
 <Columns>
@@ -246,12 +229,11 @@ Next.js предоставляет встроенную поддержку ин
 - Всё вышеперечисленное, плюс **i18n middleware** (определение локали через заголовки/куки) и **хелперы** для генерации локализованных URL и тегов `<link rel="alternate" hreflang="…">`.
 
   </Column>
+
 </Columns>
 
 **Почему это важно:** Меньше пользовательских прослоек; **последовательный UX** и **чистое SEO** для всех локалей.
 
----
-
 ## Совместимость с серверными компонентами (RSC)
 
 <Columns>
@@ -276,12 +258,11 @@ Next.js предоставляет встроенную поддержку ин
 - Поддерживает Next.js 13+ и сглаживает **границу сервер/клиент** с помощью единого API и провайдеров, ориентированных на RSC, избегая передачи форматтеров или функций t.
 
   </Column>
+
 </Columns>
 
 **Почему это важно:** Более чистая ментальная модель и меньше крайних случаев в гибридных деревьях.
 
----
-
 ## Интеграция с платформами локализации (TMS)
 
 Крупные организации часто используют Системы Управления Переводами (TMS), такие как **Crowdin**, **Phrase**, **Lokalise**, **Localizely** или **Localazy**.
@@ -788,8 +769,6 @@ const ClientComponentExample = () => {
   - **next-intl** гибок; загружайте сообщения как настроите.
   - **Intlayer** хранит контент в словарях TS/JS и разрешает по ключу.
 
----
-
 ### Использование в серверном компоненте
 
 Мы рассмотрим случай UI-компонента. Этот компонент является серверным компонентом и должен иметь возможность быть вставленным в качестве дочернего компонента клиента. (страница (серверный компонент) -> клиентский компонент -> серверный компонент). Поскольку этот компонент может быть вставлен как дочерний компонент клиента, он не может быть асинхронным.
@@ -887,7 +866,7 @@ const ServerComponent = ({ count }: { count: number }) => {
 Разработчики часто забывают правильно ссылаться на свои страницы в разных локалях.
 
 <Tabs defaultTab="next-intl" group='techno'>
- 
+
   <Tab label="next-i18next" value="next-i18next">
 
 ```ts fileName="i18n.config.ts"
@@ -1149,8 +1128,6 @@ export default robots;
 
 > Intlayer предоставляет функцию `getMultilingualUrls` для генерации многоязычных URL для вашей карты сайта.
 
----
-
 ### Middleware для маршрутизации локалей
 
 <Tabs defaultTab="next-intl" group='techno'>
@@ -1268,9 +1245,8 @@ export const config = {
 - **Встроенные инструменты**: Используйте встроенную маршрутизацию, помощники SEO и поддержку визуального редактора.
 
   </Tab>
-</Tabs>
 
----
+</Tabs>
 
 ## И победитель…
 
@@ -1298,6 +1274,7 @@ export const config = {
 - создан для современного Next.js, с модульным контентом, типобезопасностью, инструментами и меньшим количеством шаблонного кода. Если вы цените **контент, ограниченный компонентом**, **строгий TypeScript**, **гарантии на этапе сборки**, **tree-shaking** и **встроенные** маршрутизацию/SEO/редакторские инструменты, особенно для **Next.js App Router**, дизайн-систем и **больших, модульных кодовых баз**.
 
   </Column>
+
 </Columns>
 
 Если вы предпочитаете минимальную настройку и готовы к некоторой ручной интеграции, next-intl, хороший выбор. Если вам нужны все функции и вы не боитесь сложности, подойдет next-i18next. Но если вы хотите современное, масштабируемое, модульное решение с встроенными инструментами, Intlayer стремится предоставить это из коробки.
@@ -1312,8 +1289,6 @@ export const config = {
 
 [![График истории звёзд](https://api.star-history.com/chart?repos=i18next/next-i18next%2Camannn/next-intl%2Caymericzip/intlayer&type=date&legend=top-left)](https://www.star-history.com/#i18next/next-i18next&amannn/next-intl&aymericzip/intlayer)
 
----
-
 ## Заключение
 
 Все три библиотеки успешно справляются с основной локализацией. Разница в том, **сколько работы вам придется выполнить**, чтобы добиться надежной и масштабируемой настройки в **современном Next.js**:

package/blog/ru/nextjs-multilingual-seo-comparison.md

@@ -26,8 +26,6 @@ author: aymericzip
 
 В этом блоге мы рассмотрим, **почему i18n, это суперсила SEO**, и как правильно реализовать её в Next.js с помощью `next-intl`, `next-i18next` и `Intlayer`.
 
----
-
 ## Почему SEO и i18n
 
 Добавление языков, это не только про удобство пользователя (UX). Это также мощный рычаг для **органической видимости**. Вот почему:
@@ -37,8 +35,6 @@ author: aymericzip
 3. **Лучший UX:** Посетители сразу попадают на правильную версию вашего сайта.
 4. **Конкурентное преимущество:** Немногие сайты хорошо реализуют многоязычное SEO, что даёт вам возможность выделиться.
 
----
-
 ## Лучшие практики многоязычного SEO в Next.js
 
 Вот чеклист, который должно реализовать каждое многоязычное приложение:
@@ -57,8 +53,6 @@ author: aymericzip
 
 Это простые шаги, но их пропуск может стоить вам видимости.
 
----
-
 ## Примеры реализации
 
 Разработчики часто забывают правильно ссылаться на свои страницы в разных локалях, поэтому давайте посмотрим, как это работает на практике с различными библиотеками.
@@ -351,14 +345,10 @@ export default robots;
   </Tab>
 </Tabs>
 
----
-
 ## Проверьте свой сайт с помощью Intlayer SEO Scanner
 
 Чтобы убедиться, что ваше многоязычное приложение идеально оптимизировано, мы рекомендуем использовать [Intlayer SEO Scanner](https://intlayer.org/i18n-seo-scanner). Это специализированный инструмент для проверки многоязычных веб-сайтов, помогающий выявить недостающие теги hreflang, неработающие ссылки и другие проблемы SEO на всех ваших локализованных страницах.
 
----
-
 ## Заключение
 
 Правильная реализация i18n в Next.js, это не просто перевод текста, а обеспечение того, чтобы поисковые системы и пользователи точно знали, какую версию вашего контента показывать.

package/blog/ru/rag_powered_documentation_assistant.md

@@ -71,7 +71,6 @@ RAG стал популярным подходом не случайно: это
 6.  **Логирование запросов для обратной связи** Каждый пользовательский запрос сохраняется. Это бесценно для понимания болевых точек, отсутствующей документации или новых возможностей.
 
 <Steps>
-
 <Step number={1} title="Чтение документации">
 
 Первый шаг был простым: мне нужно было просканировать папку docs/ на наличие всех файлов с расширением .md. Используя Node.js и glob, я загрузил содержимое каждого Markdown-файла в память.
@@ -79,7 +78,6 @@ RAG стал популярным подходом не случайно: это
 Это сохраняет гибкость конвейера: вместо Markdown вы можете получать документы из базы данных, CMS или даже API.
 
 </Step>
-
 <Step number={2} title="Разбиение документации на части">
 
 Зачем разбивать? Потому что у языковых моделей есть **ограничения по контексту**. Передавать им целую книгу документации не получится.
@@ -99,7 +97,6 @@ RAG стал популярным подходом не случайно: это
 - Слишком большой → увеличивается размер контекста.
 
 </Step>
-
 <Step number={3} title="Генерация эмбеддингов">
 
 После разбиения документов на чанки мы генерируем **эмбеддинги**, векторы высокой размерности, представляющие каждый чанк.
@@ -119,7 +116,6 @@ RAG стал популярным подходом не случайно: это
 Каждый вектор, это математический отпечаток текста, позволяющий выполнять поиск по сходству.
 
 </Step>
-
 <Step number={4} title="Индексация и хранение эмбеддингов">
 
 Чтобы избежать многократной генерации эмбеддингов, я сохранил их в файле embeddings.json.
@@ -134,7 +130,6 @@ RAG стал популярным подходом не случайно: это
 Векторные базы данных обеспечивают индексацию, масштабируемость и быстрый поиск. Но для моего прототипа локальный JSON отлично подошёл.
 
 </Step>
-
 <Step number={5} title="Поиск с помощью косинусного сходства">
 
 Когда пользователь задаёт вопрос:
@@ -148,7 +143,6 @@ RAG стал популярным подходом не случайно: это
 Таким образом система находит наиболее близкие к запросу фрагменты документа.
 
 </Step>
-
 <Step number={6} title="Расширение + Генерация">
 
 Теперь начинается магия. Мы берём топ чанков и вставляем их в **системный промпт** для ChatGPT.
@@ -158,7 +152,6 @@ RAG стал популярным подходом не случайно: это
 Результат: точные, **основанные на документации ответы**.
 
 </Step>
-
 <Step number={7} title="Логирование запросов пользователей">
 
 Это скрытая суперсила.
@@ -173,7 +166,6 @@ RAG стал популярным подходом не случайно: это
 Это превращает вашего RAG-ассистента в **инструмент непрерывного исследования пользователей**.
 
 </Step>
-
 <Step number={8} title="Сколько это стоит?">
 
 Одно из распространённых возражений против RAG, стоимость. На практике это удивительно дешево:
@@ -185,7 +177,6 @@ RAG стал популярным подходом не случайно: это
 Кроме того, вы можете включить стоимость хостинга.
 
 </Step>
-
 <Step number={9} title="Детали реализации">
 
 Стек:
@@ -251,7 +242,6 @@ docUrl: "https://example.com/docs/ru/another-doc"
 👉 [Попробуйте демо здесь](https://intlayer.org/doc/why) 👉 [Посмотрите шаблон кода на GitHub](https://github.com/aymericzip/smart_doc_RAG)
 
 </Step>
-
 <Step number={10} title="Дальнейшие шаги">
 
 Этот проект является минимальной реализацией. Но вы можете расширить его во многих направлениях:
@@ -265,7 +255,6 @@ docUrl: "https://example.com/docs/ru/another-doc"
 - Улучшенный prompting → повторная ранжировка, фильтрация и гибридный поиск (ключевые слова + семантика)
 
 </Step>
-
 <Step number={11} title="Ограничения, с которыми мы столкнулись">
 
 - Разбиение на фрагменты и перекрытие эмпиричны. Правильный баланс (размер фрагмента, процент перекрытия, количество извлекаемых фрагментов) требует итераций и тестирования.
@@ -273,7 +262,6 @@ docUrl: "https://example.com/docs/ru/another-doc"
 - В этом прототипе эмбеддинги хранятся в формате JSON. Это подходит для демонстраций, но засоряет Git. В продакшене лучше использовать базу данных или специализированное хранилище векторов.
 
 </Step>
-
 <Step number={12} title="Почему это важно не только для документации">
 
 Интересная часть, это не просто чат-бот. Это **обратная связь**.
@@ -295,7 +283,6 @@ docUrl: "https://example.com/docs/ru/another-doc"
 Это **продуктовая аналитика** прямо от ваших пользователей.
 
 </Step>
-
 <Step number={13} title="Заключение">
 
 RAG, один из самых простых и мощных способов сделать LLM практичными. Объединив **извлечение + генерацию**, вы можете превратить статичную документацию в **умного помощника** и одновременно получить непрерывный поток инсайтов о продукте.