aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSilvio Rhatto <rhatto@riseup.net>2015-06-19 14:34:15 -0300
committerSilvio Rhatto <rhatto@riseup.net>2015-06-19 14:34:15 -0300
commitb73268c70c73937f5726f56e3112be0b2bb647fc (patch)
tree2a295b72f44a818835445b54a751998dea720cf6
parent2b911e15a07c0e652ce92e434e8ab1350dd91894 (diff)
downloadblog-b73268c70c73937f5726f56e3112be0b2bb647fc.tar.gz
blog-b73268c70c73937f5726f56e3112be0b2bb647fc.tar.bz2
Meta stuff
-rw-r--r--meta.mdwn (renamed from about.mdwn)22
-rw-r--r--organization.mdwn6
-rw-r--r--orphans.mdwn2
-rw-r--r--static.mdwn59
-rw-r--r--templates/page.tmpl2
5 files changed, 69 insertions, 22 deletions
diff --git a/about.mdwn b/meta.mdwn
index f7fa1b8..253fcb9 100644
--- a/about.mdwn
+++ b/meta.mdwn
@@ -1,25 +1,19 @@
[[!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).
diff --git a/organization.mdwn b/organization.mdwn
index f611fe9..25e549b 100644
--- a/organization.mdwn
+++ b/organization.mdwn
@@ -10,7 +10,9 @@ Isso varia de pessoa para pessoa. TL;DR aqui é o seguinte: experimente formas d
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.
@@ -24,7 +26,7 @@ Como organizo as atividades
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
diff --git a/orphans.mdwn b/orphans.mdwn
index f649b39..7b819ca 100644
--- a/orphans.mdwn
+++ b/orphans.mdwn
@@ -44,4 +44,4 @@ Para que eu passe um projeto para a frente a pessoa ou grupo responsável terá
Além disso, me mantenho comprometido, na medida do possível:
* Prestar consultoria sobre os projetos.
-* De realizar checagens periódicas (por exemplo semestrais) para saber se as pessoas ainda estão mantendo os projetos ou se é necessário procurar outras pessoas para adotá-los.
+* De realizar checagens periódicas (pings semestrais, por exemplos) para saber se as pessoas ainda estão mantendo os projetos ou se é necessário procurar outras pessoas para adotá-los.
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).
diff --git a/templates/page.tmpl b/templates/page.tmpl
index 239617e..5da926a 100644
--- a/templates/page.tmpl
+++ b/templates/page.tmpl
@@ -137,7 +137,7 @@
<li><a href="<TMPL_VAR URL>"><TMPL_VAR PAGE></a> <span class="divider">/</span> </li>
</TMPL_LOOP>
<li><TMPL_VAR TITLE></li>
- <li><span class="divider">|</span> <a href="/about">About</a></li>
+ <li><span class="divider">|</span> <a href="/meta">Meta</a></li>
<li><span class="divider">|</span> <a href="<TMPL_VAR HISTORYURL>">History</a></li>
<li><span class="divider">|</span> <a href="/index.rss">Feed</a></li>
</ul>