chore(documentation): mention animation

Signed-off-by: Boris Yumankulov <boria138@altlinux.org>
2025-08-02 11:51:28 +05:00
parent 0a8a7c538c
commit 37782d4375
2 changed files with 96 additions and 0 deletions
--- a/documentation/theme_guide/README.md
+++ b/documentation/theme_guide/README.md
@ -6,6 +6,7 @@
 - [Overview](#overview)
 - [Creating the Theme Folder](#creating-the-theme-folder)
 - [Style File](#style-file)
+- [Animation configuration](#animation-configuration)
 - [Metadata](#metadata)
 - [Screenshots](#screenshots)
 - [Fonts and Icons](#fonts-and-icons)
@ -45,6 +46,53 @@ def custom_button_style(color1, color2):

 ---

+## 🎥 Animation configuration
+
+The `GAME_CARD_ANIMATION` dictionary controls all animation parameters for game cards:
+
+```python
+GAME_CARD_ANIMATION = {
+    # Animation type when transitioning to a detailed page
+    # Available values: "fade", "slide_left", "slide_right", "slide_up", "slide_down", "bounce", "none"
+    "detail_page_animation_type": "fade",
+
+    # Border width settings (in pixels)
+    "default_border_width": 2,
+    "hover_border_width": 8,
+    "focus_border_width": 12,
+    "pulse_min_border_width": 8,
+    "pulse_max_border_width": 10,
+
+    # Animation duration (in milliseconds)
+    "thickness_anim_duration": 300,
+    "pulse_anim_duration": 800,
+    "gradient_anim_duration": 3000,
+
+    # Gradient animation angles (in degrees)
+    "gradient_start_angle": 360,
+    "gradient_end_angle": 0,
+
+    # Smoothing curves for smooth animations
+    "thickness_easing_curve": "OutBack",
+    "thickness_easing_curve_out": "InBack",
+
+    # Gradient colors for animated stroke
+    "gradient_colors": [
+        {"position": 0, "color": "#00fff5"},
+        {"position": 0.33, "color": "#FF5733"},
+        {"position": 0.66, "color": "#9B59B6"},
+        {"position": 1, "color": "#00fff5"}
+    ],
+
+    # Duration of transitions to the detailed page
+    "detail_page_fade_duration": 350,
+    "detail_page_slide_duration": 500,
+    "detail_page_zoom_duration": 400
+}
+```
+
+---
+
 ## 📝 Metadata (`metainfo.ini`)

 ```ini
--- a/documentation/theme_guide/README.ru.md
+++ b/documentation/theme_guide/README.ru.md
@ -6,6 +6,7 @@
 - [Обзор](#обзор)
 - [Создание папки темы](#создание-папки-темы)
 - [Файл стилей](#файл-стилей)
+- [Конфигурация анимации](#конфигурация-анимации)
 - [Метаинформация](#метаинформация)
 - [Скриншоты](#скриншоты)
 - [Шрифты и иконки](#шрифты-и-иконки)
@ -45,6 +46,53 @@ def custom_button_style(color1, color2):

 ---

+## 🎥 Конфигурация анимации
+
+Словарь `GAME_CARD_ANIMATION` управляет всеми параметрами анимации для карточек игр:
+
+```python
+GAME_CARD_ANIMATION = {
+    # Тип анимации при переходе на детальную страницу
+    # Доступные значения: "fade", "slide_left", "slide_right", "slide_up", "slide_down", "bounce", "none"
+    "detail_page_animation_type": "fade",
+
+    # Настройки ширины обводки (в пикселях)
+    "default_border_width": 2,
+    "hover_border_width": 8,
+    "focus_border_width": 12,
+    "pulse_min_border_width": 8,
+    "pulse_max_border_width": 10,
+
+    # Длительности анимаций (в миллисекундах)
+    "thickness_anim_duration": 300,
+    "pulse_anim_duration": 800,
+    "gradient_anim_duration": 3000,
+
+    # Углы анимации градиента (в градусах)
+    "gradient_start_angle": 360,
+    "gradient_end_angle": 0,
+
+    # Кривые сглаживания для плавных анимаций
+    "thickness_easing_curve": "OutBack",
+    "thickness_easing_curve_out": "InBack",
+
+    # Цвета градиента для анимированной обводки
+    "gradient_colors": [
+        {"position": 0, "color": "#00fff5"},
+        {"position": 0.33, "color": "#FF5733"},
+        {"position": 0.66, "color": "#9B59B6"},
+        {"position": 1, "color": "#00fff5"}
+    ],
+
+    # Длительности переходов на детальную страницу
+    "detail_page_fade_duration": 350,
+    "detail_page_slide_duration": 500,
+    "detail_page_zoom_duration": 400
+}
+```
+
+---
+
 ## 📝 Метаинформация (`metainfo.ini`)

 ```ini