Различия

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

--- products:pyrog:tutorials:usermanual:main [2026/05/09 15:50] – ironmesh
+++ products:pyrog:tutorials:usermanual:main [2026/07/27 19:20] (текущий) – [Использование] 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 }}
@@ Строка 17: / Строка 17: @@
 ==== Шаг 2. Загрузка файлов программы и запуск ====
-Для скачивания перейдите на страницу [[..:..:downloads]] и скачайте архив с файлами программы. Извлеките папку **Pyrog **в желаемое место на вашем компьютере и запустите файл **...//Pyrog\manage//r\Pyrog.pyw**, после этого произойдет запуск программы.
+Для скачивания перейдите на страницу [[..:..:downloads]] и скачайте архив с файлами программы. Извлеките папку **Pyrog** в желаемое место на вашем компьютере и запустите файл **...//Pyrog\manage//r\Pyrog.pyw**, после этого произойдет запуск программы.
-Для работы программы должен быть установлен пакет** PySide6**, если он не установлен, то автоматически запустится утилита для его  установки.
+Для работы программы должен быть установлен пакет **PySide6**, если он не будет найден в системе, то автоматически запустится утилита для его установки.
 {{ :products:pyrog:gui:ru:tkinter_installer_ru.jpg?400&direct }}В верхнем выпадающем списке можете выбрать язык интерфейса. Для установки пакета нажмите на кнопку **Установить**. Если процесс загрузки произошел неудачно, то проверьте соединение с интернетом и доступность сайта [[https://pypi.org/|pypi.org]], после чего повторите попытку.
-Также можно установить **PySide6 **вручную, для этого в окне терминала нужно выполнить команду:
+Также можно установить **PySide6** вручную, для этого в окне терминала нужно выполнить команду:
 <code bash>
@@ Строка 29: / Строка 29: @@
 </code>
-===== Использование =====
+Для выполнения обновления, скачайте архив с обновленной версией программы и скопируйте файлы из архива поверх старых.
-==== Первый запуск ====
+===== Использование =====
 После запуска появится примерно следующий экран.
@@ Строка 39: / Строка 40: @@
 Для работы некоторый плагинов могут потребоваться внешние зависимости (пакеты программ от сторонних разработчиков), в таком случае при инициализации такого плагина будет выведено диалоговое окно со списком необходимых пакетов.
-{{ :products:pyrog:gui:ru:package_installer_ru.jpg?400&direct |Pyrog - менеджер пакетов}}Опционально можно отметить поле **Включить все требуемые пакеты, **тогда** **система произведет поиск пакетов, которые нужны для запуска других плагинов, и в случае обнаружения включит их в список. Нажмите кнопку **Установить **для начала процесса установки. После успешной установки всех требуемых пакетов плагин будет запущен. Если в процессе установки произошла ошибка, то вместо интерфейса плагина будет выведено сообщение с ошибкой. Если установка не удается - проверьте интернет и доступность сайта [[https://pypi.org/|pypi.org]].
+{{ :products:pyrog:gui:ru:package_installer_ru.jpg?400&direct |Pyrog - менеджер пакетов}}Опционально можно отметить поле **Включить все требуемые пакеты**, тогда система произведет поиск пакетов, которые нужны для запуска других плагинов, и в случае обнаружения включит их в список. Нажмите кнопку **Установить** для начала процесса установки. После успешной установки всех требуемых пакетов плагин будет запущен. Если в процессе установки произошла ошибка, то вместо интерфейса плагина будет выведено сообщение с ошибкой. Если установка не удается - проверьте интернет и доступность сайта [[https://pypi.org/|pypi.org]].
 >В данном руководстве не освещается вопрос применения самих плагинов, для этого нужно обращаться к конкретному руководству для каждого из них.
@@ Строка 45: / Строка 46: @@
 ==== Настройка Менеджера ====
-Для доступа к настройкам Менеджера нажмите //Ctrl+Alt+S //или //App->Настройки//.
+Для доступа к настройкам Менеджера нажмите //Ctrl+Alt+S// или //App->Настройки//.
 {{ :products:pyrog:gui:ru:app_settings_ru.jpg?400&direct |Pyrog настройки}}**Интерфейс**
@@ Строка 51: / Строка 52: @@
 //Язык// - язык интерфейса Менеджера
-//Тема //- стиль отображения интерфейса, набор может отличаться для разных операционных систем
+//Тема//- стиль отображения интерфейса, набор может отличаться для разных операционных систем
-//Шрифт //- шрифт интерфейса
+//Шрифт//- шрифт интерфейса
 **Дополнительные папки с плагинами**
-//Дополнительные папки с плагинами - //список папок, из которых производится импорт плагинов, для применения нужна перезагрузка.
+//Дополнительные папки с плагинами// - список папок, из которых производится импорт плагинов, для применения нужна перезагрузка Менеджера.
 ==== Список плагинов ====
-Чтобы перейти к списку установленных плагинов нажмите комбинацию //Ctrl+Alt+P //или //App->Плагины//. {{ :products:pyrog:gui:ru:plugin_section_with_markers_ru.jpg?400&direct |Pyrog список плагинов}}**Описание меток:**
+Чтобы перейти к списку установленных плагинов нажмите комбинацию //Ctrl+Alt+P// или //App->Плагины//. {{ :products:pyrog:gui:ru:plugin_section_with_markers_ru.jpg?400&direct |Pyrog список плагинов}}**Описание меток:**
   - Развернуть/свернуть блок информации о плагине;
   - Активация(правое положение)/деактивация(левое положение) плагина;
-  - Язык интерефейса плагина (если локализация отсутствует, то поле будет отсутствовать);
+  - Язык интерефейса плагина (если локализация отсутствует, то поле не будет отображено);
   - Настройки плагина (если кнопка не активна, то настройки отсутствуют);
   - Дополнительные действия:
-    * Инициализировать при запуске - если установлен, то при запусе Менеджера данный плагин будет запущен автоматически.
+    * //Инициализировать при запуске// - если установлен, то при запуске Менеджера данный плагин будет запущен автоматически.
-  - Отобразить логи;
+  - Отобразить логи, при нажатии выводит окно с сообщениями, чаще с информацией об ошибках, полезно в случае выяснения причин некорректной работы;
   - Фильтр плагинов по имени;
   - Фильтр по признакам:
@@ Строка 75: / Строка 76: @@
     * //Показать только активные// - отображать только включенные плагины;
     * //Показать только неактивные// - отображать выключенные плагины;
-    * //Показать только с ошибками //- отображать только плагины, где есть сообщения;
+    * //Показать только с ошибками//- отображать только плагины, где есть сообщения;
   - Дополнительные действия:
-    * //Активировать все //- включить все плагины;
+    * //Активировать все//- включить все плагины;
-    * //Деактивировать все //- выключить все плагины;
+    * //Деактивировать все//- выключить все плагины;
-    * //Удалить неактуальные данные //- выполнить поиск в базе данных записи о состоянии плагинов, которые были удалены, после чего удалить их.
+    * //Удалить неактуальные данные//- выполнить поиск в базе данных записей о состоянии плагинов, которые были удалены, после чего удалить их.
-  - Вернуться на главное окно
+  - Вернуться в главный раздел
-==== Установка и удаление плагинов ====
+<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** является портативной программой, это значит, что она не создает в системе никаких записей, вся информация, необходимая для работы программы сохраняется внутри каталога, это значит, что ее можно запускать со сменного носителя и все сохраненные настройки будут применены.