This repository contains my personal website, which is hosted on olivi-eh.dev. It is powered by a custom static site generator script that renders Markdown documents using Jinja2 templates.
- Markdown pages: Write posts and pages in plain Markdown inside the
notes/directory. - Pretty URLs: Automatically formats outputs so that pages are served clean (e.g.,
/about/instead of/about.html). - Automated feeds: Dynamically generates RSS (
rss.xml), Atom (atom.xml), and Sitemap (sitemap.xml) files on every build. - Development mode: Built-in development server with automatic file watching and rebuilds.
notes/— Source markdown files for the posts and pages.static/— Static assets like CSS, images, and fonts.templates/— Jinja2 HTML templates used to render the markdown pages.static-root/— Configuration files meant to live at the root of the site (e.g.,CNAME,robots.txt,404.html).out/— The compiled web assets ready for deployment (git ignored).
This project utilizes the uv package manager to manage dependencies and python runtimes. You only need to have uv installed; it will automatically download and manage the required Python version for you.
Clone the repository and navigate to the project directory:
git clone https://github.com/olivi-eh/olivi-eh.github.io.git
cd olivi-eh.github.ioTo serve the website locally and watch for changes in notes/, templates/, and static/ directories:
./dev.shThis will automatically build the site, run a local development server at http://localhost:8082, and trigger automatic rebuilds as you edit the files.
If you just want to run a one-time build to compile the static files:
uv run build.pyThis clean build will output all static assets directly into the out/ directory.
Deployments are automated via GitHub Actions (gh-pages-deploy.yaml). Any push to the main branch compiles the site and pushes the output from the out/ directory to the gh-pages branch, which is then served by GitHub Pages.
