The static website is built using Nikola and served by Caddy.
Get interactive shell with the dependencies present using Nix:
nix-shell
The Nikola version is pinned, so it should always work with the current state of the website.
Before you start editing, get the latest changes from Github.
git pull
Use your favorite text editor to edit the content in pages/
and posts/
.
Use nikola new_post --format=markdown
to create a new post or nikola new_page --format=markdown
for a new page. You can also just create a new file with your editor and copy the metadata at the top from another one.
Remember to create also an english version with added "en" like neuer-artikel.en.md
.
nikola build
This command opens the website in your default browser.
nikola serve --browser
To rebuild the website automatically after changes use nikola auto --browser
.
Push the website to the production server.
nikola deploy
Your SSH-Key must be configured to have access.
Commit your changes to the git repository and push it to Github.
git status
git add README.md
git commit -m "add README"
git push
To push your changes, you need commit rights on Github. If you don't have them and still want to contribute, fork the repository on Github and create a Pull-Request by pushing your branch.