feat & style: add OOP page and fix code style

Author: qqracha

docs/notes/OOP.md

@@ -1,52 +1,37 @@
-# Object-Oriented Programming
-
-!!! danger "GPT ALERT!!!"
-    Эта страница была сгенерирована и ещё не была отредактирована. Качество содержания под вопросом!
+# OOP
 
 ## Определение
 !!! info ""
-    **ООП (Object-Oriented Programming)** — это парадигма программирования, в которой программа строится вокруг **объектов** (данные + поведение), а не вокруг “голых” функций и структур данных.
-    Класс в таком подходе служит “шаблоном”, по которому создаются объекты (экземпляры).
+    **ООП (Object-Oriented Programming)** — методология программирования, в которой система строится вокруг объектов (данные + поведение), где каждый объект является экземпляром определенного класса, а классы образуют иерархию [наследования](./inheritance.md){:.link-accent}.
 
 ## Как это работает
 ООП опирается на несколько базовых сущностей:
 
-- <span class="badge">Class</span> (класс) — описание типа: какие данные и методы будут у объектов. 
-- <span class="badge">Object</span> (объект) — конкретный экземпляр класса. 
-- <span class="badge">Attribute</span> (атрибут/поле) — данные объекта.
-- <span class="badge">Method</span> (метод) — функция, “живущая” в классе и работающая с данными объекта. 
-
-Обычно “ядро” ООП объясняют через 4 принципа:  
-- [Encapsulation](./encapsulation.md){:.link-accent}  
-- [Inheritance](./inheritance.md){:.link-accent}  
-- [Polymorphism](./polymorphism.md){:.link-accent}  
-- [Abstraction](./abstraction.md){:.link-accent}
-
-## Пример
-!!! note "Пример:"
-    Минимальный пример класса и объекта в Python: создаём класс, инициализируем объект, вызываем методы. 
-
-        :::python
-        class BankAccount:
-            def __init__(self, owner: str, balance: int = 0):
-                self.owner = owner
-                self.balance = balance
-
-            def deposit(self, amount: int) -> None:
-                self.balance += amount
+- <span class="badge">Class</span> — языковая конструкция, определяющий структуру (атрибуты) и поведение (методы) для создаваемых на его основе объектов.
 
-            def withdraw(self, amount: int) -> None:
-                if amount > self.balance:
-                    raise ValueError("Not enough money")
-                self.balance -= amount
+- <span class="badge">Attribute</span> — переменная, принадлежащая экземпляру или классу и содержащая данные, описывающие его состояние. <span class="badge">self.name = name</span>
 
-        # Object (instance)
-        acc = BankAccount("Alice", 100)
+- <span class="badge">Method</span> — функция, объявленная в составе класса, которая вызывается у объекта (через self) и работает с его данными/атрибутами. <span class="badge">def meow(self):</span>
 
-        acc.deposit(50)
-        acc.withdraw(30)
+- <span class="badge">Object</span> — конкретный экземпляр класса со своими значениями атрибутов и возможностью вызывать методы класса.
 
-        print(acc.owner, acc.balance)  # Alice 120
+4 основных принципа ООП:  
+- Инкапсуляция ([Encapsulation](./encapsulation.md){:.link-accent})  
+- Наследование ([Inheritance](./inheritance.md){:.link-accent})  
+- Полиморфизм ([Polymorphism](./polymorphism.md){:.link-accent})  
+- Абстракция ([Abstraction](./abstraction.md){:.link-accent})
 
-!!! info ""
-    В этом примере объект `acc` хранит состояние (`owner`, `balance`) и умеет выполнять действия (методы `deposit`, `withdraw`) — это и есть базовая идея ООП. 
+## Пример
+```python
+    class Cat:
+        def __init__(self, name, color):
+            self.name = name      # Attribute | Данные объекта
+            self.color = color
+
+        def meow(self):           # Method | Поведение объекта
+            return f"{self.name}: meow!"
+
+    cat_object = Cat("Kitty", "black")  # Object | Экземпляр класса
+    print(cat_object.name)              # Доступ к атрибуту
+    print(cat_object.meow())            # Вызов метода
+```

docs/stylesheets/extra.css

@@ -53,21 +53,24 @@ VitePress-like (dark, purple)
 }
 [data-md-color-scheme="slate"] .md-typeset a:hover {
   color: #e6a6c9;
+  text-decoration: underline;
   text-decoration-color: #e6a6c9;
 }
 
 /* Блоки кода: скругление и “карточка” */
 [data-md-color-scheme="slate"] .md-typeset pre > code,
 [data-md-color-scheme="slate"] .md-typeset .highlight {
   background: #20232b;
+  padding-left: 0;
   border-radius: 12px;
 }
 
 /* Общая форма (пусть останется “карточкой”) */
 [data-md-color-scheme="slate"] .md-typeset .admonition,
 [data-md-color-scheme="slate"] .md-typeset details.admonition {
   border-radius: 12px;
-  border: 1px solid rgba(255,255,255,.08);
+  border: 0px solid;
+  overflow: hidden;
 }
 
 /* INFO / NOTE (синяя) */
@@ -76,7 +79,7 @@ VitePress-like (dark, purple)
 [data-md-color-scheme="slate"] .md-typeset details.info,
 [data-md-color-scheme="slate"] .md-typeset details.note {
   background-color: rgba(56, 139, 253, 0.12);
-  border-color: rgba(56, 139, 253, 0.30);
+  box-shadow: none;
 }
 
 /* WARNING (жёлтая) */
@@ -92,7 +95,6 @@ VitePress-like (dark, purple)
 [data-md-color-scheme="slate"] .md-typeset details.danger,
 [data-md-color-scheme="slate"] .md-typeset details.error {
   background-color: rgba(248, 81, 73, 0.12);
-  border-color: rgba(248, 81, 73, 0.35);
 }
 
 

docs/stylesheets/pygments-custom.css

@@ -1,14 +1,67 @@
-/* Общий фон и скругление для блоков кода в тёмной теме */
+/* Общий фон и скругление */
 [data-md-color-scheme="slate"] .md-typeset pre > code,
 [data-md-color-scheme="slate"] .md-typeset .highlight {
   background: #171717;
   border-radius: 10px;
 }
 
-/* Токены Pygments (цвета как у вас раньше) */
-[data-md-color-scheme="slate"] .md-typeset .highlight .k { color: #ff7b72; }  /* keyword */
-[data-md-color-scheme="slate"] .md-typeset .highlight .kn { color: #D990B9; }
-[data-md-color-scheme="slate"] .md-typeset .highlight .nf { color: #d2a8ff; } /* function name */
-[data-md-color-scheme="slate"] .md-typeset .highlight .s { color: #a5d6ff; }  /* string */
-[data-md-color-scheme="slate"] .md-typeset .highlight .c { color: #8b949e; }  /* comment */
-[data-md-color-scheme="slate"] .md-typeset .highlight .nn { color: #a5d6ff; } /* import / module */
+/* Полный набор Pygments-токенов для Python (GitHub Dark style) */
+[data-md-color-scheme="slate"] .md-typeset .highlight .k,
+[data-md-color-scheme="slate"] .md-typeset .highlight .kc,
+[data-md-color-scheme="slate"] .md-typeset .highlight .kd,
+[data-md-color-scheme="slate"] .md-typeset .highlight .kp { 
+  color: #ff7b72; /* keyword: class, def, return, if */
+}
+
+[data-md-color-scheme="slate"] .md-typeset .highlight .kn { 
+  color: #ff7b72; /* import/from */
+}
+
+[data-md-color-scheme="slate"] .md-typeset .highlight .nf,
+[data-md-color-scheme="slate"] .md-typeset .highlight .fm { 
+  color: #d2a8ff; /* function name */
+}
+
+[data-md-color-scheme="slate"] .md-typeset .highlight .nc { 
+  color: #79c0ff; /* class name */
+}
+
+[data-md-color-scheme="slate"] .md-typeset .highlight .bp { 
+  color: #79c0ff; /* self, cls */
+}
+
+[data-md-color-scheme="slate"] .md-typeset .highlight .nb { 
+  color: #d2a8ff; /* print, len и другие built-in */
+}
+
+[data-md-color-scheme="slate"] .md-typeset .highlight .s,
+[data-md-color-scheme="slate"] .md-typeset .highlight .s1,
+[data-md-color-scheme="slate"] .md-typeset .highlight .s2 { 
+  color: #a5d6ff; /* strings */
+}
+
+[data-md-color-scheme="slate"] .md-typeset .highlight .c,
+[data-md-color-scheme="slate"] .md-typeset .highlight .c1 { 
+  color: #8b949e; /* comments */
+}
+
+[data-md-color-scheme="slate"] .md-typeset .highlight .mi,
+[data-md-color-scheme="slate"] .md-typeset .highlight .mf { 
+  color: #79c0ff; /* numbers */
+}
+
+[data-md-color-scheme="slate"] .md-typeset .highlight .o { 
+  color: #ff7b72; /* operators: =, +, - */
+}
+
+[data-md-color-scheme="slate"] .md-typeset .highlight .p { 
+  color: #c9d1d9; /* punctuation: (), [] */
+}
+
+[data-md-color-scheme="slate"] .md-typeset .highlight .nn { 
+  color: #79c0ff; /* module/import name */
+}
+
+[data-md-color-scheme="slate"] .md-typeset .highlight .n { 
+  color: #c9d1d9; /* обычные имена переменных */
+}

notes/oop.py

@@ -0,0 +1,11 @@
+class Cat:
+    def __init__(self, name, color):
+        self.name = name      # attribute (данные объекта)
+        self.color = color    # attribute
+
+    def meow(self):           # method (поведение объекта)
+        return f"{self.name}: meow!"
+
+cat_object = Cat("Kitty", "black")  # object (экземпляр класса)
+print(cat_object.name)              # доступ к атрибуту
+print(cat_object.meow())            # вызов метода