added the initial GUI description

This commit is contained in:
Sergey Palcheh
2025-09-30 16:00:33 +06:00
parent e04a59507b
commit 15432ace98
3 changed files with 57 additions and 21 deletions

View File

@@ -1,28 +1,31 @@
<div align="center"> <div align="center">
<img src="image/gui/winehelper.svg" width="64"> <img src="image/gui/winehelper.svg" width="64">
<h1 align="center">WineHelper</h1> <h1 align="center">WineHelper</h1>
<p align="center">Инструмент для упрощения установки Windows-приложений на Linux. Он использует подготовленные скрипты, портативные версии Wine и изолированные префиксы, обеспечивая максимальную повторяемость на различных системах, начиная с релиза [[p10]] и выше.</p> <p align="center">Инструмент для упрощения установки Windows-приложений на Linux. Он использует подготовленные скрипты, портативные версии Wine и изолированные префиксы, обеспечивая максимальную повторяемость на различных операционных системах основанных на Alt Linux, начиная с релиза p10 и выше.</p>
</div> </div>
### Установка ## Установка
```sh ```
$ su - $ su -
# apt-get update && apt-get dist-upgrade # apt-get update && apt-get dist-upgrade
# apt-get install winehelper # apt-get install winehelper
# exit # exit
``` ```
## Использование WineHelper
<!-- Описание использования GUI -->
<details>
<summary style="font-size: 35px; font-weight: bold;">Использование WineHelper (CLI)</summary>
### Список приложений для установки ### Список приложений для установки
Вывод списка приложений, доступных к установке: Вывод списка приложений, доступных к установке:
```sh ```
$ winehelper install list $ winehelper install list
``` ```
или сокращенная команда: или сокращенная команда:
```sh ```
$ winehelper -i $ winehelper -i
``` ```
@@ -33,20 +36,20 @@
1. **Список программ с возможностью автоматической установки** — содержит полностью автоматизированные скрипты установок программ у который есть дистрибутивы (установщики) в свободном доступе. 1. **Список программ с возможностью автоматической установки** — содержит полностью автоматизированные скрипты установок программ у который есть дистрибутивы (установщики) в свободном доступе.
Процесс полностью автоматизирован. Процесс полностью автоматизирован.
Пример: Пример:
```sh ```
$ winehelper install spravki-bk $ winehelper install spravki-bk
``` ```
или сокращенная команда: или сокращенная команда:
```sh ```
$ winehelper -i spravki-bk $ winehelper -i spravki-bk
``` ```
2. **Список программ с возможностью установки из существующего дистрибутива** — содержит скрипты установок для программ, которых нет в свободном доступе. 2. **Список программ с возможностью установки из существующего дистрибутива** — содержит скрипты установок для программ, которых нет в свободном доступе.
Пример: Пример:
```sh ```
$ winehelper install is-record-station "/путь/до/установочногоайла" $ winehelper install is-record-station "/путь/до/установочногоайла"
``` ```
или сокращенная команда: или сокращенная команда:
```sh ```
$ winehelper -i is-record-station "/путь/до/установочногоайла" $ winehelper -i is-record-station "/путь/до/установочногоайла"
``` ```
@@ -69,11 +72,11 @@
### Удаление префикса с приложением ### Удаление префикса с приложением
Для удаления префикса выполните команду: Для удаления префикса выполните команду:
```sh ```
$ winehelper remove-prefix [имя_префикса] $ winehelper remove-prefix [имя_префикса]
``` ```
Если имя префикса не указано, будет выведен список существующих префиксов: Если имя префикса не указано, будет выведен список существующих префиксов:
```sh ```
0 - Отмена 0 - Отмена
1 - Префикс1 1 - Префикс1
2 - Префикс2 2 - Префикс2
@@ -86,12 +89,14 @@
- установленное ПО; - установленное ПО;
- desktop-файлы (ярлыки для установленного ПО в префиксе). - desktop-файлы (ярлыки для установленного ПО в префиксе).
### Создание резервной копии префикса ###
Команда создания резервной копии префикса: Команда создания резервной копии префикса:
```sh ```
$ winehelper backup-prefix [имя_префикса] $ winehelper backup-prefix [имя_префикса]
```
Если имя префикса не указано, будет выведен список существующих префиксов: Если имя префикса не указано, будет выведен список существующих префиксов:
```
0 - Отмена 0 - Отмена
1 - Префикс1 1 - Префикс1
2 - Префикс2 2 - Префикс2
@@ -108,7 +113,7 @@
### Восстановление префикса из резервной копии ### Восстановление префикса из резервной копии
Команда восстановления префикса из резервной копии: Команда восстановления префикса из резервной копии:
```sh ```
$ winehelper restore-prefix "путь/до/файла.whpack" $ winehelper restore-prefix "путь/до/файла.whpack"
``` ```
Восстановление префикса не требует подключение к интернету и происходит в автоматическом режиме: Восстановление префикса не требует подключение к интернету и происходит в автоматическом режиме:
@@ -121,7 +126,7 @@
### Использование команд WINE в WineHelper ### Использование команд WINE в WineHelper
WineHelper предоставляет доступ к основным инструментам WINE: WineHelper предоставляет доступ к основным инструментам WINE:
```sh ```
winehelper winefile # запуск файлового менеджера wine winehelper winefile # запуск файлового менеджера wine
winehelper winecfg # запуск wine конфигуратора для префикса winehelper winecfg # запуск wine конфигуратора для префикса
winehelper winereg # запуск редактора реестра для префикса winehelper winereg # запуск редактора реестра для префикса
@@ -130,7 +135,7 @@ WineHelper предоставляет доступ к основным инст
winehelper winetricks [компонент] # автоматическая установка дополнительного компонента в префикс winehelper winetricks [компонент] # автоматическая установка дополнительного компонента в префикс
``` ```
После выполнения любой из вышеперечисленных команд отображается список существующих префиксов: После выполнения любой из вышеперечисленных команд отображается список существующих префиксов:
```sh ```
0 - Отмена 0 - Отмена
1 - Префикс1 1 - Префикс1
2 - Префикс2 2 - Префикс2
@@ -142,7 +147,7 @@ WineHelper предоставляет доступ к основным инст
Есть 2 варианта: Есть 2 варианта:
1. В командной строке выполнить команду: 1. В командной строке выполнить команду:
```sh ```
$ winehelper "путь/до/файла.exe" $ winehelper "путь/до/файла.exe"
0 - Отмена 0 - Отмена
1 - Префикс1 1 - Префикс1
@@ -152,7 +157,7 @@ WineHelper предоставляет доступ к основным инст
Файл будет запущен в выбранном префиксе. Файл будет запущен в выбранном префиксе.
2. С помощью файлового менеджера WINE:''' 2. С помощью файлового менеджера WINE:'''
```sh ```
$ winehelper winefile $ winehelper winefile
0 - Отмена 0 - Отмена
1 - Префикс1 1 - Префикс1
@@ -163,7 +168,7 @@ WineHelper предоставляет доступ к основным инст
### Дополнительные команды ### Дополнительные команды
```sh ```
$ winehelper help $ winehelper help
``` ```
Вывод: Вывод:
@@ -193,6 +198,37 @@ WineHelper предоставляет доступ к основным инст
--changelog показать историю изменений --changelog показать историю изменений
--debug [команда] включить режим логирования работы WINE --debug [команда] включить режим логирования работы WINE
</pre> </pre>
</details>
<!-- Описание использования GUI -->
<details>
<summary style="font-size: 35px; font-weight: bold;">Использование WineHelper (GUI)</summary>
### Список приложений для установки
При использовании графического интерфейса списки приложений расположены во вкладках **Автоматическая установка** и **Ручная установка**.
<div align="center">
<img src="image/handbook/auto_install.png">
</div>
<div align="center">
<img src="image/handbook/manual_install.png">
</div>
</details>
### Примечание
> [!WARNING] > [!WARNING]
> Проект находится на стадии WIP (work in progress) > Проект находится на стадии WIP (work in progress)

Binary file not shown.

After

Width:  |  Height:  |  Size: 184 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 110 KiB