> For the complete documentation index, see [llms.txt](https://vitrina-blogerov.gitbook.io/bloggers-showcase/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vitrina-blogerov.gitbook.io/bloggers-showcase/lokalizaciya/podderzhivaemye-yazyki.md).

# Поддерживаемые языки

В текущей поставке Bloggers Bot Platform поддерживает четыре языковые версии: русскую, английскую, китайскую и арабскую.

{% hint style="info" %}
Каждый язык поставляется как отдельная рабочая версия платформы. Это не переключатель внутри одной базы, а отдельный стек с собственным ботом, базой и настройками.
{% endhint %}

### Доступные версии

| Код  | Язык       | Архив установки          |
| ---- | ---------- | ------------------------ |
| `ru` | Русский    | `bloggers_bot_ru.tar.gz` |
| `en` | Английский | `bloggers_bot_en.tar.gz` |
| `zh` | Китайский  | `bloggers_bot_zh.tar.gz` |
| `ar` | Арабский   | `bloggers_bot_ar.tar.gz` |

### Адреса на домене

После установки версии доступны по отдельным путям:

{% tabs %}
{% tab title="RU" %}

```
https://example.com/bloggers/ru/
```

{% endtab %}

{% tab title="EN" %}

```
https://example.com/bloggers/en/
```

{% endtab %}

{% tab title="ZH" %}

```
https://example.com/bloggers/zh/
```

{% endtab %}

{% tab title="AR" %}

```
https://example.com/bloggers/ar/
```

{% endtab %}
{% endtabs %}

Домен может быть один, но каждая языковая версия ведет в отдельный backend и отдельную PostgreSQL-базу.

### Как выбирается версия для пользователя

Если установлено несколько языков, платформа может направить пользователя в подходящую версию.

Приоритет выбора:

1. язык пользователя в Telegram;
2. язык браузера;
3. резервный порядок: `en`, затем `zh`, затем `ar`, затем `ru`.

Учитываются только те версии, которые реально установлены на сервере.

```mermaid
flowchart TD
    A["Пользователь открывает платформу"] --> B{"Есть язык Telegram?"}
    B -->|Да| C{"Эта версия установлена?"}
    B -->|Нет| D{"Есть язык браузера?"}
    C -->|Да| E["Открыть версию"]
    C -->|Нет| D
    D -->|Да| F{"Версия браузера установлена?"}
    D -->|Нет| G["Резервный порядок"]
    F -->|Да| E
    F -->|Нет| G
    G --> E
```

{% hint style="success" %}
Если установлена только одна версия, пользователь может быть сразу перенаправлен на нее.
{% endhint %}

### Что означает поддержка языка

Поддержка языка означает, что для него можно установить отдельную рабочую версию платформы.

Такая версия получает:

* собственный URL;
* собственную PostgreSQL-базу;
* собственный Telegram-бот;
* собственную админ-панель;
* собственные настройки;
* собственный каталог блогеров;
* собственные AI-промпты;
* собственных администраторов.

### Важное ограничение Telegram

Один Telegram bot token нельзя безопасно использовать для нескольких языковых версий.

{% hint style="warning" %}
Для каждой версии нужен отдельный Telegram-бот. Telegram polling и кнопка меню бота привязаны к конкретному токену и конкретной ссылке Mini App.
{% endhint %}

Установщик проверяет повторное использование токена и останавливает установку, если такой токен уже назначен другой версии.

### Расширение списка языков

Текущая поставка рассчитана на `ru`, `en`, `zh` и `ar`.

<details>

<summary>Почему новый язык - это отдельное расширение</summary>

Добавление нового языка - это не только перевод интерфейса. Для новой версии нужно подготовить отдельный архив, публичный путь, тексты интерфейса, контент, бота, настройки установки, правила маршрутизации и документацию.

</details>

Новые языки следует планировать как отдельное расширение платформы.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://vitrina-blogerov.gitbook.io/bloggers-showcase/lokalizaciya/podderzhivaemye-yazyki.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.