You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Sarah Jamie Lewis 736954c505 Update 10 months ago
.idea Update, remove generators etc. 11 months ago
katex Update 10 months ago
posts Update 10 months ago
woff2 Start of a new Blog 11 months ago
LICENSE Create LICENSE 2 years ago Update 2 years ago
a_closer_look_at_fuzzy_threshold_psi.html Update 10 months ago
a_closer_look_at_fuzzy_threshold_psi.png Update 10 months ago
feed.xml Update 10 months ago
footer.html Update, remove generators etc. 11 months ago
ftpsi-parameters.html Update 10 months ago
ftpsi-parameters.png Update 10 months ago
header.html feed + labels 11 months ago
index.html Update 10 months ago Fix push 11 months ago
obfuscated_apples.html Update 10 months ago
obfuscated_apples.png Fix push 11 months ago
ssb Update 10 months ago
styles.css Update 10 months ago

Ssb – simple static blogger

Ssb is a suckless static site generator and blogging anti-framework. It is useful for creating very simplistic blogs based on Markdown writing. If you're looking for a blogging tool that takes nearly no time to set up and just want to start writing with Markdown, then ssb is a perfect script for the task.

Ssb is heavily inspired and based on this post.

Generated site structure

| Header and navbar            |
|                              |
|                              |
| Body written in Markdown     |
|                              |
|                              |
|                              |
| List of posts                |
|                              |
| Footer                       |

Jump start

  1. A POSIX compliant shell and your favourite markdown renderer (pandoc by default) are required.
  2. Download ssb and place it in your PATH or inside your blog directory.
  3. Run ssb -g to generate html and css templates. Adjust the header and the footer to your liking, you can customize the stylesheet, use a css theme, or your favourite style for Markdown.
  4. Write your page and posts in posts directory.
  5. Run ssb to generate html files. Ssb will append header, list of posts and footer to each file.
  6. The timestamps near posts titles are generated from modification dates of Markdown files. If you wish to change them use the touch command.
  7. Publish your blog.

Features and non-features

  • Ssb is a single POSIX compliant script that requires only a Markdown renderer to create blogs.
  • It is not a real framework, just a hackable script to automate blogging and save your time.
  • No tags, no artifacts, no javascript, no learning, no lengthy setup.
  • If you want a simple and effortless blogging engine ssb is perfect for you, whether you want something with more features you can hack it, or use frameworks like Jekyll or Hugo.


./ssb -h
Usage: ./ssb [-d|-g|-h|-r] [-e HEADER_PATH] [-f FOOTER_PATH] [-m MD_RENDERER]
                           [-o OUTPUT_DIR] [-p POSTS_DIR]

Stylesheets for theming can be found here.