Edit page TwoHundredDollarLaptop

[wiki.git] / GeekiGeeki

diff --git a/GeekiGeeki b/GeekiGeeki
index d5f9e4351803ac5ce923986bc323441746d2c6e4..ca7bcbfe3d556e669dfbfd87ef87c27291b8408b 100644 (file)
--- a/GeekiGeeki
+++ b/GeekiGeeki
@@ -1,20 +1,68 @@
 <div style="float: right">GerryStich.jpg</div>
 
-This WikiWikiWeb runs a fork of PikiWiki.  The most important feature of GeekiGeeki is of course the GuruMeditation alerts, but it also uses [[http://git.or.cz/ Git]] as a versioning backend.
+==== What is Geeki Geeki? ====
+
+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 of your choice as a versioning backend.
 
 Check the EditingTips to get an idea the supported wiki syntax.
 
-==== Source Code ====
+==== Download ====
+
+===== Source repository ====
+
+You can obtain the latest source snapshot 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 =====
+
+ * [[../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
+
+==== 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:
 
-The modified 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
+{{{
+git-checkout VERSION
+}}}
 
 ==== 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!