diff --git a/docs/faq.ru.md b/docs/faq.ru.md
new file mode 100644
index 0000000..c8a0049
--- /dev/null
+++ b/docs/faq.ru.md
@@ -0,0 +1,176 @@
+# Часто задаваемые вопросы
+
+Некоторые часто задаваемые вопросы
+
+## Как импортировать таблицу
+
+[fcitx5-android#175](https://github.com/fcitx5-android/fcitx5-android/pull/175) добавлена поддержка импорта метода ввода на основе кодовой таблицы, поэтому после `0.0.3-43` вы можете импортировать кодовую таблицу, выполнив следующие действия:
+
+1. Получите файл конфигурации метода ввода (расширение имени файла должно быть `.conf` или `.conf.in`) и словарь кодовой таблицы (расширение имени файла должно быть `.dict` или `.txt`) для импорта. Возьмем, к примеру, "zhengma", вы можете скачать `zhengma.conf.in` и `zhengma.txt` по адресу [fcitx/fcitx5-table-extra](https://github.com/fcitx/fcitx5-table-extra).
+2. Откройте приложение, перейдите в раздел Дополнения → Методы ввода кодовой таблицы (нажмите на шестеренку справа) → Управление методами ввода кодовой таблицы и нажмите кнопку "Плюс" в правом нижнем углу. В появившемся диалоговом окне выберите второй пункт, т.е. "Из отдельных файлов".
+3. В новом диалоговом окне нажмите "Файл конфигурации метода ввода" и выберите `zhengma.conf.in`, полученный на шаге 1; нажмите "Словарь кодовой таблицы (.dict или .txt)" и выберите `zhengma.txt`, полученный на шаге 1; и нажмите кнопку "ОК".
+4. Приложение должно создать уведомление об "импорте zheng,a.conf.in". Если файлы указаны правильно, операция может занять несколько секунд. После этого в списке появится "Zheng ma".
+
+## Как импортировать таблицу вручную
+
+Чтобы импортировать кодовую таблицу вручную, вам необходимо иметь правильный файл конфигурации метода ввода `.conf` и преобразовать словарь кодовой таблицы в формате `.txt` в формат `.dict` с помощью инструмента командной строки `libime_tabledict`.
+
+1. Получите файл конфигурации метода ввода (расширение имени файла должно быть `.conf` или `.conf.in`) и словарь кодовой таблицы (расширение имени файла должно быть `.dict` или `.txt`) для импорта. Возьмем, к примеру, "zhengma", вы можете скачать `zhengma.conf.in` и `zhengma.txt` по адресу [fcitx/fcitx5-table-extra](https://github.com/fcitx/fcitx5-table-extra).
+2. Откройте `zhengma.conf.in` в вашем любимом редакторе и измените путь, указанный после `[Table] File=` на `table/zhengma.dict`.
+3. Запустите команду `libya_tabledict zhengma.txt zhengma.dict`, чтобы преобразовать словарь кодовой таблицы. Этот инструмент обычно предоставляется пакетом под названием `libya` или `libya-bin` в дистрибутивах Linux.
+4. Скопируйте измененный `zhengma.conf` на шаге 2 в `/sdcard/Android/data/org.fcitx.fcitx5.android/files/data/inputmethod/`.
+5. Скопируйте преобразованный на шаге 3 файл `zhengma.dict` в файл `/sdcard/Android/data/org.fcitx.fcitx5.android/files/data/table/`.
+6. Перезапустите приложение (удалите задание или просто используйте принудительную остановку).
+
+!!! внимание
+
+ Указанные выше абсолютные пути могут не применяться, если вы настроили [рабочий профиль](https://developer.android.com/work/versions/android-11#work).
+ Мы рекомендуем использовать встроенный файловый менеджер (через DocumentsUI) для управления данными в Fcitx5 для Android.
+ Вы можете получить доступ к файлам в `/sdcard/Android/data/org.fcitx.fcitx5.android/files/` , выбрав "Fcitx5 для Android" на боковой панели DocumentsUI. Разрешения стороннего файлового менеджера /adb/root не требуются.
+
+!!! примечание
+
+ Создайте `inputmethod` и `table`, если они не существуют.
+
+## Как удалить запись о методе ввода
+
+Проведите пальцем влево по записи, пока фон не изменится на красный со значком корзины.
+
+[fcitx5-android#170](https://github.com/fcitx5-android/fcitx5-android/pull/170) добавляет удаление множественного выбора, поэтому после `0.0.3-37`
+вы можете нажать кнопку редактирования (карандаш) в правом верхнем углу списка методов ввода, чтобы перейти к множественному выбору. В этом режиме перед именем метода ввода появится флажок. Вы можете выбрать методы ввода, которые необходимо удалить,
+а затем нажать кнопку удалить (корзина для мусора) в правом верхнем углу.
+
+!!! подсказка
+
+ Та же операция применима к другим пользовательским интерфейсам в виде списков, таким как словарь Пиньинь, отображение знаков препинания и т. д.
+
+## Как настроить порядок методов ввода
+
+Длительно нажмите на запись, пока не появится тень внизу, а затем перетащите запись, чтобы изменить порядок.
+
+## Как изменить незафиксированный текст
+
+Когда preedit отображается на клавиатуре, вы можете провести по клавише пробела, чтобы переместить курсор; Если он отображается в приложении, вы можете переместить курсор в нужную позицию напрямую, кликом.
+
+!!! подсказка
+
+ Это полезно при составлении длинных предложений или изменении уже введенного содержимого.
+
+!!! примечание
+
+ Чтобы предварительное редактирование отображалось в приложении, включите *Показывать предварительное редактирование в приложении* в *Глобальных параметрах* и *Пиньинь*. Затем отключите *Игнорировать системную позицию курсора* в *Поведении*.
+ Если курсор перескакивает влево после перемещения, отключите *Исправить встроенный курсор предварительного редактирования в начале предварительного редактирования* в *Пиньинь*.
+
+## Как сбросить состояние ввода
+
+Чтобы очистить предварительное редактирование и кандидаты, нажмите и удерживайте клавишу Backspace, проведя пальцем влево на некоторое расстояние.
+
+## Как экспортировать файлы конфигурации или пользовательский словарь
+
+Файлы конфигурации, история ввода и пользовательский словарь сохраняются на внешнем хранилище. Путь по умолчанию - `/sdcard/Android/data/org.fcitx.fcitx5.android/files/`.
+История ввода и пользовательский словарь для Pinyin/Shuangpin находятся в `data/pinyin/user.{dict,history}`; для Wubi они находятся в `data/table/${name}.{dict,user.history}`.
+
+!!! внимание
+
+ Абсолютные пути выше могут не применяться, если вы настроили [рабочий профиль](https://developer.android.com/work/versions/android-11#work).
+ Мы рекомендуем использовать встроенный файловый менеджер (через DocumentsUI) для управления данными Fcitx5 для Android.
+ Вы можете получить доступ к файлам в `/sdcard/Android/data/org.fcitx.fcitx5.android/files/`, выбрав "Fcitx5 для Android" на боковой панели DocumentsUI. Разрешения стороннего файлового менеджера /adb/root не требуются.
+
+## Как импортировать словарь Пиньинь
+
+Fcitx 5 поддерживает пользовательские словари Пиньинь, которые хранятся в `data/pinyin/dictionaries`.
+Fcitx 5 для Android регистрирует три поддерживаемых типа файлов: `.dict`, `.scel` и `.txt`, поэтому вы можете импортировать словарь, открыв файл с помощью Fcitx5 для Android.
+
+!!! подсказка
+
+ Вы также можете управлять словарями с помощью *Словари Пиньинь* в настройках.
+
+## Какой формат словаря Пиньинь
+
+Импортируемый словарь Пиньинь должен быть в одном из следующих трех форматов:
+* [sougou scel dict](https://pinyin.sogou.com/dict/), файл `.scel`
+* текстовый формат libime, файл `.txt`, где слово, Полный Пиньинь и вес формируются в три столбца, например,
+ ```
+ 拼音 pin'yin 0
+ ```
+* двоичный формат libime, файл `.dict`, который можно преобразовать из текстового формата с помощью инструмента командной строки `libime_pinyindict`
+
+Если вы хотите создать свой собственный словарь, мы рекомендуем использовать формат `.txt`.
+
+!!! примечание
+
+ При импорте словаря `.scel` или `.txt` он будет автоматически преобразован в формат `.dict`.
+
+!!! подсказка
+
+ Вы можете обратиться к встроенному [словарю эмодзи](https://github.com/fcitx/fcitx5-chinese-addons/blob/5.0.16/im/pinyin/emoji.txt)как к примеру текстового формата libime.
+
+!!! подсказка
+
+ Некоторые сторонние словари Пиньинь могут предоставлять готовый к импорту двоичный формат libime, например [fcitx5-pinyin-zhwiki](https://github.com/felixonmars/fcitx5-pinyin-zhwiki) и [mw2fcitx](https://github.com/outloudvi/mw2fcitx).
+
+## Как ввести смайлик, эмодзи или определенный символ Unicode
+
+Нажмите и удерживайте клавишу `,`, проведя пальцем в сторону одного из трех появившихся значков.
+
+
+
+Первая иконка активирует режим unicode. Вы можете искать unicode по коду или описанию:
+
+
+
+!!! подсказка
+
+ Подробности символов Unicode можно найти в [Списке символов Unicode](https://symbl.cc/en/unicode-table/) или [Списке символов Unicode](https://en.wikipedia.org/wiki/List_of_Unicode_characters).
+
+Вторая иконка переключается на клавиатуру эмодзи:
+
+
+
+Клавиша `:-)` ниже переключает на клавиатуру смайлов.
+
+Третий значок активирует быструю фразу:
+
+
+
+## Как исправить перекрытие клавиатуры панелью навигации
+
+Клавиатура может перекрывать панель навигации на некоторых устройствах:
+
+
+
+Причина не ясна, но ее можно исправить, установив *Фон панели навигации* на *Следовать цвету клавиатуры* в настройках темы.
+
+## Что такое "Активировать по умолчанию" в "Глобальных параметрах"
+
+## Что такое "Поделиться состоянием ввода" в "Глобальных параметрах"
+
+Эта функция позволяет вам делиться контекстом ввода (в основном активным методом ввода) между приложениями. Есть три варианта:
+
+- All: всегда использовать один и тот же метод ввода при переключении между приложениями
+- Program: запомнить последний использованный метод ввода для каждого приложения
+- No: это значение по умолчанию. На Android есть только один *InputContext* для каждого приложения, эта опция ведет себя точно так же, как *Program*
+
+## Как настроить профиль преобразования OpenCC?
+
+Откройте «Дополнения — Перевод с упрощенного и традиционного китайского», установите «Движок перевода» на «OpenCC».
+
+Чтобы настроить преобразование, установите «Профиль OpenCC для упрощенного в традиционный» на одно из следующих значений:
+
+- `s2hk.json` Упрощенный Китайский в Традиционный Китайский (Гонконгский Вариант)
+- `s2t.json` Упрощенный Китайский в Традиционный Китайский
+- `s2tw.json` Упрощенный Китайский в Традиционный Китайский (Тайваньский Стандарт)
+- `s2twp.json` Упрощенный Китайский в Традиционный Китайский (Тайваньский Стандарт) с тайваньским идиоматическим диалектом
+
+Чтобы настроить обратное преобразование, установите для параметра "Профиль OpenCC для Традиционного в Упрощенный" одно из следующих значений:
+
+- `hk2s.json` Традиционный Китайский (Гонконгский Вариант) в Упрощенный Китайский
+- `hk2t.json` Традиционный Китайский (Гонконгский Вариант) в Традиционный Китайский
+- `jp2t.json` Новые японские Кандзи (Синдзитай) в Традиционные китайские иероглифы (Кюдзитай)
+- `t2hk.json` Традиционный Китайский (Стандарт OpenCC) в Гонконгский Вариант
+- `t2jp.json` Традиционные Китайские иероглифы (Кюдзитай) в Новые японские Кандзи (Синдзитай)
+- `t2s.json` Традиционный Китайский в Упрощенный Китайский
+- `t2tw.json` Традиционный Китайский (Стандарт OpenCC) в Тайваньский Стандарт
+- `tw2s.json` Традиционный Китайский (Тайваньский Стандарт) в Упрощенный Китайский
+- `tw2sp.json` Традиционный Китайский (Тайваньский Стандарт) в Упрощенный Китайский с идиомой материкового Китая
+- `tw2t.json` Традиционный Китайский (Тайваньский Стандарт) в Традиционный Китайский
diff --git a/docs/index.ru.md b/docs/index.ru.md
new file mode 100644
index 0000000..44246b2
--- /dev/null
+++ b/docs/index.ru.md
@@ -0,0 +1,14 @@
+---
+скрыть:
+ - навигация
+---
+
+# Fcitx5 для Android
+
+* Следите за разработкой в Trello:
+* Присоединяйтесь к комнате Matrix:
+* Присоединяйтесь к группе в Telegram:
+
+!!! Информация
+
+ Группы Telegram и Matrix объединены.
diff --git a/docs/installation.ru.md b/docs/installation.ru.md
new file mode 100644
index 0000000..01c4ab7
--- /dev/null
+++ b/docs/installation.ru.md
@@ -0,0 +1,24 @@
+# Установка
+
+## Тегированные релизы
+
+Вы можете получить стабильную версию fcitx5-android из GitHub Release / F-Droid / Google Play.
+
+!!! примечание
+
+ fcitx5-android реализует [воспроизводимую сборку](https://f-droid.org/en/docs/Reproducible_Builds/), таким образом, apk из GitHub Release и F-Droid могут переопределять друг друга. Однако из-за ограничений Google Play, версия из Google Play не может быть переопределена другими версиями.
+
+GitHub: [](https://github.com/fcitx5-android/fcitx5-android/releases)
+
+[
](https://f-droid.org/packages/org.fcitx.fcitx5.android)
+[
](https://play.google.com/store/apps/details?id=org.fcitx.fcitx5.android)
+
+## Последняя сборка CI
+
+Вы можете загрузить последнюю сборку из [Jenkins](https://jenkins.fcitx-im.org/job/android/job/fcitx5-android/). Также есть [Updater](#updater) для загрузки и управления установкой.
+
+## Updater
+
+[fcitx5-android-updater](https://github.com/fcitx5-android/fcitx5-android-updater) — это независимое приложение, которое загружает и устанавливает apk-файлы из Jenkins, включая плагины и сам updater.
+
+Вы также можете загрузить updater из Jenkins: [fcitx5-android-updater [android] [Jenkins]](https://jenkins.fcitx-im.org/job/android/job/fcitx5-android-updater/)
diff --git a/docs/privacy.ru.md b/docs/privacy.ru.md
new file mode 100644
index 0000000..047adc5
--- /dev/null
+++ b/docs/privacy.ru.md
@@ -0,0 +1,8 @@
+---
+скрыть:
+- навигация
+---
+
+# Конфиденциальность
+
+`fcitx5-android` не требует доступа в интернет и не собирает никаких персональных данных.
diff --git a/mkdocs.yml b/mkdocs.yml
index f42ac33..ffd70a2 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -66,6 +66,10 @@ plugins:
default: false
locale: en
name: English
+ - build: true
+ default: false
+ locale: ru
+ name: Русский
- build: true
default: true
locale: zh