Initial commit

Author: yakhyo

README.md

@@ -1,57 +1,52 @@
+# SOLID Principles in Python
+
 <p align="center">
   <img src="assets/banner.png" alt="SOLID Principles in Python" />
 </p>
 
-Learn the five SOLID design principles with small Python examples (**violation** vs **correct**) and UML class diagrams.
-
-| Docs site | https://yakhyo.github.io/solid-python/ |
-|-----------|----------------------------------------|
-| Source    | https://github.com/yakhyo/solid-python |
-
-## Requirements
-
-- **Python 3.10+** (for running the examples)
-- **Ruby 3.x + Bundler** (only for running the docs site locally)
+<p align="center">
+  <b>Learn SOLID design principles through Python examples — violation vs correct, with UML diagrams.</b>
+</p>
 
-## Running the examples
+<p align="center">
+  <a href="https://yakhyo.github.io/solid-python/">Documentation</a> · <a href="https://yakhyo.github.io/solid-python/uz/">O'zbekcha</a>
+</p>
 
-Each example is a standalone script with no external dependencies.
+## Quick start
 
 ```bash
-python 01-single-responsibility/violation.py
-python 01-single-responsibility/correct.py
+python docs/01-srp/violation.py
+python docs/01-srp/correct.py
 ```
 
-## Running the docs site locally
+Requires **Python 3.10+**, no external dependencies.
+
+## Docs site locally
 
 ```bash
 bundle install
 bundle exec jekyll serve --livereload
 ```
 
-Open `http://localhost:4000/solid-python/` in your browser.
+Then open `http://localhost:4000/solid-python/`
 
-## Repository layout
+## Structure
 
 ```text
-.
-├── 01-single-responsibility/   # S — Single Responsibility Principle
-│   ├── violation.py
-│   ├── correct.py
-│   ├── README.md               # English docs
-│   └── README.uz.md            # Uzbek docs
-├── 02-open-closed/             # O — Open/Closed Principle
-├── 03-liskov-substitution/     # L — Liskov Substitution Principle
-├── 04-interface-segregation/   # I — Interface Segregation Principle
-├── 05-dependency-inversion/    # D — Dependency Inversion Principle
-├── assets/                     # UML class diagrams
-├── index.md / index.uz.md      # Home pages (EN / UZ)
-├── _config.yml                 # Jekyll configuration
-├── Gemfile                     # Jekyll dependencies
-└── .github/workflows/
-    └── pages.yml               # GitHub Pages deployment
+docs/
+├── 01-srp/              # Single Responsibility
+├── 02-ocp/              # Open/Closed
+├── 03-lsp/              # Liskov Substitution
+├── 04-isp/              # Interface Segregation
+├── 05-dip/              # Dependency Inversion
+│   ├── violation.py     # What goes wrong
+│   ├── correct.py       # How to fix it
+│   ├── README.md        # English docs
+│   └── README.uz.md     # Uzbek docs
+├── index.md             # Home (EN)
+└── index.uz.md          # Home (UZ)
 ```
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT — [LICENSE](LICENSE)

_config.yml

@@ -41,8 +41,6 @@ footer_content: >-
   © 2025 Yakhyokhuja Valikhujaev.
   Distributed under the <a href="https://github.com/yakhyo/solid-python/blob/main/LICENSE">MIT License</a>.
 
-color_scheme: light
-
 sass:
   quiet_deps: true
   silence_deprecations:

_includes/head_custom.html

@@ -0,0 +1,54 @@
+<style>
+  .theme-toggle {
+    position: fixed;
+    bottom: 1.5rem;
+    right: 1.5rem;
+    z-index: 999;
+    background: var(--body-background-color);
+    border: 1px solid var(--border-color);
+    border-radius: 50%;
+    width: 2.5rem;
+    height: 2.5rem;
+    cursor: pointer;
+    font-size: 1.2rem;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);
+    transition: transform 0.2s ease;
+  }
+  .theme-toggle:hover {
+    transform: scale(1.1);
+  }
+</style>
+
+<button class="theme-toggle" id="theme-toggle" aria-label="Toggle dark mode"></button>
+
+<script>
+(function () {
+  var btn = document.getElementById("theme-toggle");
+  var prefersDark = window.matchMedia("(prefers-color-scheme: dark)").matches;
+  var current = localStorage.getItem("theme") || (prefersDark ? "dark" : "light");
+
+  function apply(theme) {
+    jtd.setTheme(theme);
+    btn.innerHTML = theme === "dark"
+      ? '<svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="5"/><line x1="12" y1="1" x2="12" y2="3"/><line x1="12" y1="21" x2="12" y2="23"/><line x1="4.22" y1="4.22" x2="5.64" y2="5.64"/><line x1="18.36" y1="18.36" x2="19.78" y2="19.78"/><line x1="1" y1="12" x2="3" y2="12"/><line x1="21" y1="12" x2="23" y2="12"/><line x1="4.22" y1="19.78" x2="5.64" y2="18.36"/><line x1="18.36" y1="5.64" x2="19.78" y2="4.22"/></svg>'
+      : '<svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/></svg>';
+    localStorage.setItem("theme", theme);
+  }
+
+  apply(current);
+
+  btn.addEventListener("click", function () {
+    var next = localStorage.getItem("theme") === "dark" ? "light" : "dark";
+    apply(next);
+  });
+
+  window.matchMedia("(prefers-color-scheme: dark)").addEventListener("change", function (e) {
+    if (!localStorage.getItem("theme")) {
+      apply(e.matches ? "dark" : "light");
+    }
+  });
+})();
+</script>