fix: update path to generator for c++ and add missing russian translation

Author: qubka

content/4.languages/2.cpp/3.export-functions.md

@@ -291,7 +291,7 @@ if(CLANG_DOC)
     if(Python3_FOUND)
         add_custom_command(TARGET docs POST_BUILD
             COMMAND ${Python3_EXECUTABLE} 
-                    ${CMAKE_SOURCE_DIR}/tools/parser.py
+                    ${CMAKE_SOURCE_DIR}/parser/parser.py
                     ${CMAKE_SOURCE_DIR}/docs/index.yaml
                     ${CMAKE_SOURCE_DIR}/exported_methods.json
             COMMENT "Parsing documentation to JSON"
@@ -312,7 +312,7 @@ Install dependencies:
 pip install pyyaml
 ```
 
-:read-more{icon="lucide:github" to="https://github.com/untrustedmodders/plugify-module-cpp/tree/main/tools/parser" title="GitHub Repository"}
+:read-more{icon="lucide:github" to="https://github.com/untrustedmodders/plugify-module-cpp/tree/main/parser" title="GitHub Repository"}
 
 #### **Document Your Functions**
 
@@ -377,16 +377,16 @@ This generates `docs/index.yaml` with all your function information.
 
 Run the parser to convert YAML to the manifest format:
 ```bash
-python3 tools/parser.py docs/index.yaml exported_methods.json
+python3 parser/parser.py docs/index.yaml exported_methods.json
 ```
 
 Or with filtering:
 ```bash
 # Only functions from files starting with "commands"
-python3 tools/parser.py docs/index.yaml exported_methods.json --file-prefix "commands"
+python3 parser/parser.py docs/index.yaml exported_methods.json --file-prefix "commands"
 
 # Only functions with "Admin" in their name
-python3 tools/parser.py docs/index.yaml exported_methods.json --name-filter "Admin"
+python3 parser/parser.py docs/index.yaml exported_methods.json --name-filter "Admin"
 ```
 
 #### **Use in Your Manifest**

content/4.languages/2.cpp/4.import-functions.md

@@ -16,7 +16,7 @@ Plugify provides a Python script (`generator.py`) to automatically generate head
 #### **Locate the Generator Script**:
 - The `generator.py` script is located in the `generator` folder of the C++ language module.
 
-:read-more{icon="lucide:link" to="https://github.com/untrustedmodders/plugify-module-cpp/tree/main/tools/generator" title="GitHub Repository"}
+:read-more{icon="lucide:link" to="https://github.com/untrustedmodders/plugify-module-cpp/tree/main/generator" title="GitHub Repository"}
 
 #### **Run the Generator Script**:
 - Open a terminal or command prompt and navigate to the folder containing `generator.py`.

content/ru/4.languages/2.cpp/3.export-functions.md

@@ -248,6 +248,238 @@ extern "C" PLUGIN_API void ExecuteWithCallback_Exported_Name(int32_t value, cons
 ```
 ::
 
+## **Автоматизация генерации манифеста**
+
+::callout{icon="i-lucide-sparkles" color="blue"}
+**Новинка:** Теперь вы можете автоматизировать генерацию раздела `methods` в манифесте вашего плагина с помощью clang-doc и парсера на Python!
+::
+
+Вместо ручного написания JSON-манифеста для каждой экспортируемой функции, вы можете использовать автоматизированные инструменты для извлечения сигнатур функций, типов, описаний параметров и даже определений перечислений непосредственно из вашего исходного кода C++.
+
+### **Преимущества автоматической генерации**
+
+1. **Не требуется ручное написание JSON**: Сигнатуры функций автоматически извлекаются из вашего кода
+2. **Полная информация о типах**: Структуры перечислений и typedef функций включаются автоматически
+3. **Интеграция документации**: Комментарии Doxygen парсятся и включаются в манифест
+4. **Меньше ошибок**: Устраняются опечатки и несоответствия типов между кодом и манифестом
+5. **Простое обслуживание**: Изменения в сигнатурах функций автоматически отражаются
+
+### **Настройка: Добавление генерации документации в CMake**
+
+Добавьте следующее в ваш `CMakeLists.txt` для генерации документации и JSON-манифеста:
+
+```cmake
+# Найти clang-doc (обычно поставляется с установкой LLVM/Clang)
+find_program(CLANG_DOC clang-doc)
+
+if(CLANG_DOC)
+    # Генерация YAML-документации из ваших экспортируемых функций
+    add_custom_target(docs
+        COMMAND ${CLANG_DOC}
+            --executor=all-TUs
+            -p ${CMAKE_CURRENT_BINARY_DIR}
+            --output=${CMAKE_CURRENT_SOURCE_DIR}/docs
+            --extra-arg=-Wno-error
+            --format=yaml
+            ${CMAKE_SOURCE_DIR}/src/export/*.cpp  # Путь к вашим экспортируемым функциям
+        WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
+        COMMENT "Generating documentation with clang-doc"
+    )
+
+    # Опционально: Автоматическое преобразование YAML в JSON после генерации документации
+    find_package(Python3 COMPONENTS Interpreter)
+    if(Python3_FOUND)
+        add_custom_command(TARGET docs POST_BUILD
+            COMMAND ${Python3_EXECUTABLE}
+                    ${CMAKE_SOURCE_DIR}/parser/parser.py
+                    ${CMAKE_SOURCE_DIR}/docs/index.yaml
+                    ${CMAKE_SOURCE_DIR}/exported_methods.json
+            COMMENT "Parsing documentation to JSON"
+        )
+    endif()
+endif()
+```
+
+### **Использование парсера**
+
+::steps{level=4}
+#### **Установка парсера**
+
+Скачайте `parser.py` и поместите его в ваш проект (например, в директорию `tools/`).
+
+Установите зависимости:
+```bash
+pip install pyyaml
+```
+
+:read-more{icon="lucide:github" to="https://github.com/untrustedmodders/plugify-module-cpp/tree/main/parser" title="Репозиторий GitHub"}
+
+#### **Документируйте ваши функции**
+
+Добавьте комментарии Doxygen к вашим экспортируемым функциям:
+
+```cpp
+/**
+ * @brief Создает консольную команду как административную команду.
+ * Если команда не существует, она создается. Когда эта команда вызывается,
+ * права доступа игрока автоматически проверяются перед разрешением продолжения.
+ *
+ * @param name Имя консольной команды.
+ * @param adminFlags Флаги администратора, указывающие, какой уровень администратора может использовать эту команду.
+ * @param description Краткое описание того, что делает команда.
+ * @param flags Флаги команды, определяющие поведение команды.
+ * @param callback Функция обратного вызова, которая вызывается при выполнении команды.
+ * @param mode Был ли хук в режиме post (после обработки) или в режиме pre (до обработки).
+ * @return Логическое значение, указывающее, была ли команда успешно добавлена.
+ */
+extern "C" PLUGIN_API bool AddAdminCommand(
+    const plg::string& name,
+    int64_t adminFlags,
+    const plg::string& description,
+    ConVarFlag flags,
+    CommandCallback callback,
+    HookMode mode
+);
+```
+
+#### **Документируйте перечисления и typedef**
+
+Документируйте ваши перечисления и typedef функций:
+
+```cpp
+/**
+ * @brief Перечисление, представляющее тип обратного вызова.
+ */
+enum class HookMode : uint8_t {
+    /** Обратный вызов будет выполнен перед оригинальной функцией */
+    Pre = 0,
+    /** Обратный вызов будет выполнен после оригинальной функции */
+    Post = 1
+};
+
+/**
+ * @brief Обрабатывает выполнение команды, вызванной вызывающей стороной.
+ * Эта функция обрабатывает команду, интерпретирует ее контекст и обрабатывает любые предоставленные аргументы.
+ */
+using CommandCallback = ResultType (*)(int32_t caller, CommandCallingContext context, const plg::vector<plg::string>& arguments);
+```
+
+#### **Генерация документации**
+
+Соберите цель документации:
+```bash
+cmake --build . --target docs
+```
+
+Это генерирует `docs/index.yaml` со всей информацией о ваших функциях.
+
+#### **Преобразование в JSON**
+
+Запустите парсер для преобразования YAML в формат манифеста:
+```bash
+python3 parser/parser.py docs/index.yaml exported_methods.json
+```
+
+Или с фильтрацией:
+```bash
+# Только функции из файлов, начинающихся с "commands"
+python3 parser/parser.py docs/index.yaml exported_methods.json --file-prefix "commands"
+
+# Только функции с "Admin" в имени
+python3 parser/parser.py docs/index.yaml exported_methods.json --name-filter "Admin"
+```
+
+#### **Использование в манифесте**
+
+Скопируйте сгенерированный массив `methods` из `exported_methods.json` в манифест вашего плагина:
+
+```json
+{
+  "name": "ExamplePlugin",
+  "version": "1.0.0",
+  "methods": [
+    // Вставьте содержимое из exported_methods.json сюда
+  ]
+}
+```
+::
+
+### **Продвинутое: Структуры перечислений**
+
+Парсер автоматически включает полные определения перечислений, когда параметр использует тип перечисления:
+
+**Сгенерированный вывод:**
+```json
+{
+  "name": "mode",
+  "type": "uint8",
+  "description": "Был ли хук в режиме post или в режиме pre.",
+  "enum": {
+    "name": "HookMode",
+    "description": "Перечисление, представляющее тип обратного вызова.",
+    "values": [
+      {
+        "name": "Pre",
+        "value": 0,
+        "description": "Обратный вызов будет выполнен перед оригинальной функцией"
+      },
+      {
+        "name": "Post",
+        "value": 1,
+        "description": "Обратный вызов будет выполнен после оригинальной функции"
+      }
+    ]
+  }
+}
+```
+
+### **Продвинутое: Typedef функций**
+
+Typedef указателей на функции автоматически парсятся в полные прототипы:
+
+**Сгенерированный вывод:**
+```json
+{
+  "name": "callback",
+  "type": "function",
+  "description": "Функция обратного вызова, которая вызывается при выполнении команды.",
+  "prototype": {
+    "name": "CommandCallback",
+    "funcName": "CommandCallback",
+    "description": "Обрабатывает выполнение команды, вызванной вызывающей стороной.",
+    "paramTypes": [
+      {
+        "name": "param1",
+        "type": "int32"
+      },
+      {
+        "name": "param2",
+        "type": "int32",
+        "enum": {
+          "name": "CommandCallingContext",
+          "values": [...]
+        }
+      },
+      {
+        "name": "param3",
+        "type": "string[]"
+      }
+    ],
+    "retType": {
+      "type": "int32",
+      "enum": {
+        "name": "ResultType",
+        "values": [...]
+      }
+    }
+  }
+}
+```
+
+::callout{icon="i-lucide-info" color="amber"}
+**Примечание:** Имена параметров typedef функций генерируются автоматически как `param1`, `param2` и т.д. Вы можете захотеть настроить их в манифесте для лучшей документации.
+::
+
 ## **Рекомендации**
 
 1. **Используйте `PLUGIN_API`**: Всегда используйте макрос `PLUGIN_API` для пометки функций для экспорта.