ref: a68d00343dd4c2f6e89dd98704e3950244d0d5fe sbs/README.md -rw-r--r-- 1.6 KiB
a68d0034 — Bryce Vandegrift Fixed url error 7 months ago


Static Blogging System

sbs is a POSIX compliant static blog generator that generates an HTML blog, an RSS feed, and a rolling blog page from Markdown.


First, make sure Pandoc is installed on your system.

In order to use sbs the <!-- SB --> (start blog) tag needs to be added to your RSS, home page, and rolling blog pages in order to enable those features. You can use my website repository as an example here or my actual website here.

Change all the variables in the beginning of the script according to your own website specifications as well as create the:

  • Website directory
  • Blog Directory
  • RSS file
  • Rolling blog page in blog directory
  • Drafts directory
  • Home page (index.html)
  • CSS stylesheet
  • Website icon

You can also set your EDITOR variable to use your preferred text editor, otherwise vi is used by default.

sbs can also be used on a directory by directory basis, just change the website_dir variable to $(pwd).


sbs new		# Create a new blog post
sbs edit	# Quickly edit existing draft
sbs publish	# Publish a draft and turn it into a webpage
sbs delete	# Delete a draft
sbs help	# Show quick help
sbs version	# Show version


Please report any bugs or errors to bpv@disroot.org.


Parts of this program were used from Luke Smith's blog generation script.


In the future I plan to expand on this script in order to add more features as well as to make it more portable and easier to use.