Edit page GeekiGeeki
[wiki.git] / GeekiGeeki
index ca240b519426b5ff0eb0f48ad2cf52ddeb7489cf..0cc499ea88d8647fccf66620604aa1521a44c15e 100644 (file)
-<div style="float: right">GerryStich.jpg</div>
+<div style="float: right">GerryStich.png</div>
 
-GeekiGeeki is yet another fork of PikiWiki.  Its most important feature is of course the GuruMeditation alerts :-).
-It can also use [[http://git.or.cz/ | git]] or any other SCM as a versioning backend.
+== Geeki Geeki, the Stupid Stupid Wiki Wiki ==
 
-Check the EditingTips to get an idea the supported wiki syntax.
+GeekiGeeki is a minimalistic wiki with a [[http://git.or.cz/ | Git]]
+backend, a high features/complexity ratio and a very clean syntax.
+Check the EditingTips page for an idea the supported markup.
+
+<div style="font-size: large; color: red;  text-align: center">
+For all your geeky wiki needs, GeekiGeeki is **the** stupid choice you can't avoid making!
+</div>
+
+Tags: [[Tags/fast|fast]], [[Tags/stupid|stupid]], [[Tags/!bloated|!bloated]], [[Tags/h4x0r|h4x0r]]
+
+== Features ==
+
+ * S^3: Simple, Small, Stupid
+ * Rich, clean markup syntax highly compatible with WikiCreole and MoinMoin
+ * Git versioned storage backend
+ * Interfaces with GitWeb for history browsing, RSS...
+ * Consistent use of CSS for easy theming
+ * HTML pass-through for powerful formatting
+ * Pluggable macros
+ * Page includes (templates with parameters coming)
+ * Usable for blogging
+ * Directory listing
+ * [[Picture]] gallery
+ * Easy to interface with other SCMs through a glue script
+ * User accounts supported through HTTP basic auth done by web server
+ * Per-page ACLs
+ * Simple title and full text search
+ * Easy CGI installation (no WSGI, mod_python, FCGI...)
+ * Fast!
+ * Only 800 LOCs!
+ * Derived from PikiWiki, like MoinMoin
+ * FreeSoftware and OpenSource, to please everybody
+ * GuruMeditation alerts :-)
+
+== Download ==
+
+==== Releases ====
+
+|| 11-Dec-2008 || **v3.0** || http://www.codewiz.org/wikigit/geekigeeki.git?a=snapshot;h=v3.0;sf=tbz2 ||
+|| 23-Sep-2008 || **v2.0** || http://www.codewiz.org/wikigit/geekigeeki.git?a=snapshot;h=v2.0;sf=tbz2 ||
+
+
+==== Source ====
+
+You can obtain the latest version -- actually ''any'' version -- through git:
+
+{{{
+git clone http://www.codewiz.org/~bernie/git/geekigeeki.git/
+git clone git://www.codewiz.org/~bernie/geekigeeki.git/
+}}}
+
+===== Revision history =====
+
+Browse it online with GitWeb: http://www.codewiz.org/wikigit/geekigeeki.git
+
+===== Individual source files =====
 
-==== Source Code ====
-Source code is available here:
  * [[../wikidata/geekigeeki.py      | geekigeeki.py]]      -- The CGI itself
  * [[../wikidata/geekigeeki.conf.py | geekigeeki.conf.py]] -- Sample site config
  * [[../wikidata/geekigeeki.css     | geekigeeki.css]]     -- The stylesheet used at this site
  * [[../wikidata/post_edit_hook.sh  | post_edit_hook.sh]]  -- Some glue to integrate with git
  * [[../wikidata/wiki_apache.conf   | wiki_apache.conf]]   -- Sample conf file for Apache
 
-==== Contributing ====
+== Installation ==
+
+The easiest way is:
+
+ * clone the git repository anywhere you like
+ * edit **wiki_apache.conf** to adapt it to your system, and move or link it to your Apache configuration directory.
+ * customize the wiki through geekigeeki.conf.py
+ * create a git repository for your wiki:
+ {{{
+ mkdir data
+ cd data
+ git init --shared=group
+ chgrp -R apache .
+ }}}
+ * reload Apache
+
+== Update procedure ==
+
+If you cloned the repository as suggested, updating and downgrading is easy:
+
+{{{
+git pull
+}}}
+
+to switch to a different version of GeekiGeeki:
+
+{{{
+git checkout {tree-ish}
+}}}
+
+where '##{tree-ish}## could be a tag, a branch name, or a specific commit.
+
+== Contributing ==
 
 Please send your patches!  See the GeekiGeekiToDo list for ideas.
 
-Bugfixes and cute hacks welcome.  BloatWare ''will'' be rejected: this is a minimalistic wiki, damn'it!
+Bugfixes and cute hacks welcome.  BloatWare //will// be rejected: this is
+a minimalistic wiki, damn'it!