fix: add install docs and images ignored by .gitignore

Fixed .gitignore to use /install/ and /build/ with leading slash
so only the root-level colcon dirs are ignored, not
doc/lwc-doc/docs/sunrise/install/.

Adds install pages (Windows, Linux emulator, Linux workbench)
and 22 step-by-step screenshots that were never deployed.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Даниил Грабарь
2026-06-18 15:32:01 +03:00
co-authored by Claude Sonnet 4.6
parent 3a9f1f5150
commit 76db47d989
27 changed files with 177 additions and 2 deletions
@@ -0,0 +1,65 @@
# Установка эмулятора Windows
Для запуска Windows-приложений на Linux используется эмулятор **PortProton**, устанавливаемый через пакетный менеджер **Flatpak** из репозитория **Flathub**.
## Установка Flatpak
Для Ubuntu 18.10 и более поздних версий выполните:
```bash
sudo apt install flatpak
```
![Установка Flatpak](../../assets/install/linux/emulator/step-01.png)
## Установка плагина для GNOME Software
Для поддержки Flatpak-пакетов в Центре приложений GNOME:
```bash
sudo apt install gnome-software-plugin-flatpak
```
## Подключение репозитория Flathub
```bash
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
```
![Добавление репозитория Flathub](../../assets/install/linux/emulator/step-02.png)
!!! warning "Перезагрузка"
После добавления репозитория необходимо перезагрузить систему для применения изменений.
## Установка PortProton
**Через терминал:**
```bash
flatpak install flathub ru.linux_gaming.PortProton
```
![Установка PortProton](../../assets/install/linux/emulator/step-03.png)
**Запуск:**
```bash
flatpak run ru.linux_gaming.PortProton
```
Также PortProton доступен в Центре приложений GNOME после подключения Flathub.
## Первоначальная настройка
При первом запуске PortProton автоматически устанавливает необходимые зависимости Wine и вспомогательные компоненты. Процесс занимает несколько минут.
![Интерфейс PortProton](../../assets/install/linux/emulator/step-04.png)
После завершения инициализации станут доступны основные функции приложения, в том числе:
- **Настройки Wine** — управление конфигурацией Wine-окружения;
- **Командная строка Windows** — запуск cmd.exe внутри Wine;
- **Файловый менеджер** — доступ к виртуальной файловой системе Windows.
!!! tip "Следующий шаг"
После установки PortProton перейдите к разделу [Установка SunriseWorkbench](workbench.md).
@@ -0,0 +1,11 @@
# Установка на Linux
Поскольку SunriseWorkbench совместима только с операционной системой Windows, для работы на Linux необходимо установить утилиту-эмулятор, обеспечивающую запуск Windows-приложений.
На сегодняшний день существует несколько популярных решений:
- **PortProton**
- **ProtonPlus**
- **Bottles**
Установка любого из перечисленных эмуляторов описана в разделе [Установка эмулятора Windows](emulator.md).
@@ -0,0 +1,56 @@
# Установка SunriseWorkbench
В данном разделе описана установка SunriseWorkbench на Linux с использованием эмулятора PortProton.
!!! note "Предварительное требование"
Перед началом установки убедитесь, что PortProton установлен и настроен. Инструкции приведены в разделе [Установка эмулятора Windows](emulator.md).
## Запуск установщика
**Шаг 1.** Перейдите в папку, содержащую установщик SunriseWorkbench. Нажмите правой кнопкой мыши на файл `.exe` и выберите **Открыть с помощью → PortProton**. В диалоговом окне оставьте настройки по умолчанию и нажмите **Run**.
![Запуск установщика через PortProton](../../assets/install/linux/workbench/step-01.png)
## Процесс установки
**Шаг 2.** В появившемся окне выберите язык установки (по умолчанию — английский) и нажмите **OK**.
![Выбор языка](../../assets/install/linux/workbench/step-02.png)
**Шаг 3.** В приветственном окне мастера установки нажмите **Next**.
![Приветственное окно](../../assets/install/linux/workbench/step-03.png)
**Шаг 4.** Ознакомьтесь с условиями лицензионного соглашения и подтвердите принятие.
![Лицензионное соглашение](../../assets/install/linux/workbench/step-04.png)
**Шаг 5.** Путь установки рекомендуется оставить по умолчанию.
![Путь установки](../../assets/install/linux/workbench/step-05.png)
**Шаг 6.** Установите флажок **Create Desktop Shortcut** — ярлык SunriseWorkbench появится на рабочем столе.
![Ярлык на рабочем столе](../../assets/install/linux/workbench/step-06.png)
**Шаг 7.** Нажмите **Install** и дождитесь завершения установки всех необходимых компонентов.
![Процесс установки](../../assets/install/linux/workbench/step-07.png)
## Первый запуск
**Шаг 8.** После завершения установки запустите SunriseWorkbench через созданный ярлык на рабочем столе. Приложение предложит указать путь к рабочему пространству. Рекомендуется оставить значение по умолчанию и установить флажок **Use this as the default and do not ask again**.
![Выбор рабочего пространства](../../assets/install/linux/workbench/step-08.png)
**Шаг 9.** После загрузки главного окна нажмите **New Sunrise Project**.
![Главное окно SunriseWorkbench](../../assets/install/linux/workbench/step-09.png)
**Шаг 10.** В появившемся диалоге создайте новый проект или выберите шаблон.
![Создание нового проекта](../../assets/install/linux/workbench/step-10.png)
!!! tip "Дальнейшая настройка"
Подробные инструкции по конфигурации проекта представлены в разделе [Создание нового проекта](../../config/new-project.md).
Для полноценной работы также рекомендуется выполнить [Установку библиотек](../../config/libraries.md).
@@ -0,0 +1,43 @@
# Установка на Windows
В данном разделе описан процесс установки SunriseWorkbench на операционную систему Windows.
## Установка SunriseWorkbench
**Шаг 1.** Запустите установщик SunriseWorkbench. В появившемся окне выберите язык установки (по умолчанию — английский) и нажмите **OK**.
![Выбор языка](../assets/install/windows/step-01.png)
**Шаг 2.** В приветственном окне мастера установки нажмите **Next**.
![Приветственное окно](../assets/install/windows/step-02.png)
**Шаг 3.** Ознакомьтесь с условиями лицензионного соглашения и подтвердите принятие.
![Лицензионное соглашение](../assets/install/windows/step-03.png)
**Шаг 4.** Путь установки рекомендуется оставить по умолчанию.
![Путь установки](../assets/install/windows/step-04.png)
**Шаг 5.** Для удобства дальнейшей работы установите флажок **Create Desktop Shortcut**.
![Ярлык на рабочем столе](../assets/install/windows/step-05.png)
**Шаг 6.** Нажмите **Install** и дождитесь завершения установки всех необходимых компонентов.
![Процесс установки](../assets/install/windows/step-06.png)
## Первый запуск
**Шаг 7.** При первом запуске приложение предложит указать путь к рабочему пространству (workspace). Рекомендуется оставить путь по умолчанию и установить флажок **Use this as the default and do not ask again**.
![Выбор рабочего пространства](../assets/install/windows/step-07.png)
**Шаг 8.** После загрузки главного окна нажмите **New Sunrise Project** для создания нового проекта.
![Главное окно SunriseWorkbench](../assets/install/windows/step-08.png)
!!! tip "Дальнейшая настройка"
Подробные инструкции по конфигурации проекта представлены в разделе [Создание нового проекта](../config/new-project.md).
Для полноценной работы также рекомендуется выполнить [Установку библиотек](../config/libraries.md).