# GitHub - vbuterin/blogmaker: Self-made software package I used to make my blog.

Source: https://github.com/vbuterin/blogmaker
Kiwi News: https://news.kiwistand.com/stories/GitHub-vbuterinblogmaker-Self-made-software-package-I-used-to-make-my-blog?index=0x6527906015e3c2354682b91af66cc317e1244e2f166ecf861defc21b589e2fb410ba8ce4
Submitted by misha on 2023-10-12 UTC, 7 upvotes, 0 comments

## Summary

This GitHub repository, vbuterin/blogmaker, is a self-made, ultra-simple self-hosted blog publishing tool that its author used for their own blog. Posts are written in markdown with filenames ending in ".md" and dates in yyyy/mm/dd format, and the publish.py script compiles them to HTML using pandoc. Running ./publish.py --sync uploads the site to a server configured in config.md, and rsync is required for this step. The readme suggests a simple server setup using any VPS with apache2 and the /var/www/html directory, and it credits hackmd.io for the CSS styles.

## Article

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

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

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.