How I made this website

The Pieces

This is a staticly compiled site that uses nothing but standard html and css (and one bit of javascript to simplify code coloring). Everyting is built around a generic header, footer and markdown files for the content body.

The nicest feature of this site, and keeping every component of it as simple as possible is all of its modular. If you would like to use a different method to generate a logo, convert the markdown to html, add a web framework, change the publishing method, add an in browser editor, you can! Your only limitations are your know how and imagination.

To build out this site I had to solve a few problems.

  1. A logo
  2. What should I use to compile the md files into html?
  3. css?
  4. code coloring
  5. where to compile?
  6. how should I push updates to the site?
    • Should I setup a watcher on the server to look for new files and just use syncthing?
    • Should I just use a simple rsync script to publish new articles.

Let us start with the simplest (and some may argue the most important) piece of any website, the logo. I took advantage of the free version of figma to create my simple logo and export the png and svg. There are any number of pieces of software that can produce similar output