Различия

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

--- products:pyrog:tutorials:usermanual:main [2026/05/06 02:28] – создано ironmesh
+++ products:pyrog:tutorials:usermanual:main [2026/06/07 22:52] (текущий) – [Установка и удаление плагинов] ironmesh
@@ Строка 1: / Строка 1: @@
-====== Руководство для пользователей ======
+====== Руководство пользователя ======
-В этом кратком руководстве я расскажу как подготовить вашу систему к запуску [[..:concepts:manager|Менеджера]], а также расскажу как им пользоваться. Данное руководство расчитано на пользователей без навыков программирования.
+В этом руководстве будет рассказано как подготовить вашу операционную систему к запуску [[..:..:concepts:manager|Менеджера]] плагинов(мини-приложений), а также будут даны инструкции по его использованию. Данное руководство рассчитано на пользователей без навыков программирования.
-===== Шаг 1. Установка Python и PySide6 =====
+===== Подготовка к работе =====
-Так как PUSSY поставляется в виде исходного кода, то для его запуска нужен интерпретатор. Для этого переходите на сайт [[http://python.org/downloads|python.org]] и скачивайте дистрибутив для своей операцинной системы. Далее я опишу процесс установки для Windows.
+==== Шаг 1. Установка Python ====
-После скачивания запускайте исполняемый файл отметьте поле «Add Python 3.6 to the PATH» (Добавить Python 3.6 к системной переменной PATH), как на рисунке (это может выглядеть по-разному в зависимости от версии, которую вы устанавливаете).
+**Pyrog **поставляется в виде пакета файлов исходного кода, поэтому для его запуска нужен интерпретатор Python. Если он еще не установлен, то перейдите на сайт [[http://python.org/downloads|python.org]] и скачайте дистрибутив для вашей операционной системы, затем установите его. Далее описан процесс установки для операционной системы Windows.
+После скачивания запустите исполняемый файл, отметьте поле «Add Python 3.6 to the PATH» (Добавить Python 3.6 к системной переменной PATH), как на рисунке, на момент установки номер версии будет другой, главное чтобы версия была 3.13 или более новая. Советую использовать только стабильные версии.
 {{ :products:pussy:screenshots:python-installation-options.png?473x296 }}
@@ Строка 13: / Строка 15: @@
 Нажимайте "Install Now", чтобы начать установку немедленно или "Customize installation" для тонкой настройки установки.
-После установки Python нужно установки пакет PySide6. Это можно сделать несколькими способами. Первый из них: через командную строку, о другом способе будет сказано далее. Для этого запустите приложение Командная строка нажатием "Win+R" и введите "cmd" и Enter, должно появиться окно терминала, затем введите команду:
+==== Шаг 2. Загрузка файлов программы и запуск ====
+Для скачивания перейдите на страницу [[..:..:downloads]] и скачайте архив с файлами программы. Извлеките папку **Pyrog **в желаемое место на вашем компьютере и запустите файл **...//Pyrog\manage//r\Pyrog.pyw**, после этого произойдет запуск программы.
+Для работы программы должен быть установлен пакет** PySide6**, если он не будет найден в системе, то автоматически запустится утилита для его установки.
+{{ :products:pyrog:gui:ru:tkinter_installer_ru.jpg?400&direct }}В верхнем выпадающем списке можете выбрать язык интерфейса. Для установки пакета нажмите на кнопку **Установить**. Если процесс загрузки произошел неудачно, то проверьте соединение с интернетом и доступность сайта [[https://pypi.org/|pypi.org]], после чего повторите попытку.
+Также можно установить **PySide6 **вручную, для этого в окне терминала нужно выполнить команду:
 <code bash>
@@ Строка 19: / Строка 29: @@
 </code>
-После скачивания пакета приложение готово к запуску.
+===== Использование =====
-<WRAP center round info 60%>
+После запуска появится примерно следующий экран.
-Комплекс написан и протестирован на Python 3.13, поэтому рекомендую использовать данную версию или более новую
+{{ :products:pyrog:gui:en:plugin_usage_section.jpg?400&direct |Главное окно программы Pyrog}}Pyrog это программный комплекс для разработки и использования мини-приложений, иными словами плагинов. Плагины имеют графический интерфейс, каждый из них располагается в индивидуальной вкладке. Не все плагины при запуске Менеджера проходят инициализацию, в таком случае перед именами таких плагинов стоит знак "звездочка", данный аспект не влияет на работу плагинов, кроме тех случаев, когда плагин должен быть запущен на старте, далее будет сказано как сделать так, чтобы плагин запускался при запуске Менеджера.
-</WRAP>
+Для работы некоторый плагинов могут потребоваться внешние зависимости (пакеты программ от сторонних разработчиков), в таком случае при инициализации такого плагина будет выведено диалоговое окно со списком необходимых пакетов.
-===== Шаг 2. Скачивание исходного кода и запуск =====
+{{ :products:pyrog:gui:ru:package_installer_ru.jpg?400&direct |Pyrog - менеджер пакетов}}Опционально можно отметить поле **Включить все требуемые пакеты, **тогда** **система произведет поиск пакетов, которые нужны для запуска других плагинов, и в случае обнаружения включит их в список. Нажмите кнопку **Установить **для начала процесса установки. После успешной установки всех требуемых пакетов плагин будет запущен. Если в процессе установки произошла ошибка, то вместо интерфейса плагина будет выведено сообщение с ошибкой. Если установка не удается - проверьте интернет и доступность сайта [[https://pypi.org/|pypi.org]].
-Для скачивания перейдите в [[https://github.com/iron-mesh/utilities-box|репозиторий ]]или ищите дополнительные способы загрузки на [[https://ironmesh.ru/ru/products/22-prilozheniya/66-pussy|Странице проекта]]. На [[:products:pussy:other:github|GitHub]] щелкайте по кнопке "Code" и выберите пункт "Download ZIP" или скачайте архив с исходниками в разделе Release. После скачивания распакуйте содержимое на жеском диске. Запустите двойным щелчком файл **PUSSY.pyw** в папке **PUSSY/manager**.
+>В данном руководстве не освещается вопрос применения самих плагинов, для этого нужно обращаться к конкретному руководству для каждого из них.
-{{ :products:pussy:screenshots:2023-11-24_22_13_32-iron-mesh_utilities-box_python_utilitarian_script_system_for_you_mozilla_fire.jpg?400&nolink |загрузка исходников с GitHub}}
+==== Настройка Менеджера ====
-===== Шаг 3. Пользуемся =====
+Для доступа к настройкам Менеджера нажмите //Ctrl+Alt+S //или //App->Настройки//.
-Если все предыдущие шаги были выполнены правильно, то на экране предстанет главное окно Менеджера. В главном окне будут отображены вкладки Плагинов, которые на данный момент установлены и активированы. По умолчанию Плагины инициализируются после того как будет активирована вкладка, если нужно инициализировать его при запуске, то далее будет рассказано как это сделать.
+{{ :products:pyrog:gui:ru:app_settings_ru.jpg?400&direct |Pyrog настройки}}**Интерфейс**
-{{ :products:pussy:screenshots:2023-09-18_15_07_57-pussy_2.jpg?383x257 |Окно менеджера}}Чтобы перейти к списку установленных плагинов надо нажать //Ctrl+Alt+P//. В первом столбце показаны имена Плагинов; во втором - кнопки активации, с их помощью можно выключать или включать плагины в любое время; в третьем - кнопки перехода к настройкам, если кнопка не активна, то настройки отсутствуют; в четвертом - дополнительные опции: //Plugin Info// - информация о плагине; //Reset Settings// - сброс настроек; //Initialize on startup// - инициализация плагина при запуске.{{ :products:pussy:screenshots:2023-09-17_14_09_54-pussy.jpg?400 |2023-09-17_14_09_54-pussy.jpg}}
+//Язык// - язык интерфейса Менеджера
-Менеджер имеет небольшой перечень настроек, чтобы перейти к ним надо нажать //Ctrl+Alt+S. // В первом разделе собраны настройки для настройки интерфейса, описывать каждый из них нет смысла, так как их назначение должно быть понятно. Во втором разделе одна опция: "//Exterrnal plugin directories//" - это список папок, где Менеджер производит поиск плагинов, о них мы поговорим позднее. Чтобы применить настройки нужно нажать на //"Apply settings"//. Кнопка //" Delete invalid data" - // удаляет данные о плагинах, которые были удалены или недоступны.
+//Тема //- стиль отображения интерфейса, набор может отличаться для разных операционных систем
-{{ :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".{{ :products:pussy:screenshots:2023-09-17_14_50_31-pussy.jpg?400 |2023-09-17_14_50_31-pussy.jpg}}
+//Шрифт //- шрифт интерфейса
-===== Шаг 4. Установка, удаление плагинов =====
+**Дополнительные папки с плагинами**
-//<WRAP center round info 60%>//
+//Дополнительные папки с плагинами - //список папок, из которых производится импорт плагинов, для применения нужна перезагрузка Менеджера.
-//[[..:concepts:plugin]] - по сути это пакет (исходя из терминологии Python), это папка с файлами, которые содержат исходный код, в ней в обязательном порядке должен находиться файл с именем _ _init_ _.py//.
+==== Список плагинов ====
+Чтобы перейти к списку установленных плагинов нажмите комбинацию //Ctrl+Alt+P //или //App->Плагины//. {{ :products:pyrog:gui:ru:plugin_section_with_markers_ru.jpg?400&direct |Pyrog список плагинов}}**Описание меток:**
+  - Развернуть/свернуть блок информации о плагине;
+  - Активация(правое положение)/деактивация(левое положение) плагина;
+  - Язык интерефейса плагина (если локализация отсутствует, то поле не будет отображено);
+  - Настройки плагина (если кнопка не активна, то настройки отсутствуют);
+  - Дополнительные действия:
+    * //Инициализировать при запуске// - если установлен, то при запусе Менеджера данный плагин будет запущен автоматически.
+  - Отобразить логи, при нажатии выводит окно с сообщениями, чаще с информацией об ошибках, полезно в случае выяснения причин некорректной работы;
+  - Фильтр плагинов по имени;
+  - Фильтр по признакам:
+    * //Показать все// - отображать все плагины;
+    * //Показать только активные// - отображать только включенные плагины;
+    * //Показать только неактивные// - отображать выключенные плагины;
+    * //Показать только с ошибками //- отображать только плагины, где есть сообщения;
+  - Дополнительные действия:
+    * //Активировать все //- включить все плагины;
+    * //Деактивировать все //- выключить все плагины;
+    * //Удалить неактуальные данные //- выполнить поиск в базе данных записей о состоянии плагинов, которые были удалены, после чего удалить их.
+  - Вернуться в главный раздел
+<WRAP center round info 80%>
+Доступ к некоторым опциям можно получить из контекстного меню, щелкнув правой кнопкой мыши по вкладке Плагина.
 </WRAP>
-  Для того чтобы установить плагин нужно просто скопировать папку с исходным кодом в директорию **PUSSY/manager/Plugins**, либо в любую другую, которая указана в настройках, в пункте "External plugin directories//".  Удаление производится аналогичным образом. После установки или удаления перезагрузите Менеджер, чтобы изменения вступили в силу. Чтобы удалить служебную информацию об удаленных плагинах нужно нажать на //" Delete invalid data" // в разделе настроек//.//  Чтобы узнать о том как разрабатывать собственные плагины смотрите соответствующие материалы на этом сайте.//
+==== Установка и удаление плагинов ====
+Плагин это просто папка с исходным кодом программы, для его установки просто скопируйте ее в нужную директорию на диске: по умолчанию, директория с плагинами находится здесь: **.../Pyrog/manager/plugins,** также вы можете скопировать папку с плагином в любую директорию из тех, которые были установлены в настройках в качестве дополнительных. После копирования перезапустите Менеджер. Если нужно удалить плагин, то удалите папку с его исходным кодом и вызовите команду //Удалить неактуальные данные, //чтобы очистить записи о плагине из базы данных.
+===== Дополнительные сведения =====
+Pyrog является портативной программой, это значит, что она не создает в системе никаких записей, вся информация, необходимая для работы программы сохраняется внутри каталога, это значит, что ее можно запускать со сменного носителя и все сохраненные настройки будут применены.