Различия

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

--- products:pussy:other:usermanual [2023/11/23 14:56] – ironmesh
+++ products:pussy:other:usermanual [2023/12/13 14:54] (текущий) – внешнее изменение 127.0.0.1
@@ Строка 1: / Строка 1: @@
 ====== Руководство для пользователей ======
-В этом кратком руководстве я расскажу как подготовить вашу систему к запуске приложения, а также расскажу как им пользоваться. Данное руководство подойдет для пользователей без навыков программирования.
+В этом кратком руководстве я расскажу как подготовить вашу систему к запуску [[:products:pussy:concepts:manager|Менеджера]], а также расскажу как им пользоваться. Данное руководство расчитано на пользователей без навыков программирования.
 ===== Шаг 1. Установка Python и PySide6 =====
@@ Строка 7: / Строка 7: @@
 Так как PUSSY поставляется в виде исходного кода, то для его запуска нужен интерпретатор. Для этого переходите на сайт [[http://python.org/downloads|python.org]] и скачивайте дистрибутив для своей операцинной системы. Далее я опишу процесс установки для Windows.
-После скачивания запускайте исполняемый файл отметьте поле «Add Python 3.8 to the PATH» (Добавить Python 3.8 к системной переменной PATH), как на рисунке (это может выглядеть по-разному в зависимости от версии, которую вы устанавливаете).
+После скачивания запускайте исполняемый файл отметьте поле «Add Python 3.6 to the PATH» (Добавить Python 3.6 к системной переменной PATH), как на рисунке (это может выглядеть по-разному в зависимости от версии, которую вы устанавливаете).
-[[{{  :products;pussy;screenshots;python-installation-options.png?nolink&  }}|]]Нажимайте "Install Now", чтобы начать установку немедленно или "Customize installation" для тонкой настройки установки.
+{{  :products:pussy:screenshots:python-installation-options.png?473x296  }}
-После установки Python нужно установки пакет PySide6. Для этого запустите приложение Командная строка, нажмите "Win+R" и введите "cmd" и Enter, должно появиться окно терминала, затем введите команду:
+Нажимайте "Install Now", чтобы начать установку немедленно или "Customize installation" для тонкой настройки установки.
+После установки Python нужно установки пакет PySide6. Для этого запустите приложение Командная строка нажатием "Win+R" и введите "cmd" и Enter, должно появиться окно терминала, затем введите команду:
 <code bash>
@@ Строка 29: / Строка 31: @@
 ===== Шаг 2. Скачивание исходного кода и запуск =====
-Для скачивания перейдите в [[https://github.com/iron-mesh/utilities-box|репозиторий ]]или ищите дополнительные способы загрузки на [[https://ironmesh.ru/ru/products/22-prilozheniya/66-pussy|Странице проекта]]. На [[GitHub|]] щелкайте по кнопке "Code" и выберите пункт "Download ZIP", скачивайте архив. После скачивания распакуйте содержимое в месте по своему усмотрению. Запустите двойным щелчком файл **PUSSY.pyw** в папке **PUSSY/manager**.
+Для скачивания перейдите в [[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-23_14_35_15-window.jpg?nolink&  |2023-11-23_14_35_15-window.jpg}}
+{{  :products:pussy:screenshots:2023-11-24_22_13_32-iron-mesh_utilities-box_python_utilitarian_script_system_for_you_mozilla_fire.jpg?nolink&400  |загрузка исходников с GitHub}}
 ===== Шаг 3. Пользуемся =====
-Если все предыдущие шаги были выполнены правильно то на экране предстанет главное окно Менеджера.
+Если все предыдущие шаги были выполнены правильно, то на экране предстанет главное окно Менеджера. В главном окне будут отображены вкладки Плагинов, которые на данный момент установлены и активированы. По умолчанию Плагины инициализируются после того как будет активирована вкладка, если нужно инициализировать его при запуске, то далее будет рассказано как это сделать.
+{{  :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%>
+[[:products:pussy:concepts:plugin|]] - по сути это пакет (исходя из терминологии Python), это папка с файлами, которые содержат исходный код, в ней в обязательном порядке должен находиться файл с именем //_ _init_ _.py//.
+</WRAP>
+Для того чтобы установить плагин нужно просто скопировать папку с исходным кодом в директорию **PUSSY/manager/Plugins**, либо в любую другую, которая указана в настройках, в пункте "//External plugin directories//".
+Удаление производится аналогичным образом. После установки или удаления перезагрузите Менеджер, чтобы изменения вступили в силу. Чтобы удалить служебную информацию об удаленных плагинах нужно нажать на //" Delete invalid data" // в разделе настроек//.//
+Чтобы узнать о том как разрабатывать собственные плагины смотрите соответствующие материалы на этом сайте.