Meta stuff

1 files changed, 55 insertions, 4 deletions

diff --git a/static.mdwn b/static.mdwn
index 3ac6fc3..9c6bd8c 100644
--- a/static.mdwn
+++ b/static.mdwn
@@ -1,18 +1,69 @@
 [[!meta title="Static site generators"]]
 
+# Current practice
+
+Currently [ikiwiki](http://ikiwiki.info) is adopted by the following reasons:
+
+1. There is a [Debian package](https://packages.debian.org/stable/ikiwiki).
+2. It's flexible enough to support both local or remote side static compilation:
+  a. Local compilation by calling the `ikiwiki` command directly.
+  b. Remotelly by using a [git hook](http://ikiwiki.info/rcs/git/).
+
+When it's said **both** it means that you don't need to choose either of the two options: you can choose or both simultaneously.
+
+## Static site example
+
+Here comes the mandadoty "Hello world" example from the statically generated site realm:
+
+    mkdir blog && cd blog
+    echo "Hello world..." > index.mdwn
+    ikiwiki --rebuild . www/
+
+That's it! You have a generated site sitting at your `www` subfolder which can be copied remotelly using `rsync`.
+
+## Version control
+
+It's a good pratice to keep your work under version control:
+
+    git init
+    echo "/.ikiwiki"       > .gitignore
+    echo "/recentchanges" >> .gitignore
+    echo "/www"           >> .gitignore
+    git add .
+    git commit -m "Initial import"
+
+## Add a bit of sofistication
+
+* Use [this Makefile](/Makefile) as an starting point to refresh and publish your wiki by simply running `make`.
+* If you're a automation junkie, try the [puppet-ikiwiki](https://git.sarava.org/puppet-ikiwiki.git) module.
+
+## Theming
+
+Currently using [Ikiwiki](http://ikiwiki.info) with [Bootstrap](http://twitter.github.io/bootstrap/):
+
+* [Templates](https://github.com/tgpfeiffer/ikiwiki-bootstrap-template).
+* [Bootswatch](http://bootswatch.com) themes.
+
+## Ikiwiki references
+
+* [Ikiwiki](http://ikiwiki.info).
+* [Improving Ikiwiki style with Bootstrap](https://ceops.eu/posts/Improving%20Ikiwiki%20style%20with%20Bootstrap/).
+* [How to have a nice design for ikiwiki](http://www2.tblein.eu/posts/How_to_have_a_nice_design_for_ikiwiki/).
+
+# Alternatives
+
+* [Static Site Generators](https://staticsitegenerators.net/).
+* [Static Site Generators at GitHub](https://github.com/skx/static-site-generators).
 * [Replacing Jekyll with Pandoc and a Makefile](https://tylercipriani.com/2014/05/13/replace-jekyll-with-pandoc-makefile.html).
 * [Brane Dump: Static Comments in Jekyll](http://www.hezmatt.org/~mpalmer/blog/2011/07/19/static-comments-in-jekyll.html).
-* [Juvia: a commenting server similar to Disqus and IntenseDebate](https://github.com/phusion/juvia).
-* [Static Site Generators](https://staticsitegenerators.net/).
 * [Hyde](https://github.com/lakshmivyas/hyde/) ([package](https://packages.debian.org/stable/hyde)).
-* [Ikiwiki](http://ikiwiki.info).
 * [Gollum](https://github.com/gollum/gollum).
 * [Hugo](https://gohugo.io/).
 * [Amber](https://github.com/leapcode/amber).
 * [Grav](http://getgrav.org/).
 * [Hakyll](http://jaspervdj.be/hakyll/) ([package](https://packages.debian.org/sid/libghc-hakyll-dev)).
 * [Jekyll](http://jekyllrb.com/) ([package](https://packages.debian.org/stable/jekyll)).
-* [Static site generators](https://github.com/skx/static-site-generators).
 * [Static site generators for building web sites](https://lwn.net/Articles/541299/).
 * [Pelican Static Site Generator, Powered by Python](http://blog.getpelican.com/) ([pacote](https://packages.debian.org/sid/python-pelican)).
 * [Middleman: Hand-crafted frontend development](https://middlemanapp.com/).
+* [Juvia: a commenting server similar to Disqus and IntenseDebate](https://github.com/phusion/juvia).