From 37782d43753c3593a67d2d86507e29b2b86e8c12 Mon Sep 17 00:00:00 2001
From: Boris Yumankulov <boria138@altlinux.org>
Date: Sat, 2 Aug 2025 11:51:28 +0500
Subject: [PATCH] chore(documentation): mention animation

Signed-off-by: Boris Yumankulov <boria138@altlinux.org>
---
 documentation/theme_guide/README.md    | 48 ++++++++++++++++++++++++++
 documentation/theme_guide/README.ru.md | 48 ++++++++++++++++++++++++++
 2 files changed, 96 insertions(+)

diff --git a/documentation/theme_guide/README.md b/documentation/theme_guide/README.md
index d29dca5..c1fd3a2 100644
--- 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
diff --git a/documentation/theme_guide/README.ru.md b/documentation/theme_guide/README.ru.md
index 1b59e61..8400982 100644
--- 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