Add codehilte
Remove useless class from homepage h3s
Make the rsync command more verbose
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.
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
.
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.
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.