This is the static part of my personal website. It contains whatever I feel like throwing on there.
It is built from markdown files using python-markdown and jinja2 template engine. It uses KaTeX with markdown-katex extension for static math typesetting and codehilite for syntax highlighting, as well as Bootstrap icons.
Content is licensed under the CC-BY 4.0 license, unless specified otherwise.
.env ---- BASE_URL="https://piotr.machura.xyz" REMOTE_HOST="remote" REMOTE_DIR="/var/www/piotr.machura.xyz"
Optionally, provide your own katex binary (markdown-katex bundles its own for
common x86_64 platforms) with e.g.
Generate the website under
poetry run build.
Serve the website locally using
poetry run serve. This uses the python's built-in
http.server module, and as such should not be used in any sort of production
In order to deploy the website content under
./site to a remote host specify the host
name and path in
.env and use
poetry run deploy. Note that this procedure uses
rsync and assumes an authorized SSH key is present on the