SjonHortensius / blogmaker

The self-made software package I used to make my blog. Feel free to use it!

Blogmaker

This is an ultra-simple self-hosted blog publishing solution.

Dependencies

• pandoc
• rsync

How to use

See the posts directory for what a post should look like. Posts must be written in markdown, and filenames must end in ".md". Dates must be in (yyyy/mm/dd) format. All posts must be in the posts directory.

If you need a post to use MathJaX to format LaTeX equations, add the line

[pandoc]: <> (--mathjax)

to the config at the top of the post.

To compile a post to html, run ./publish.py posts/name_of_post.md (or ./publish.py posts/* to recompile everything). Use ./publish.py --sync posts to upload the latest version of your site to your server (make sure to put your server details, as well as the site title and icon, in config.md).

Other options include:

• ./publish.py --sync images to sync the images directory
• ./publish.py --sync all to sync everything (including scripts and styles). Make sure to run this the first time you publish

For the server, the simplest setup is to use any VPS, apt install apache2, make sure apache2 is running, and just set the directory to /var/www/html.

Misc

Credit to https://hackmd.io for CSS styles.