[[!meta title="About"]]
-### Contact
-
-My main contacts are defined by my OpenPGP key [0x66CA01CE2BF2C9B7E8D64E340546823964E39FCA](https://pgp.mit.edu/pks/lookup?search=0x66CA01CE2BF2C9B7E8D64E340546823964E39FCA&op=index).
-
-### Technology
+### About
This is mixed language and one-cyborg-effort based on the work of the broader [FLOSS](https://en.wikipedia.org/wiki/FLOSS) community. All the content is here because it haven't found any other place yet to be sent. It's my brain's downstream wishing to be upstream somewhere or staged content to be sent to existing upstreams.
-Currently using [Ikiwiki](http://ikiwiki.info) with [Bootstrap](http://twitter.github.io/bootstrap/):
+Fork this site and [check it's integrity](https://manual.sarava.org/meta)!
-* [Templates](https://github.com/tgpfeiffer/ikiwiki-bootstrap-template).
-* [Bootswatch](http://bootswatch.com) themes.
+ git clone git://git.sarava.org/rhatto.git
-Related:
+And send patches ;)
-* [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/).
+### Contact
-Fork this site and [check it's integrity](https://manual.sarava.org/meta)!
+My main contacts are defined by my OpenPGP key [0x66CA01CE2BF2C9B7E8D64E340546823964E39FCA](https://pgp.mit.edu/pks/lookup?search=0x66CA01CE2BF2C9B7E8D64E340546823964E39FCA&op=index).
- git clone git://git.sarava.org/rhatto.git
+### Technology
-And send patches ;)
+This is a [statically-generated website](/static).
Como organizo as atividades
---------------------------
-* Divido as atividades em projetos/grupos/organizações. Cada organização possui uma pasta no meu computador pessoal.
+* Divido as atividades em projetos/grupos/organizações:
+ * Cada uma delas possui uma pasta no meu computador pessoal.
+ * Cada nível de uma estrutura de pasta possui itens de uma mesma categoria.
* Cada um desses projetos possui seu próprio sistema de gestão de tarefas (de um simples arquivo TODO até um sistema de tickets).
* Possuo um calendário com agendador de tarefas integrados:
* Procuro deixá-lo o mais vazio possível em termos de compromissos e tarefas.
Alguns projetos podem ser considerados universais, isto é, serem adotados por pessoas indiferentes de suas atividades principais. São eles:
-* Templates: pode ser entendido como um metaprojeto, agregando receitas de como se começar um novo projeto.
+* [Templates](https://git.sarava.org/templates.git): pode ser entendido como um metaprojeto, agregando receitas de como se começar um novo projeto.
* Fornecedores: é um projeto que agrega listas de compras.
Como organizo o tempo
[[!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).
projects / blog.git / commitdiff