From 56a863f9f11340a9310907e4131b9dc7483df623 Mon Sep 17 00:00:00 2001 From: Cullum Smith Date: Wed, 3 Jul 2024 12:25:01 -0400 Subject: initial commit --- README.md | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..d857e87 --- /dev/null +++ b/README.md @@ -0,0 +1,56 @@ +[www.sacredheartsc.com](https://www.sacredheartsc.com/) +========================= + +This repository contains the source for [www.sacredheartsc.com](https://www.sacredheartsc.com). +It consists of Markdown files and a custom static site generator build using pandoc and BSD `make(1)`. + +# Requirements + +- coreutils +- python3 +- pandoc +- BSD make + +# Instructions + +First, install the `pip` requirements: + + make install + +You'll want to edit the [Makefile](Makefile) to set your site URL, +RSS feed title, etc. + +Then, start writing markdown documents in the `src` directory. You can use +whatever naming convention and directory structure you like. Files ending in +`.md` will be converted to `.html` with the same path. + +The `src/blog` directory is special. Markdown files in this directory are +used to populate the front-page blog listing in [index.md](src/index.md). +Before pandoc converts this file to HTML, the special string `__BLOG_LIST__` +is replaced with the output of [bloglist.py](scripts/bloglist.py). +This Python script produces a date-sorted markdown list of all your blog posts. + +Each markdown file can have YAML frontmatter with the following metadata: + + --- + title: A boring blog post + date: YYYY-MM-DD + subtitle: an optional subtitle + heading: optional, if you want the first

to be different from + description: optional, short description for <head> and the blog listing + draft: if set, hides the post from the blog listing + --- + +You can change the resulting HTML by modifying the [template](templates/default.html). +Changing the format of the blog listing requires modifying the Python script. + +Build the website by using the default target: + + make + +This will create a directory called `public` containing all your markdown files +rendered to HTML. + +You also can run a local webserver, which listens on port 8000, using: + + make serve -- cgit v1.2.3