journaler

journaler is a static blog generator written in Rust. It transforms Markdown files into a site.

Install

Pre-reqs:

sudo apt install pandoc

journaler is distributed in a source-build only format. As such, you’ll need a Rust:

curl https://sh.rustup.rs -sSf | sh -s -- --default-toolchain nightly

Download and take a look:

wget http://ashtree.systems/journaler/journaler.tar.gz
tar -xvf journaler.tar.gz
cd journaler
ls

Journal

A Journal is a set of posts and the static assets that go with it. A starter journal is provided:

wget http://ashtree.systems/journaler/journal.tar.gz
tar -xvf journal.tar.gz
cd journal

You should edit the CSS as you see fit.

Posts

To create a new post, create a new file in the content directory. Posts are markdown files that start with a metadata header:

---
title: "Here's My Blog Post"
date: "2021-06-19T19:44:33-08:00"
author: "Adam Jesionowski"
description: "A post about something."
---

These values are used when rendering the post. You can see them used in the upper post template: templates/post_upper.html.

Run

cargo run /path/to/your/journal

This will generate an out/ directory. Copy the contents of this directory to the appropriate web server directory.