95 lines
2.7 KiB
Markdown
95 lines
2.7 KiB
Markdown
📘 This documentation is also available in [English](README.md)
|
||
|
||
---
|
||
|
||
## 📋 Содержание
|
||
- [Обзор](#обзор)
|
||
- [Создание папки темы](#создание-папки-темы)
|
||
- [Файл стилей](#файл-стилей)
|
||
- [Метаинформация](#метаинформация)
|
||
- [Скриншоты](#скриншоты)
|
||
- [Шрифты и иконки](#шрифты-и-иконки)
|
||
- [Звуковые эффекты](#звуковые-эффекты)
|
||
|
||
---
|
||
|
||
## 📖 Обзор
|
||
|
||
Темы в `PortProtonQT` позволяют изменить внешний вид интерфейса и звуковое оформление. Все темы хранятся в папке:
|
||
|
||
- `~/.local/share/PortProtonQT/themes`.
|
||
|
||
---
|
||
|
||
## 📁 Создание папки темы
|
||
|
||
```bash
|
||
mkdir -p ~/.local/share/PortProtonQT/themes/my_custom_theme
|
||
```
|
||
|
||
---
|
||
|
||
## 🎨 Файл стилей (`styles.py`)
|
||
|
||
Создайте `styles.py` в корне темы. В нём определите переменные и/или функции, возвращающие CSS-оформление.
|
||
|
||
**Пример:**
|
||
```python
|
||
# Карта звуковых эффектов
|
||
SOUNDS = {
|
||
"app_start": "app_start.wav", # Запуск приложения
|
||
"app_exit": "app_exit.wav", # Закрытие приложения
|
||
}
|
||
|
||
def custom_button_style(color1, color2):
|
||
return f"""
|
||
QPushButton {{
|
||
background: qlineargradient(x1:0, y1:0, x2:1, y2:0,
|
||
stop:0 {color1}, stop:1 {color2});
|
||
}}
|
||
"""
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 Метаинформация (`metainfo.ini`)
|
||
|
||
```ini
|
||
[Metainfo]
|
||
name = My Custom Theme
|
||
author = Ваше имя
|
||
author_link = https://example.com
|
||
description = Описание вашей темы.
|
||
```
|
||
|
||
---
|
||
|
||
## 🖼 Скриншоты
|
||
|
||
Папка: `images/screenshots/` — любые изображения оформления темы.
|
||
|
||
---
|
||
|
||
## 🔡 Шрифты и иконки (опционально)
|
||
|
||
- Шрифты: `fonts/*.ttf` или `.otf`
|
||
- Иконки: `images/icons/*.svg/.png`
|
||
|
||
---
|
||
|
||
## 🔊 Звуковые эффекты (опционально)
|
||
|
||
Папка: `sounds/` — звуковые эффекты интерфейса.
|
||
|
||
Поддерживаемые форматы:
|
||
- `.wav` - Wave аудио файлы
|
||
|
||
Доступные звуковые события:
|
||
- Звуки интерфейса:
|
||
- `app_start.wav` - Запуск приложения
|
||
- `app_exit.wav` - Закрытие приложения
|
||
|
||
Если звуковой файл отсутствует в пользовательской теме, будет использован звук из стандартной темы.
|
||
|
||
---
|