GeekiGeeki

   1 <div style="float: right">GerryStich.png</div>
   2
   3 == Geeki Geeki, the Stupid 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 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  * Git versioned storage backend
  21  * Interfaces with GitWeb for history browsing, RSS...
  22  * Consistent use of CSS for easy theming
  23  * HTML pass-through for powerful formatting
  24  * Pluggable macros
  25  * Page includes (templates with parameters coming)
  26  * Usable for blogging
  27  * Directory listing
  28  * [[Picture]] gallery
  29  * Easy to interface with other SCMs through a glue script
  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 CGI installation (no WSGI, mod_python, FCGI...)
  34  * Fast!
  35  * Only 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 || 11-Dec-2008 || **v3.0** || http://www.codewiz.org/wikigit/geekigeeki.git?a=snapshot;h=v3.0;sf=tbz2 ||
  53 || 23-Sep-2008 || **v2.0** || http://www.codewiz.org/wikigit/geekigeeki.git?a=snapshot;h=v2.0;sf=tbz2 ||
  54
  55
  56 ==== Source ====
  57
  58 You can obtain the latest version -- actually ''any'' version -- through git:
  59
  60 {{{
  61 git clone http://www.codewiz.org/~bernie/git/geekigeeki.git/
  62 git clone git://www.codewiz.org/~bernie/geekigeeki.git/
  63 }}}
  64
  65 ===== Revision history =====
  66
  67 Browse it online with GitWeb: http://www.codewiz.org/wikigit/geekigeeki.git
  68
  69 ===== Individual source files =====
  70
  71  * [[../wikidata/geekigeeki.py      | geekigeeki.py]]      -- The CGI itself
  72  * [[../wikidata/geekigeeki.conf.py | geekigeeki.conf.py]] -- Sample site config
  73  * [[../wikidata/geekigeeki.css     | geekigeeki.css]]     -- The stylesheet used at this site
  74  * [[../wikidata/post_edit_hook.sh  | post_edit_hook.sh]]  -- Some glue to integrate with git
  75  * [[../wikidata/wiki_apache.conf   | wiki_apache.conf]]   -- Sample conf file for Apache
  76
  77 == Installation ==
  78
  79 The easiest way is:
  80
  81  * clone the git repository anywhere you like
  82  * edit **wiki_apache.conf** to adapt it to your system, and move or link it to your Apache configuration directory.
  83  * customize the wiki through geekigeeki.conf.py
  84  * create a git repository for your wiki:
  85  {{{
  86  mkdir data
  87  cd data
  88  git init --shared=group
  89  chgrp -R apache .
  90  }}}
  91  * reload Apache
  92
  93 == Update procedure ==
  94
  95 If you cloned the repository as suggested, updating and downgrading is easy:
  96
  97 {{{
  98 git pull
  99 }}}
 100
 101 to switch to a different version of GeekiGeeki:
 102
 103 {{{
 104 git checkout {tree-ish}
 105 }}}
 106
 107 where '##{tree-ish}## could be a tag, a branch name, or a specific commit.
 108
 109 == Contributing ==
 110
 111 Please send your patches!  See the GeekiGeekiToDo list for ideas.
 112
 113 Bugfixes and cute hacks welcome.  BloatWare //will// be rejected: this is
 114 a minimalistic wiki, damn'it!