Blog

Personal blog built with MkDocs Material.

This project uses a local Python virtual environment to keep all dependencies isolated to this folder.

• Python 3.8 or higher

1. Activate the virtual environment:

   # On macOS/Linux
   source .venv/bin/activate
   
   # On Windows
   .venv\Scripts\activate

2. Install dependencies:

   pip install -r requirements.txt

Serve locally (with hot reload):

mkdocs serve

Build the site:

mkdocs build

Deactivate virtual environment when done:

deactivate

• The .venv directory contains all Python dependencies and is already in .gitignore
• All dependencies are installed locally in this folder, not system-wide
• Always activate the virtual environment before running MkDocs commands