GeekiGeeki

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