#piotr.machura.xyz

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.

#Building

This project uses poetry for dependency/script management and dotenv for configuration. The following environment variables are expected:

.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. npx katex.

Generate the website under ./site with poetry run build.

#Serving

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 environment.

#Deploying

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 system.