~piotr-machura/piotr.machura.xyz

Personal website content
Remove useless class from homepage h3s
Make the rsync command more verbose
Move icons around

refs

master
browse  log 

clone

read-only
https://git.sr.ht/~piotr-machura/piotr.machura.xyz
read/write
git@git.sr.ht:~piotr-machura/piotr.machura.xyz

You can also use your local clone with git send-email.

#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 for math typesetting and highligh.js 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"

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.