@intlayer/docs 9.5.6 → 9.5.8

package/docs/ru/cli/infra.md

@@ -0,0 +1,162 @@
+---
+createdAt: 2026-09-21
+updatedAt: 2026-09-21
+title: CLI - Init Infra
+description: Узнайте, как использовать команду init infra CLI Intlayer для установки десктопного приложения или самостоятельного хостинга CMS Intlayer с помощью Docker (контейнер «все в одном» или стек Docker Compose).
+keywords:
+  - CLI
+  - Инфраструктура
+  - Собственный хостинг
+  - Десктопное приложение
+  - Docker
+  - Docker Compose
+  - CMS
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - infra
+history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Добавить команду init infra"
+author: aymericzip
+---
+
+# Команда Intlayer CLI Init Infra
+
+## Описание
+
+Команда `init infra` настраивает инфраструктуру Intlayer на вашем компьютере. Она загружает размещенный установщик для вашей платформы (`https://intlayer.org/install.sh` на macOS / Linux, `https://intlayer.org/install.ps1` на Windows) и запускает его в подключенном терминале, поэтому меню и ход выполнения отображаются без изменений.
+
+Установщик предлагает выбрать способ запуска Intlayer:
+
+- **Десктопное приложение**: загружает нативное приложение для вашей ОС и процессора и открывает или устанавливает его. Десктопная сборка взаимодействует с бэкендом Intlayer Cloud.
+- **Docker «все в одном» (All-in-one)**: панель управления + API + MongoDB + Redis + MinIO в едином контейнере с одним томом данных. Записывает `./intlayer.env` со сгенерированными секретами и загружает образ `intlayer/cms-all`.
+- **Docker Compose**: один контейнер на сервис для масштабируемого хостинга. Записывает `docker-compose.yml` и `.env` в `./intlayer/` и загружает образы.
+
+Размещенный установщик является единственным источником истины для процесса установки: CLI запускает его вместо повторной реализации тех же шагов, поэтому `npx intlayer init infra` и `curl -fsSL https://intlayer.org/install.sh | sh` выполняют одни и те же действия.
+
+## Использование
+
+```bash packageManager="npm"
+npx intlayer init infra [options]
+```
+
+```bash packageManager="yarn"
+yarn intlayer init infra [options]
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer init infra [options]
+```
+
+```bash packageManager="bun"
+bun x intlayer init infra [options]
+```
+
+Этот же шаг предлагается в интерактивном списке `npx intlayer init --interactive` в пункте **Инфраструктура (десктопное приложение / собственный хостинг)**.
+
+## Опции
+
+- `-m, --mode <mode>` - Необязательно. Пропускает меню установщика и запускает указанный режим напрямую. Допустимые значения: `desktop`, `docker` (all-in-one) или `compose`. Любое другое значение завершает работу с ошибкой.
+
+## Примеры
+
+### Интерактивный выбор режима
+
+```bash
+npx intlayer init infra
+```
+
+### Установка десктопного приложения
+
+```bash
+npx intlayer init infra --mode desktop
+```
+
+### Собственный хостинг в контейнере «все в одном»
+
+```bash
+npx intlayer init infra --mode docker
+```
+
+### Собственный хостинг с Docker Compose
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+## Пример вывода
+
+```bash
+npx intlayer init infra --mode compose
+◇  Installer downloaded
+▸ Fetching docker-compose.yml into ./intlayer
+▸ Writing ./intlayer/.env
+▸ Pulling images
+
+  Everything is installed. Two steps left.
+
+  1. Configure a mailer in:
+
+       ./intlayer/.env
+
+     Either RESEND_API_KEY (resend.com) or the MAIL_SMTP_* block — the first
+     account cannot be verified without a working mailer.
+  2. Start the stack:
+
+       cd ./intlayer && docker compose up -d
+
+  Then open http://localhost:3000 — first boot initialises the
+  datastores, so give it a minute. The first account you create becomes the
+  super admin.
+
+    Logs      docker compose logs -f
+    Stop      docker compose down
+    Upgrade   docker compose pull && docker compose up -d
+```
+
+## Параметры установщика
+
+Установщик считывает несколько переменных окружения, которые CLI передает без изменений. Задайте их в терминале перед выполнением команды:
+
+```bash
+INTLAYER_COMPOSE_DIR=./cms npx intlayer init infra --mode compose
+```
+
+| Переменная                | По умолчанию              | Применяется к | Описание                                                   |
+| ------------------------- | ------------------------- | ------------- | ---------------------------------------------------------- |
+| `INTLAYER_MODE`           | _(запрашивается)_         | все           | `desktop`, `docker` или `compose`, аналогично `--mode`     |
+| `INTLAYER_DOWNLOAD_DIR`   | `~/Downloads`             | desktop       | Куда сохраняется установщик приложения                     |
+| `INTLAYER_IMAGE`          | `intlayer/cms-all:latest` | docker        | Образ «все в одном» для загрузки                           |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`          | docker        | Куда записывать файл переменных окружения                  |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                | docker        | Имя контейнера                                             |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`           | docker        | Именованный том, монтируемый в `/data`                     |
+| `INTLAYER_APP_PORT`       | `3000`                    | docker        | Порт хоста для панели управления                           |
+| `INTLAYER_API_PORT`       | `3100`                    | docker        | Порт хоста для API                                         |
+| `INTLAYER_S3_PORT`        | `9000`                    | docker        | Порт хоста для MinIO S3 API                                |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                    | docker        | Порт хоста для консоли MinIO                               |
+| `INTLAYER_COMPOSE_DIR`    | `./intlayer`              | compose       | Куда записываются `docker-compose.yml` и `.env`            |
+| `INTLAYER_SELFHOST_REF`   | `main`                    | оба           | Git ref, из которого загружаются compose-файл и шаблон env |
+
+> Переменные портов изменяют только сопоставление со стороны **хоста**. В опубликованных образах значения `http://localhost:3000`, `http://localhost:3100` и `http://localhost:9000` скомпилированы в сборку, поэтому сохраняйте значения по умолчанию, если не собираете собственные образы: смотрите [руководство по самостоятельному хостингу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/self_hosting.md#limitations).
+
+## Требования
+
+- **Десктопное приложение** требует [Node.js](https://nodejs.org): приложение включает сервер панели управления и запускает его с помощью установленного бинарного файла `node`.
+- **Режимы Docker** требуют [Docker](https://docs.docker.com/get-docker/) (Docker Desktop с WSL 2 в Windows). Для режима Compose также требуется плагин `docker compose`.
+
+## Примечания
+
+- Повторный запуск команды безопасен: существующий файл окружения не перезаписывается, что также служит способом обновления (установщик загружает свежие образы и сохраняет ваши секреты).
+- Установщик загружается во временную директорию и удаляется после завершения работы независимо от результата.
+- Код завершения команды соответствует коду установщика. Если загрузка не удалась, CLI выводит эквивалентную команду `curl … | sh` (или `irm … | iex`).
+- Режимам Docker требуется почтовый сервис для отправки ссылок авторизации. После завершения работы установщика настройте Resend или SMTP в созданном файле окружения: смотрите [Глобальный почтовый сервис](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/self_hosting.md#global-mailer).
+
+## Связанные документы
+
+- [Руководство по самостоятельному хостингу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/self_hosting.md) - Архитектура, первые шаги и ограничения каждого режима
+- [Инициализация Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/init.md) - Родительская команда `init` и её интерактивный список
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md) - Возможности установленной панели управления

package/docs/ru/cli/init.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-12-30
-updatedAt: 2025-12-30
+updatedAt: 2026-09-21
 title: Инициализация Intlayer
 description: Узнайте, как инициализировать Intlayer в вашем проекте.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - cli
   - init
 history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Добавить подкоманду init infra"
   - version: 8.6.4
     date: 2026-03-31
     changes: "Добавлена опция --no-gitignore"
@@ -125,6 +128,26 @@ bun x intlayer init --no-gitignore
 
 Это настроит все файлы конфигурации, но не изменит ваш `.gitignore`.
 
+### Настройка инфраструктуры (десктопное приложение или собственный хостинг):
+
+```bash
+npx intlayer init infra
+```
+
+Загружает и запускает размещенный установщик (`https://intlayer.org/install.sh`, или `install.ps1` в Windows), который предлагает выбрать способ запуска Intlayer:
+
+- **Десктопное приложение** - устанавливает нативное приложение панели управления на ваш компьютер, подключенное к Intlayer Cloud.
+- **Docker «все в одном» (All-in-one)** - панель управления + API + MongoDB + Redis + MinIO в едином контейнере.
+- **Docker Compose** - отдельный контейнер для каждого сервиса для масштабируемого собственного хостинга.
+
+Пропустите меню с помощью флага `--mode`:
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+Этот же шаг доступен в `npx intlayer init --interactive`. Смотрите [справочник `init infra`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/infra.md) для параметров установщика и [руководство по самостоятельному хостингу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/self_hosting.md) для описания каждого режима.
+
 ## Пример вывода:
 
 ```bash

package/docs/ru/cli/upgrade.md

@@ -0,0 +1,125 @@
+---
+createdAt: 2026-09-23
+updatedAt: 2026-09-23
+title: CLI - Обновление пакетов Intlayer
+description: Узнайте, как использовать команду upgrade в Intlayer CLI для вывода списка всех пакетов Intlayer вашего проекта или монорепозитория и их обновления до последней версии.
+keywords:
+  - CLI
+  - Upgrade
+  - Обновление
+  - Пакеты
+  - Монорепозиторий
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - upgrade
+history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "Добавить команду upgrade"
+author: aymericzip
+---
+
+# Обновление пакетов Intlayer
+
+```bash packageManager="npm"
+npx intlayer upgrade
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade
+```
+
+Команда `upgrade` выводит список пакетов Intlayer, объявленных в каждом `package.json` вашего проекта, включая воркспейсы монорепозитория, и обновляет их до последней опубликованной версии. Она автономно выполняет тот же шаг обновления пакетов, что и `intlayer init`.
+
+## Аргументы:
+
+- `--project-root [projectRoot]` - Необязательно. Корневой каталог проекта. По умолчанию команда начинает поиск с ближайшего `package.json` выше текущего рабочего каталога.
+- `--dry-run` - Необязательно. Выводит список пакетов и их целевую версию без изменения файлов.
+- `--tag <tag>` - Необязательно. npm dist-tag для обновления (например, `canary`). По умолчанию `latest`.
+
+## Что делает команда:
+
+1. **Составляет список пакетов Intlayer** - Сканирует каждый `package.json` проекта (пропуская `node_modules` и результаты сборки) на наличие зависимостей и dev-зависимостей `intlayer`, `@intlayer/*`, `*-intlayer` и `intlayer-*`.
+2. **Получает целевую версию** - Считывает версию выбранного dist-tag (по умолчанию `latest`) каждого пакета из реестра npm.
+3. **Переписывает диапазоны** - Обновляет каждый устаревший диапазон прямо в файле, сохраняя его оператор (`^`, `~` или без оператора) и форматирование файла.
+4. **Устанавливает за один раз** - Выполняет единую установку из корня воркспейса (ближайшего каталога с lock-файлом), используя пакетный менеджер, которому принадлежит lock-файл:
+
+| Lock-файл                   | Команда        |
+| --------------------------- | -------------- |
+| `bun.lock` / `bun.lockb`    | `bun install`  |
+| `pnpm-lock.yaml`            | `pnpm install` |
+| `yarn.lock`                 | `yarn install` |
+| `package-lock.json` или нет | `npm install`  |
+
+Если lock-файл отсутствует, используется поле `packageManager` из `package.json` (например, `"bun@1.2.0"`), прежде чем вернуться к npm.
+
+Диапазоны, не указывающие на реестр, такие как `workspace:*`, `file:`, `link:`, `catalog:` или git-URL, никогда не изменяются.
+
+## Примеры:
+
+### Вывести список доступных обновлений без их применения:
+
+```bash packageManager="npm"
+npx intlayer upgrade --dry-run
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade --dry-run
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade --dry-run
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade --dry-run
+```
+
+### Обновить до canary-релиза:
+
+```bash packageManager="npm"
+npx intlayer upgrade --tag canary
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade --tag canary
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade --tag canary
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade --tag canary
+```
+
+## Пример вывода:
+
+```bash
+npx intlayer upgrade
+Intlayer packages:
+  package.json
+    intlayer ^9.0.0 → ^9.5.7
+  apps/web/package.json
+    next-intlayer ^9.5.7 (latest)
+    vite-intlayer ~9.2.0 → ~9.5.7
+Running bun install...
+✓ Upgraded 2 Intlayer dependencies to latest
+```
+
+## Примечания:
+
+- Запустите команду из корня вашего репозитория, чтобы обновить все воркспейсы. Запустите ее из конкретного воркспейса, чтобы обновить только его.
+- Пакеты, версию которых не удалось получить (офлайн, приватный или неопубликованный пакет), выводятся в списке и остаются без изменений.
+- Если установка завершается с ошибкой, обновленные диапазоны сохраняются в `package.json`. Запустите команду установки вашего пакетного менеджера вручную.

package/docs/ru/dictionary/html.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-01-20
-updatedAt: 2026-03-24
+updatedAt: 2026-09-21
 title: HTML-контент
 description: Узнайте, как объявлять и использовать HTML-контент с пользовательскими компонентами в Intlayer. Следуйте этой документации, чтобы встроить богатый HTML-подобный контент с динамической заменой компонентов в ваш проект с поддержкой интернационализации.
 keywords:
@@ -13,6 +13,8 @@ keywords:
   - React
   - Vue
   - Svelte
+  - Remix
+  - Astro
   - Solid
   - Angular
 slugs:
@@ -238,6 +240,83 @@ const myContent = html(
     ```
 
   </Tab>
+  <Tab label="Remix" value="remix">
+    В Remix 3 узлы HTML преобразуются в строку HTML. Внедрите ее с помощью пропа `innerHTML` в Remix JSX или с помощью `html.raw` в представлении `html-template`.
+
+    ```tsx fileName="src/views/home.tsx"
+    import { useIntlayer } from "remix-intlayer";
+
+    export const HomePage = () => () => {
+      const { myHtmlContent } = useIntlayer("app");
+
+      return <div innerHTML={myHtmlContent.value} />;
+    };
+    ```
+
+    ```ts fileName="src/views/home.ts"
+    import { html } from "remix/html-template";
+    import { useIntlayer } from "remix-intlayer";
+
+    export const renderHomePage = () => {
+      const { myHtmlContent } = useIntlayer("app");
+
+      return html.raw`<div>${myHtmlContent.value}</div>`;
+    };
+    ```
+
+    > Remix экранирует интерполированные значения по умолчанию. `innerHTML` и `html.raw` — это два способа отказа от экранирования, что и требуется для строки HTML.
+
+    Используйте метод `.use()` для переопределения тегов или сопоставления пользовательских компонентов. Переопределения — это функции, возвращающие строку HTML:
+
+    ```tsx
+    <div
+      innerHTML={myHtmlContent.use({
+        p: ({ children }) => `<p class="prose">${children}</p>`,
+        CustomLink: ({ children }) => `<a href="/details">${children}</a>`,
+      })}
+    />
+    ```
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+    В Astro узлы HTML преобразуются в строку HTML. Внедрите ее с помощью директивы `set:html` в шаблоне или с помощью `innerHTML` в клиентском теге `<script>`.
+
+    ```astro fileName="src/pages/index.astro"
+    ---
+    import { useIntlayer } from "astro-intlayer";
+
+    const { myHtmlContent } = useIntlayer("app");
+    ---
+
+    <div set:html={myHtmlContent.value} />
+    ```
+
+    ```astro fileName="src/components/Content.astro"
+    <div id="content"></div>
+
+    <script>
+      import { useIntlayer } from "astro-intlayer";
+
+      const { myHtmlContent } = useIntlayer("app");
+
+      document.querySelector("#content")!.innerHTML = myHtmlContent.value;
+    </script>
+    ```
+
+    > Astro экранирует `{выражения}` по умолчанию. `set:html` — это способ отказа от экранирования, что и требуется для строки HTML.
+
+    Используйте метод `.use()` для переопределения тегов или сопоставления пользовательских компонентов. Переопределения — это функции, возвращающие строку HTML:
+
+    ```astro
+    <div
+      set:html={myHtmlContent.use({
+        p: ({ children }) => `<p class="prose">${children}</p>`,
+        CustomLink: ({ children }) => `<a href="/details">${children}</a>`,
+      })}
+    />
+    ```
+
+  </Tab>
 </Tabs>
 
 ## Глобальная конфигурация с `HTMLProvider`
@@ -473,6 +552,41 @@ const myContent = html(
     > Динамический импорт рендерера HTML - хороший способ уменьшить размер бандла вашего приложения.
 
   </Tab>
+  <Tab label="Remix" value="remix">
+
+    В Remix нет дерева компонентов для размещения провайдера, поэтому конфигурация устанавливается один раз как синглтон при запуске сервера. Она настраивает рендерер, возвращаемый `useHTMLRenderer()`. Узлы `html`, возвращаемые `useIntlayer`, отображаются как есть; переопределяйте их теги для каждого узла с помощью `.use()`.
+
+    ```typescript fileName="src/router.ts"
+    import { installIntlayerHTML } from "remix-intlayer/html";
+
+    installIntlayerHTML({
+      renderHTML: (html) => html.replaceAll("<p>", '<p class="prose">'),
+    });
+    ```
+
+    > Используйте `installIntlayerHTMLDynamic(async () => …)` для отложенной загрузки самого рендерера; загрузчик выполняется только при первом вызове.
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+
+    В Astro нет дерева компонентов для размещения провайдера, поэтому конфигурация устанавливается один раз как синглтон в middleware (сервер) и в клиентском теге `<script>` (браузер). Она настраивает рендерер, возвращаемый `useHTMLRenderer()`. Узлы `html`, возвращаемые `useIntlayer`, отображаются как есть; переопределяйте их теги для каждого узла с помощью `.use()`.
+
+    ```typescript fileName="src/middleware.ts"
+    import { installIntlayerHTML } from "astro-intlayer/html";
+    import { defineMiddleware } from "astro:middleware";
+
+    // Запускается один раз при старте сервера; сам middleware Intlayer
+    // регистрируется интеграцией перед этим файлом.
+    installIntlayerHTML({
+      renderHTML: (html) => html.replaceAll("<p>", '<p class="prose">'),
+    });
+
+    export const onRequest = defineMiddleware((_context, next) => next());
+    ```
+
+    > Используйте `installIntlayerHTMLDynamic(async () => …)` для отложенной загрузки самого рендерера; загрузчик выполняется только при первом вызове.
+
+  </Tab>
 </Tabs>
 
 ### Ручной рендеринг и расширенные инструменты
@@ -646,15 +760,69 @@ const myContent = html(
     ```
 
   </Tab>
+  <Tab label="Remix" value="remix">
+    #### Хук `useHTMLRenderer()`
+
+    Получите функцию рендеринга, предварительно настроенную с помощью `installIntlayerHTML()`. Она возвращает строку HTML.
+
+    ```tsx
+    import { useHTMLRenderer } from "remix-intlayer/html";
+
+    const renderHTML = useHTMLRenderer();
+
+    return <div innerHTML={renderHTML("<p>Hello <strong>World</strong></p>")} />;
+    ```
+
+    #### Утилита `renderHTML()`
+
+    Автономная утилита, игнорирующая глобальную конфигурацию.
+
+    ```tsx
+    import { renderHTML } from "remix-intlayer/html";
+
+    const html = renderHTML("<p>Hello</p>");
+    ```
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+    #### Хук `useHTMLRenderer()`
+
+    Получите функцию рендеринга, предварительно настроенную с помощью `installIntlayerHTML()`. Она возвращает строку HTML.
+
+    ```astro
+    ---
+    import { useHTMLRenderer } from "astro-intlayer/html";
+
+    const renderHTML = useHTMLRenderer();
+    ---
+
+    <div set:html={renderHTML("<p>Hello <strong>World</strong></p>")} />
+    ```
+
+    #### Утилита `renderHTML()`
+
+    Автономная утилита, игнорирующая глобальную конфигурацию.
+
+    ```astro
+    ---
+    import { renderHTML } from "astro-intlayer/html";
+
+    const html = renderHTML("<p>Hello</p>");
+    ---
+
+    <div set:html={html} />
+    ```
+
+  </Tab>
 </Tabs>
 
 ## Справочник опций
 
 Эти опции могут быть переданы в `HTMLProvider`, `HTMLRenderer`, `useHTMLRenderer` и `renderHTML`.
 
-| Опция        | Тип                   | По умолчанию | Описание                                                                                                             |
-| :----------- | :-------------------- | :----------- | :------------------------------------------------------------------------------------------------------------------- |
-| `components` | `Record<string, any>` | `{}`         | Отображение HTML-тегов или имён пользовательских компонентов на соответствующие компоненты.                          |
-| `renderHTML` | `Function`            | `null`       | Пользовательская функция рендеринга для полной замены стандартного HTML-парсера (только для провайдеров Vue/Svelte). |
+| Опция        | Тип                   | По умолчанию | Описание                                                                                                                 |
+| :----------- | :-------------------- | :----------- | :----------------------------------------------------------------------------------------------------------------------- |
+| `components` | `Record<string, any>` | `{}`         | Отображение HTML-тегов или имён пользовательских компонентов на соответствующие компоненты.                              |
+| `renderHTML` | `Function`            | `null`       | Пользовательская функция рендеринга для полной замены стандартного HTML-парсера (провайдеры Vue, Svelte, Remix и Astro). |
 
 > Примечание: для React и Preact стандартные HTML-теги предоставляются автоматически. Вам нужно передавать проп `components` только если вы хотите переопределить их или добавить пользовательские компоненты.