diff options
author | Silvio Rhatto <rhatto@riseup.net> | 2015-06-19 14:34:15 -0300 |
---|---|---|
committer | Silvio Rhatto <rhatto@riseup.net> | 2015-06-19 14:34:15 -0300 |
commit | b73268c70c73937f5726f56e3112be0b2bb647fc (patch) | |
tree | 2a295b72f44a818835445b54a751998dea720cf6 /static.mdwn | |
parent | 2b911e15a07c0e652ce92e434e8ab1350dd91894 (diff) | |
download | blog-b73268c70c73937f5726f56e3112be0b2bb647fc.tar.gz blog-b73268c70c73937f5726f56e3112be0b2bb647fc.tar.bz2 |
Meta stuff
Diffstat (limited to 'static.mdwn')
-rw-r--r-- | static.mdwn | 59 |
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). |