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
2 years ago
.idea Update, remove generators etc. 2 years ago
katex Update 2 years ago
posts Update 2 years 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 2 years ago
a_closer_look_at_fuzzy_threshold_psi.png Update 2 years ago
feed.xml Update 2 years ago
footer.html Update, remove generators etc. 2 years ago
ftpsi-parameters.html Update 2 years ago
ftpsi-parameters.png Update 2 years ago
header.html feed + labels 2 years ago
index.html Update 2 years ago Fix push 2 years ago
obfuscated_apples.html Update 2 years ago
obfuscated_apples.png Fix push 2 years ago
ssb Update 2 years ago
styles.css Update 2 years 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.