LeoYan Solutions ⚡

A beautiful MkDocs-Material site for explaining Codeforces solutions - with runnable code, Mermaid diagrams, tag filters, and a live dashboard.

Live demo: LeoYan Solutions 🌐

git clone https://github.com/PilotLeoYan/leoyan-solutions.git
cd leoyan-solutions

pip install -r requirements.txt

In mkdocs.yml, replace every PilotLeoYan and YOUR_CF_HANDLE:

site_url: https://PilotLeoYan.github.io/leoyan-solutions/
repo_url: https://github.com/PilotLeoYan/leoyan-solutions

mkdocs serve

Open http://127.0.0.1:8000.

1. Copy the template:

   cp docs/problems/_template.md docs/problems/999X-my-problem.md

2. Edit the YAML frontmatter:

   ---
   title: "999X – My Problem"
   problem_id: "999X"
   problem_url: "https://codeforces.com/problemset/problem/999/X"
   difficulty: 1400
   date_solved: "2025-01-01"
   tags:
     - binary search
     - greedy
   ---

3. Write your explanation using any of:

   • === "Python" / === "C++17" tabbed code blocks
   • ```mermaid diagrams
   • !!! note "Complexity Analysis" admonitions
   • $O(n \log n)$ inline LaTeX

4. Add it to the nav section in mkdocs.yml.

5. Push:

   git add docs/problems/999X-my-problem.md mkdocs.yml
   git commit -m "feat: add 999X My Problem"
   git push

GitHub Actions auto-builds and deploys in ~60 seconds.

leoyan-solutions/
├── .github/workflows/
│   └── deploy.yml          # CI/CD -> GitHub Pages
├── docs/
│   ├── overrides/
│   │   └── home.html       # Custom home page template
│   ├── problems/
│   │   ├── _template.md    # Copy this for new problems
│   │   ├── 4A-watermelon.md
│   │   └── ...
│   ├── data/
│   │   └── problems.json   # Auto-generated by MkDocs hook
│   ├── javascripts/
│   │   ├── extra.js        # Home dashboard (charts, filter)
│   │   └── code-runner.js  # Pyodide + Wandbox buttons
│   │   └── mathjax.js      # Render LaTeX
│   ├── stylesheets/
│   │   └── extra.css       # Custom styles
│   ├── index.md            # Home page (uses home.html)
│   └── about.md
├── scripts/
│   └── generate_data.py    # MkDocs hook: builds problems.json
├── mkdocs.yml
├── requirements.txt
└── README.md

1. Push to main.
2. GitHub Actions runs and pushes to the gh-pages branch.
3. In your repo -> Settings -> Pages, set source to gh-pages branch.

Switch between light and dark with the sun/moon toggle in the top-right.

To add more colour schemes, edit the palette section in mkdocs.yml:

palette:
  - scheme: default   # light
    primary: deep-purple
    accent: cyan
  - scheme: slate     # dark
    primary: deep-purple
    accent: cyan

MIT - do whatever you like with it.