GeekiGeeki

   1 <div style="float: right">GerryStich.jpg</div>
   2
   3 == What is Geeki Geeki? ==
   4
   5 GeekiGeeki is a minimalistic wiki with a [[http://git.or.cz/ | Git]]
   6 backend, a high features/complexity ratio and a very clean syntax.
   7
   8 Check the EditingTips page to get an idea the supported wiki markup.
   9
  10 GeekiGeeki is a descendant of PikiWiki, like MoinMoin, and is written in Python.
  11
  12 == Features ==
  13
  14  * Rich, clean markup syntax highly compatible with WikiCreole
  15  * Git versioned storage backend
  16  * Interfaces with Gitweb for history browsing, RSS...
  17  * Consistent use of CSS for easy theming
  18  * HTML pass-through for powerful formatting
  19  * Pluggable macros
  20  * Page includes (templates with parameters coming)
  21  * Usable for blogging
  22  * Directory listing
  23  * [[Picture]] gallery
  24  * Easy to interface with other SCMs through a glue script
  25  * User accounts supported through HTTP basic auth done by web server
  26  * Per-page ACLs
  27  * Simple title and full text search
  28  * Easy CGI installation (no WSGI, mod_python, FCGI...)
  29  * Fast!
  30  * Only 800 LOCs!
  31  * GuruMeditation alerts :-)
  32
  33 == Download ==
  34
  35 ==== Releases ====
  36
  37 || 11-Dec-2008 || **v3.0** || http://www.codewiz.org/wikigit/geekigeeki.git?a=snapshot;h=v3.0;sf=tbz2 ||
  38 || 23-Sep-2008 || **v2.0** || http://www.codewiz.org/wikigit/geekigeeki.git?a=snapshot;h=v2.0;sf=tbz2 ||
  39
  40
  41 ==== Source ====
  42
  43 You can obtain the latest version -- actually ''any'' version -- through git:
  44
  45 {{{
  46 git clone http://www.codewiz.org/~bernie/git/geekigeeki.git/
  47 git clone git://www.codewiz.org/~bernie/geekigeeki.git/
  48 }}}
  49
  50 ===== Revision history =====
  51
  52 Browse it online with GitWeb: http://www.codewiz.org/wikigit/geekigeeki.git
  53
  54 ===== Individual source files =====
  55
  56  * [[../wikidata/geekigeeki.py      | geekigeeki.py]]      -- The CGI itself
  57  * [[../wikidata/geekigeeki.conf.py | geekigeeki.conf.py]] -- Sample site config
  58  * [[../wikidata/geekigeeki.css     | geekigeeki.css]]     -- The stylesheet used at this site
  59  * [[../wikidata/post_edit_hook.sh  | post_edit_hook.sh]]  -- Some glue to integrate with git
  60  * [[../wikidata/wiki_apache.conf   | wiki_apache.conf]]   -- Sample conf file for Apache
  61
  62 == Installation ==
  63
  64 The easiest way is:
  65
  66  * clone the git repository anywhere you like
  67  * edit **wiki_apache.conf** to adapt it to your system, and move or link it to your Apache configuration directory.
  68  * customize the wiki through geekigeeki.conf.py
  69  * create a git repository for your wiki:
  70  {{{
  71  mkdir data
  72  cd data
  73  git init --shared=group
  74  chgrp -R apache .
  75  }}}
  76  * reload Apache
  77
  78 == Update procedure ==
  79
  80 If you cloned the repository as suggested, updating and downgrading is easy:
  81
  82 {{{
  83 git pull
  84 }}}
  85
  86 to switch to a different version of GeekiGeeki:
  87
  88 {{{
  89 git checkout {tree-ish}
  90 }}}
  91
  92 == Contributing ==
  93
  94 Please send your patches!  See the GeekiGeekiToDo list for ideas.
  95
  96 Bugfixes and cute hacks welcome.  BloatWare //will// be rejected: this is
  97 a minimalistic wiki, damn'it!