GeekiGeeki

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