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
1 year ago
.idea Update, remove generators etc. 2 years ago
katex Update 1 year ago
posts Update 1 year ago
woff2 Start of a new Blog 2 years ago
LICENSE Create LICENSE 3 years ago Update 3 years ago
a_closer_look_at_fuzzy_threshold_psi.html Update 1 year ago
a_closer_look_at_fuzzy_threshold_psi.png Update 1 year ago
feed.xml Update 1 year ago
footer.html Update, remove generators etc. 2 years ago
ftpsi-parameters.html Update 1 year ago
ftpsi-parameters.png Update 1 year ago
header.html feed + labels 2 years ago
index.html Update 1 year ago Fix push 2 years ago
obfuscated_apples.html Update 1 year ago
obfuscated_apples.png Fix push 2 years ago
ssb Update 1 year ago
styles.css Update 1 year 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.