~bpv/sbs

Static Blogging System
e0512cfe — Bryce Vandegrift 4 months ago
Added rename feature and v1.0.1
aa520ed5 — Bryce Vandegrift 4 months ago
Corrected RSS formatting
a68d0034 — Bryce Vandegrift 4 months ago
Fixed url error

refs

master
browse  log 

clone

read-only
https://git.sr.ht/~bpv/sbs
read/write
git@git.sr.ht:~bpv/sbs

You can also use your local clone with git send-email.

#sbs

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.

#Installation

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).

#Usage

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 rename	# Rename a draft
sbs delete	# Delete a draft
sbs help	# Show quick help
sbs version	# Show version

#Bugs

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

#Contributions

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

#Notice

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.