Различия

Показаны различия между двумя версиями страницы.

--- products:pyrog:tutorials:usermanual:main [2026/05/09 15:50] – ironmesh
+++ products:pyrog:tutorials:usermanual:main [2026/06/07 22:52] (текущий) – [Установка и удаление плагинов] ironmesh
@@ Строка 1: / Строка 1: @@
 ====== Руководство пользователя ======
-В этом руководстве будет рассказано как подготовить вашу операционную систему к запуску [[..:..:concepts:manager|Менеджера]] плагинов(мини-приложений), а также будут даны инструкции по использованию. Данное руководство рассчитано на пользователей без навыков программирования.
+В этом руководстве будет рассказано как подготовить вашу операционную систему к запуску [[..:..:concepts:manager|Менеджера]] плагинов(мини-приложений), а также будут даны инструкции по его использованию. Данное руководство рассчитано на пользователей без навыков программирования.
 ===== Подготовка к работе =====
@@ Строка 7: / Строка 7: @@
 ==== Шаг 1. Установка Python ====
-**Pyrog **поставляется в виде пакета файлов исходного кода, поэтому для его запуска нужен интерпретатор Python. Для этого перейдите на сайт [[http://python.org/downloads|python.org]] и скачайте дистрибутив для вашей операционной системы. Далее описан процесс установки для операционной системы Windows.
+**Pyrog **поставляется в виде пакета файлов исходного кода, поэтому для его запуска нужен интерпретатор Python. Если он еще не установлен, то перейдите на сайт [[http://python.org/downloads|python.org]] и скачайте дистрибутив для вашей операционной системы, затем установите его. Далее описан процесс установки для операционной системы Windows.
-После скачивания запустите исполняемый файл, отметьте поле «Add Python 3.6 to the PATH» (Добавить Python 3.6 к системной переменной PATH), как на рисунке, на момент установки номер версии будет другой, главное чтобы версия была не менее 3.13.
+После скачивания запустите исполняемый файл, отметьте поле «Add Python 3.6 to the PATH» (Добавить Python 3.6 к системной переменной PATH), как на рисунке, на момент установки номер версии будет другой, главное чтобы версия была 3.13 или более новая. Советую использовать только стабильные версии.
 {{ :products:pussy:screenshots:python-installation-options.png?473x296 }}
@@ Строка 19: / Строка 19: @@
 Для скачивания перейдите на страницу [[..:..:downloads]] и скачайте архив с файлами программы. Извлеките папку **Pyrog **в желаемое место на вашем компьютере и запустите файл **...//Pyrog\manage//r\Pyrog.pyw**, после этого произойдет запуск программы.
-Для работы программы должен быть установлен пакет** PySide6**, если он не установлен, то автоматически запустится утилита для его  установки.
+Для работы программы должен быть установлен пакет** PySide6**, если он не будет найден в системе, то автоматически запустится утилита для его установки.
 {{ :products:pyrog:gui:ru:tkinter_installer_ru.jpg?400&direct }}В верхнем выпадающем списке можете выбрать язык интерфейса. Для установки пакета нажмите на кнопку **Установить**. Если процесс загрузки произошел неудачно, то проверьте соединение с интернетом и доступность сайта [[https://pypi.org/|pypi.org]], после чего повторите попытку.
@@ Строка 30: / Строка 30: @@
 ===== Использование =====
-==== Первый запуск ====
 После запуска появится примерно следующий экран.
@@ Строка 57: / Строка 55: @@
 **Дополнительные папки с плагинами**
-//Дополнительные папки с плагинами - //список папок, из которых производится импорт плагинов, для применения нужна перезагрузка.
+//Дополнительные папки с плагинами - //список папок, из которых производится импорт плагинов, для применения нужна перезагрузка Менеджера.
 ==== Список плагинов ====
@@ Строка 65: / Строка 63: @@
   - Развернуть/свернуть блок информации о плагине;
   - Активация(правое положение)/деактивация(левое положение) плагина;
-  - Язык интерефейса плагина (если локализация отсутствует, то поле будет отсутствовать);
+  - Язык интерефейса плагина (если локализация отсутствует, то поле не будет отображено);
   - Настройки плагина (если кнопка не активна, то настройки отсутствуют);
   - Дополнительные действия:
-    * Инициализировать при запуске - если установлен, то при запусе Менеджера данный плагин будет запущен автоматически.
+    * //Инициализировать при запуске// - если установлен, то при запусе Менеджера данный плагин будет запущен автоматически.
-  - Отобразить логи;
+  - Отобразить логи, при нажатии выводит окно с сообщениями, чаще с информацией об ошибках, полезно в случае выяснения причин некорректной работы;
   - Фильтр плагинов по имени;
   - Фильтр по признакам:
@@ Строка 79: / Строка 77: @@
     * //Активировать все //- включить все плагины;
     * //Деактивировать все //- выключить все плагины;
-    * //Удалить неактуальные данные //- выполнить поиск в базе данных записи о состоянии плагинов, которые были удалены, после чего удалить их.
+    * //Удалить неактуальные данные //- выполнить поиск в базе данных записей о состоянии плагинов, которые были удалены, после чего удалить их.
-  - Вернуться на главное окно
+  - Вернуться в главный раздел
-==== Установка и удаление плагинов ====
+<WRAP center round info 80%>
-FIXME
+Доступ к некоторым опциям можно получить из контекстного меню, щелкнув правой кнопкой мыши по вкладке Плагина.
-Менеджер имеет небольшой перечень настроек, чтобы перейти к ним надо нажать //Ctrl+Alt+S. // В первом разделе собраны настройки для настройки интерфейса, описывать каждый из них нет смысла, так как их назначение должно быть понятно. Во втором разделе одна опция: "//Exterrnal plugin directories//" - это список папок, где Менеджер производит поиск плагинов, о них мы поговорим позднее. Чтобы применить настройки нужно нажать на //"Apply settings"//. Кнопка //" Delete invalid data" - // удаляет данные о плагинах, которые были удалены или недоступны.
+</WRAP>
-{{ :products:pussy:screenshots:2023-09-17_14_53_30-pussy.jpg?400 |2023-09-17_14_53_30-pussy.jpg}}Есть еще один раздел, он скорее всего не будет интересен обычным пользователям, но в некоторых случаях он может быть полезен, например, если Плагины работают некорректно. Речь идет о системных сообщениях, чтобы перейти к ним надо нажать //Ctrl+Alt+L,  // там выводится информация о работе плагинов, если сообщения выделены зеленым, то все в порядке, если красным, то возникло исключение в проц ессе работы. Чтобы выводить детальную информацию об исключениях нужно в настройках отметить опцию //"Display error info in Logs".//
+==== Установка и удаление плагинов ====
-<WRAP center round info 60%>
+Плагин это просто папка с исходным кодом программы, для его установки просто скопируйте ее в нужную директорию на диске: по умолчанию, директория с плагинами находится здесь: **.../Pyrog/manager/plugins,** также вы можете скопировать папку с плагином в любую директорию из тех, которые были установлены в настройках в качестве дополнительных. После копирования перезапустите Менеджер. Если нужно удалить плагин, то удалите папку с его исходным кодом и вызовите команду //Удалить неактуальные данные, //чтобы очистить записи о плагине из базы данных.
-[[..:concepts:plugin]] - по сути это пакет (исходя из терминологии Python), это папка с файлами, которые содержат исходный код, в ней в обязательном порядке должен находиться файл с именем _ _init_ _.py//.  </WRAP>    Для того чтобы установить плагин нужно просто скопировать папку с исходным кодом в директорию **PUSSY/manager/Plugins**, либо в любую другую, которая указана в настройках, в пункте "External plugin directories//".  Удаление производится аналогичным образом. После установки или удаления перезагрузите Менеджер, чтобы изменения вступили в силу. Чтобы удалить служебную информацию об удаленных плагинах нужно нажать на //" Delete invalid data" // в разделе настроек//.//  Чтобы узнать о том как разрабатывать собственные плагины смотрите соответствующие материалы на этом сайте.
-</WRAP>
+===== Дополнительные сведения =====
+Pyrog является портативной программой, это значит, что она не создает в системе никаких записей, вся информация, необходимая для работы программы сохраняется внутри каталога, это значит, что ее можно запускать со сменного носителя и все сохраненные настройки будут применены.