From b73268c70c73937f5726f56e3112be0b2bb647fc Mon Sep 17 00:00:00 2001 From: Silvio Rhatto Date: Fri, 19 Jun 2015 14:34:15 -0300 Subject: Meta stuff --- about.mdwn | 25 ----------------------- meta.mdwn | 19 +++++++++++++++++ organization.mdwn | 6 ++++-- orphans.mdwn | 2 +- static.mdwn | 59 +++++++++++++++++++++++++++++++++++++++++++++++++---- templates/page.tmpl | 2 +- 6 files changed, 80 insertions(+), 33 deletions(-) delete mode 100644 about.mdwn create mode 100644 meta.mdwn diff --git a/about.mdwn b/about.mdwn deleted file mode 100644 index f7fa1b8..0000000 --- a/about.mdwn +++ /dev/null @@ -1,25 +0,0 @@ -[[!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 - -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/): - -* [Templates](https://github.com/tgpfeiffer/ikiwiki-bootstrap-template). -* [Bootswatch](http://bootswatch.com) themes. - -Related: - -* [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/). - -Fork this site and [check it's integrity](https://manual.sarava.org/meta)! - - git clone git://git.sarava.org/rhatto.git - -And send patches ;) diff --git a/meta.mdwn b/meta.mdwn new file mode 100644 index 0000000..253fcb9 --- /dev/null +++ b/meta.mdwn @@ -0,0 +1,19 @@ +[[!meta title="About"]] + +### 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. + +Fork this site and [check it's integrity](https://manual.sarava.org/meta)! + + git clone git://git.sarava.org/rhatto.git + +And send patches ;) + +### Contact + +My main contacts are defined by my OpenPGP key [0x66CA01CE2BF2C9B7E8D64E340546823964E39FCA](https://pgp.mit.edu/pks/lookup?search=0x66CA01CE2BF2C9B7E8D64E340546823964E39FCA&op=index). + +### Technology + +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 @@
  • /
    • -
  • | About
    • +
  • | Meta
  • | History
  • | Feed
    • -- cgit v1.2.3