95 lines
1.9 KiB
Markdown
95 lines
1.9 KiB
Markdown
📘 Эта документация также доступна на [русском](README.ru.md)
|
|
|
|
---
|
|
|
|
## 📋 Contents
|
|
- [Overview](#overview)
|
|
- [Creating the Theme Folder](#creating-the-theme-folder)
|
|
- [Style File](#style-file)
|
|
- [Metadata](#metadata)
|
|
- [Screenshots](#screenshots)
|
|
- [Fonts and Icons](#fonts-and-icons)
|
|
- [Sound Effects](#sound-effects)
|
|
|
|
---
|
|
|
|
## 📖 Overview
|
|
|
|
Themes in `PortProtonQT` allow customizing the UI appearance and sounds. Themes are stored under:
|
|
|
|
- `~/.local/share/PortProtonQT/themes`.
|
|
|
|
---
|
|
|
|
## 📁 Creating the Theme Folder
|
|
|
|
```bash
|
|
mkdir -p ~/.local/share/PortProtonQT/themes/my_custom_theme
|
|
```
|
|
|
|
---
|
|
|
|
## 🎨 Style File (`styles.py`)
|
|
|
|
Create a `styles.py` in the theme root. It should define variables or functions that return CSS.
|
|
|
|
**Example:**
|
|
```python
|
|
# Sound effects mapping
|
|
SOUNDS = {
|
|
"app_start": "app_start.wav", # Application startup
|
|
"app_exit": "app_exit.wav", # Application exit
|
|
}
|
|
|
|
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});
|
|
}}
|
|
"""
|
|
```
|
|
|
|
---
|
|
|
|
## 📝 Metadata (`metainfo.ini`)
|
|
|
|
```ini
|
|
[Metainfo]
|
|
name = My Custom Theme
|
|
author = Your Name
|
|
author_link = https://example.com
|
|
description = Description of your theme.
|
|
```
|
|
|
|
---
|
|
|
|
## 🖼 Screenshots
|
|
|
|
Folder: `images/screenshots/` — place UI screenshots there.
|
|
|
|
---
|
|
|
|
## 🔡 Fonts and Icons (optional)
|
|
|
|
- Fonts: `fonts/*.ttf` or `.otf`
|
|
- Icons: `images/icons/*.svg/.png`
|
|
|
|
---
|
|
|
|
## 🔊 Sound Effects (optional)
|
|
|
|
Folder: `sounds/` — place interface sound effects here.
|
|
|
|
Supported formats:
|
|
- `.wav` - Wave audio files
|
|
|
|
Available sound events:
|
|
- Interface sounds:
|
|
- `app_start.wav` - Application startup
|
|
- `app_exit.wav` - Application exit
|
|
|
|
If a sound file is missing in a custom theme, the default sound from the standard theme will be used.
|
|
|
|
---
|