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