Statikaj is a simple engine to create a static blog
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Statikaj Dependency Status

Simple static blog-engine based on cloudhead/toto, perfect for hackers. Like toto, Statikaj is git-powered

10 seconds blog

$ gem install statikaj
$ statikaj new myblog
$ cd myblog
$ statikaj build --url
$ rackup -p 3000 # http://localhost:3000


Why you don't need generate your blog every http request. Statikaj don't use database, don't parse ERB/Markdown on production. Build your blog and send a static version to your server, Statikaj will works with any http server, you don't need ruby, java, php, etc, a small nginx or apache process will be OK.

Command line

$ statikaj
  statikaj article          # Create new article
  statikaj build --url=URL  # Build the static blog version on public folder
  statikaj help [COMMAND]   # Describe available commands or one specific command
  statikaj new              # Create a new project

Creating and Writing a article

Create a article is very easy, first to create a correct file Statikaj provides the article command.

$ statikaj article

Statikaj article will prompt the article title, and will create a file into src/articles, use your preferred markdown editor open the file. When you finished just builds yout blog again.

$ statikaj build --url

The article file

The article file show like it:

title: My Title
date: 29/09/2013
author: User
category: category

Once upon a time...

To create a summary use ~~~ as delimiter, like it:

title: My Title
date: 29/09/2013
author: User
category: category

Once upon a time, there was a lovely princess.


But she had an enchantment upon her of a fearful sort, which could only be broken by love's first kiss.

Works on your blog design

TODO, for now see src/templates


$ gem install statikaj # or bundle update statikaj
$ cd myblog
$ statikaj new . # ATTENTION the command will prompt if you want change yours files, make a backup before!

Who uses it?


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request