rss-only web content
Go to file
Christopher P. Brown 59b42d10a6 add bare uris 2022-04-11 11:50:21 -06:00
src@86a368cac6 add bare uris 2022-04-11 11:50:21 -06:00
.gitmodules config garden and content submodule 2022-01-24 18:57:19 -07:00
README.md inittles committles 2022-01-24 17:51:30 -07:00
feed.tmpl config garden and content submodule 2022-01-24 18:57:19 -07:00
justfile add bare uris 2022-04-11 11:50:21 -06:00

README.md

Gardener 🌱

This is a tool for making a weed.

weed
short for "web feed"
an rss-only blog

(All of the content is in the RSS feed. There is no web content.)

About

This uses pandoc's --template flag to create an rss feed item.

See feed.tmpl.

Motivation

RSS is dead, but we never stopped using it.

We are the necromancers who fill it with the foul mimicry of life.

Requirements

Getting Started

  1. Edit the vars section at the top of the justfile

  2. Edit the author tag in feed.tmpl. Or, as a learning exercise, change the contents of the tag to $author$ and start including an "author" value in the front matter of all your markdown sources. See how that works?

  3. Create a new markdown file in /src

  4. Give it the following YAML metadata block

    ---
    title: 'title of my post'
    created_at: 'Mon, 24 Jan 2022 17:26:03 -0700'
    ---
    

    Note that values need to be quoted.

    Note further that the timestamp should in RFC 5532 format. (date -R)

  5. Write the rest of your post

  6. Run just build to assemble your xml

  7. Edit the up recipe in the justfile so you can upload to your server.

  8. If you're feeling swoopy, run just all to build and upload in one fell swoop.

Acknowledgments

Thanks to the #basement crew for making such a lovely garden full of beautiful weeds <3