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

README.md

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 index.md page and posts in posts directory.
  5. Run ssb index.md 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.

Help

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