fix: add plugins ru translation

Author: qubka

content/ru/6.plugins/0.plugins.md

@@ -0,0 +1,5 @@
+---
+title: Plugins
+navigation: false
+---
+

content/ru/6.plugins/1.config-system/1.features.md

@@ -0,0 +1,54 @@
+---
+title: Особенности
+description: Откройте для себя основные особенности и типичные сценарии использования плагина, включая реальные примеры, где он проявляет себя наилучшим образом.
+icon: lucide:star
+---
+
+**Плагин Config System** — это универсальный и мощный инструмент, предназначенный для управления файлами конфигурации других плагинов в экосистеме Plugify. Он поддерживает несколько форматов файлов, включая **JSON**, **XML** и **KeyValues**, и может быть расширен с помощью подмодулей для поддержки дополнительных форматов. Плагин позволяет беспрепятственно читать, записывать и объединять файлы конфигурации, гарантируя сохранение пользовательских настроек даже во время обновлений плагинов.
+
+## **Ключевые особенности**
+
+### **1. Поддержка нескольких форматов**
+- Поддерживает популярные форматы файлов конфигурации, включая:
+    - **JSON**
+    - **XML**
+    - **KeyValues3**
+- Расширяемая архитектура позволяет добавлять поддержку новых форматов через подмодули.
+
+### **2. Чтение и запись конфигураций**
+- Легко читайте и записывайте файлы конфигурации из других плагинов.
+- Предоставляет простой и интуитивно понятный API для управления данными конфигурации.
+
+### **3. Объединение конфигураций**
+- Автоматически объединяет пользовательские конфигурации с обновленными конфигурациями плагинов.
+- Гарантирует сохранение пользовательских настроек во время обновлений плагинов.
+
+### **4. Двойное расположение конфигураций**
+- **Папка плагина**: Основные файлы конфигурации хранятся в папке плагина.
+- **Папка пользовательских конфигураций**: Пользовательские конфигурации хранятся в `res/configs`, что гарантирует, что они не будут перезаписаны во время обновлений.
+
+### **5. Интеграция с системой обновлений**
+- Беспрепятственно работает с системой обновлений Plugify для объединения обновленных конфигураций с пользовательскими настройками.
+- Предотвращает потерю пользовательских настроек во время обновлений плагинов.
+
+### **6. Легковесность и эффективность**
+- Минимальные накладные расходы для высокопроизводительных приложений.
+- Оптимизирован как по скорости, так и по использованию памяти.
+
+## **Сценарии использования**
+
+### **1. Управление конфигурацией плагинов**
+- Управляйте файлами конфигурации для других плагинов в экосистеме Plugify.
+- Предоставляйте последовательный и удобный способ обработки настроек плагинов.
+
+### **2. Сохранение пользовательских настроек**
+- Гарантируйте сохранение пользовательских конфигураций во время обновлений плагинов.
+- Беспрепятственно объединяйте обновленные конфигурации с пользовательскими настройками.
+
+### **3. Поддержка нескольких форматов**
+- Поддерживайте несколько форматов файлов конфигурации для гибкости и совместимости.
+- Расширяйте систему для поддержки пользовательских форматов по мере необходимости.
+
+### **4. Динамические обновления конфигурации**
+- Динамически обновляйте файлы конфигурации во время выполнения.
+- Применяйте изменения без перезапуска приложения или плагина.

content/ru/6.plugins/1.config-system/2.installation.md

@@ -0,0 +1,128 @@
+---
+title: Как использовать
+description: Практические примеры того, как читать, записывать и управлять файлами конфигурации из разных плагинов.
+icon: lucide:book-open
+---
+
+**Плагин Configs** предоставляет простой API для управления файлами конфигурации в экосистеме Plugify. Основные функции включают `ReadConfig`, `WriteConfig` и `MergeConfig`. Это руководство проведет вас через использование этих функций с практическими примерами.
+
+## **Начало работы**
+
+Чтобы использовать плагин Configs, сначала убедитесь, что он загружен. После загрузки вы можете получить доступ к его функциям через API Plugify. Имя плагина — `configs`.
+
+## **Чтение конфигурации**
+
+Функция `ReadConfig` используется для чтения файла конфигурации из каталога другого плагина. Она автоматически определяет формат файла и возвращает данные в виде строки.
+
+### **Пример: Чтение файла JSON**
+
+Предположим, у вас есть плагин с именем `my_plugin`, который имеет файл конфигурации `config.json`, и пользователь создал свой собственный файл `user.json` в папке `res/configs`.
+
+**Код C++**
+```cpp
+#include <iostream>
+#include "configs.hpp" // Сгенерированный заголовочный файл
+
+void ReadMyPluginConfig() {
+    // Чтение файла конфигурации из 'my_plugin'
+    const char* result = configs::ReadConfig("my_plugin", "config.json");
+    if (result) {
+        std::cout << result << std::endl;
+        delete[] result; // Освободить память, выделенную плагином
+    }
+}
+```
+
+**Файл конфигурации (`my_plugin/config.json`)**
+```json
+{
+  "setting1": "default_value",
+  "setting2": 123
+}
+```
+
+**Пользовательский файл конфигурации (`res/configs/my_plugin/user.json`)**
+```json
+{
+  "setting1": "user_value"
+}
+```
+
+**Ожидаемый вывод**
+Функция `ReadConfig` автоматически объединит пользовательскую конфигурацию с конфигурацией по умолчанию.
+```json
+{
+  "setting1": "user_value",
+  "setting2": 123
+}
+```
+
+### **Важное примечание**
+Плагин Configs выделяет память для возвращаемой строки, которую необходимо освободить вручную с помощью `delete[] result;` после использования, чтобы избежать утечек памяти.
+
+## **Запись конфигурации**
+
+Функция `WriteConfig` используется для записи строки в файл конфигурации в папке `res/configs`.
+
+### **Пример: Запись в файл конфигурации**
+Этот пример показывает, как записать новую конфигурацию в файл `user.json` для `my_plugin`.
+
+**Код C++**
+```cpp
+#include "configs.hpp"
+
+void WriteMyPluginConfig() {
+    const char* newData = R"({ "setting1": "new_user_value", "setting3": true })";
+    // Запись новой конфигурации в 'user.json' для 'my_plugin'
+    configs::WriteConfig("my_plugin", "user.json", newData);
+}
+```
+
+**Итоговый `user.json`**
+```json
+{
+  "setting1": "new_user_value",
+  "setting3": true
+}
+```
+
+## **Объединение конфигураций**
+
+Функция `MergeConfig` объединяет два файла конфигурации. Это полезно, когда вам нужно объединить конфигурацию по умолчанию с пользовательской конфигурацией вручную.
+
+### **Пример: Объединение конфигурации по умолчанию с пользовательской конфигурацией**
+Этот пример показывает, как объединить `default.json` с `user.json`.
+
+**Код C++**
+```cpp
+#include <iostream>
+#include "configs.hpp"
+
+void MergeMyConfigs() {
+    const char* defaultConfig = R"({ "setting1": "default", "setting2": 10 })";
+    const char* userConfig = R"({ "setting1": "user" })";
+    
+    const char* mergedResult = configs::MergeConfig(defaultConfig, userConfig, "json");
+    if (mergedResult) {
+        std::cout << mergedResult << std::endl;
+        delete[] mergedResult;
+    }
+}
+```
+
+**Ожидаемый вывод**
+```json
+{
+  "setting1": "user",
+  "setting2": 10
+}
+```
+
+## **Рекомендации**
+- **Всегда освобождайте память**: Не забывайте освобождать память, возвращаемую `ReadConfig` и `MergeConfig`, с помощью `delete[]`.
+- **Используйте правильные имена файлов**: Убедитесь, что вы используете правильные имена файлов конфигурации при чтении или записи.
+- **Обрабатывайте ошибки**: Проверяйте наличие нулевых указателей при чтении конфигураций, чтобы корректно обрабатывать ошибки.
+
+## **Заключение**
+
+Плагин Configs предоставляет простой, но мощный способ управления файлами конфигурации в Plugify. Следуя примерам и рекомендациям, изложенным в этом руководстве, вы можете эффективно читать, записывать и объединять конфигурации, обеспечивая при этом сохранение пользовательских настроек.

content/ru/6.plugins/1.config-system/3.guide.md

@@ -0,0 +1,9 @@
+---
+title: Руководство
+description: Подробное руководство по эффективному использованию плагина, которое поможет вам максимально использовать его возможности и функционал для ваших нужд.
+icon: lucide:book-open-text
+---
+
+::alert{type="warning" icon="lucide:triangle-alert"}
+Этот раздел в настоящее время находится в разработке.
+::

content/ru/6.plugins/1.config-system/_dir.yml

@@ -0,0 +1,4 @@
+title: Config System
+icon: lucide:settings-2
+navigation.redirect: /ru/plugins/config-system/features
+collapse: true

content/ru/6.plugins/2.admin-system/1.features.md

@@ -0,0 +1,9 @@
+---
+title: Особенности
+description: Откройте для себя основные особенности и типичные сценарии использования плагина, включая реальные примеры, где он проявляет себя наилучшим образом.
+icon: lucide:star
+---
+
+::alert{type="warning" icon="lucide:triangle-alert"}
+Плагин в настоящее время находится в разработке.
+::

content/ru/6.plugins/2.admin-system/2.installation.md

@@ -0,0 +1,92 @@
+---
+title: Установка  
+description: Подробное руководство по установке плагина, включая системные требования и зависимости.  
+icon: lucide:download  
+---
+
+Плагин **Admins** можно установить двумя способами: вручную скачав релиз или используя менеджер пакетов Plugify. В этом руководстве описаны оба метода с пошаговыми инструкциями.
+
+## **Метод 1: Ручная установка**
+
+::steps
+### **Скачивание релиза**
+1. Перейдите в [репозиторий плагина Admins](https://github.com/untrustedmodders/plugify-admins).
+2. Откройте раздел **Releases**.
+3. Скачайте последний архив с релизом (например, `admins.zip`).
+
+### **Распаковка архива**
+1. Распакуйте загруженный архив во временную папку.
+
+### **Размещение плагина в папке Plugins**
+1. Найдите папку `plugins` в директории установки Plugify.
+2. Скопируйте распакованные файлы плагина в эту папку.
+
+### **Проверка установки**
+1. Запустите Plugify.
+2. Плагин Admins должен быть доступен для использования.
+::
+
+## **Метод 2: Установка через менеджер пакетов**
+
+::steps
+### **Добавление репозитория (если требуется)**
+Если плагин Admins не найден в стандартном репозитории, необходимо добавить репозиторий вручную.
+
+#### **Вариант A: Добавление через командную строку**
+1. Выполните следующую команду в терминале:
+   ```bash
+   plg repo https://untrustedmodders.github.io/plugify-admins/admins.json
+   ```
+
+#### **Вариант B: Добавление через `plugify.padmin`**
+1. Откройте файл `plugify.padmin` в директории установки Plugify.
+2. Добавьте следующую строку в раздел `repositories`:
+   ```json
+   {
+     "repositories": [
+       "https://untrustedmodders.github.io/plugify-admins/admins.json"
+     ]
+   }
+   ```
+
+### **Установка плагина**
+1. Выполните следующую команду в терминале:
+   ```bash
+   plg install admins
+   ```
+
+### **Проверка установки**
+1. Запустите Plugify.
+2. Плагин Admins должен быть установлен и готов к использованию.
+::
+
+## **Структура папок**
+
+После установки плагин Admins должен иметь следующую структуру папок:
+
+::file-tree
+---
+tree:
+- res/plugins:
+    - admins:
+        - bin:
+            - admins.dll
+            - libadmins.so
+        - ^admins.pplugin^
+---
+::
+
+### **Пояснение**
+- **`res/plugins/admins`**: Корневая папка плагина Admins.
+- **`bin`**: Содержит скомпилированные бинарные файлы плагина (`.dll` для Windows, `.so` для Linux/macOS).
+- **`admins.pplugin`**: Манифест-файл плагина, описывающий его и экспортируемые функции.
+
+## **Устранение неполадок**
+
+### **Плагин не найден**
+- Убедитесь, что URL репозитория указан правильно и доступен.
+- Проверьте, что репозиторий добавлен в `plugify.padmin` или через команду `plg repo <url>`.
+
+### **Сбой установки**
+- Проверьте подключение к интернету.
+- Убедитесь, что у вас установлена последняя версия Plugify.

content/ru/6.plugins/2.admin-system/3.guide.md

@@ -0,0 +1,9 @@
+---
+title: Руководство  
+description: Подробное руководство по эффективному использованию плагина, чтобы максимально раскрыть его возможности и функциональность под ваши задачи.  
+icon: lucide:book-open-text  
+---
+
+::alert{type="warning" icon="lucide:triangle-alert"}
+Раздел находится в разработке.  
+::

content/ru/6.plugins/2.admin-system/_dir.yml

@@ -0,0 +1,4 @@
+title: Admin System
+icon: lucide:shield-check
+navigation.redirect: /ru/plugins/admin-system/features
+collapse: true