Edit page GeekiGeeki
[wiki.git] / GeekiGeeki
index 13bc3e4d572f2b6c31ffc93847763400270aac95..4a3f33ec95787323338ff7fb40990e4215629320 100644 (file)
@@ -1,46 +1,57 @@
-<div style="float: right">GerryStich.png</div>
+<div style="float: right">{{GerryStich.png}}</div>
 
-== Geeki Geeki, the stupid Wiki Wiki ==
+== Geeki Geeki, the Stupid Stupid Wiki Wiki ==
 
 GeekiGeeki is a minimalistic wiki with a [[http://git.or.cz/ | Git]]
-backend, a high features/complexity ratio and a very clean syntax.
+backend, an unusually high features/complexity ratio and a clean wiki syntax.
 Check the EditingTips page for an idea the supported markup.
 
-GeekiGeeki is FreeSoftware, written in Python.  For all your geeky
-wiki needs, GeekiGeeki is **the** stupid choice you can't avoid making!
+<div style="font-size: large; color: red;  text-align: center">
+**The** stupid choice for your geeky wiki needs!
+</div>
+
+Tags: [[tags/fast|fast]] [[tags/stupid|stupid]] [[tags/!bloated|!bloated]] [[tags/h4x0r|h4x0r]] [[tags/cheapasincheapbeer|cheapasincheapbeer]]
 
-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
- * Git versioned storage backend
- * Interfaces with Gitweb for history browsing, RSS...
+ * Rich, clean markup syntax, highly compatible with [[WikiCreole]] and [[MoinMoin]]
+ * Versioned and distributed storage backend based on git
+ * Easy to interface with other storage back-ends through a glue script
+ * 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
+ * Blogging support
+ * Hierarchical namespace with automatic directory listing
+ * [[Picture gallery|pictures]] (poor man's Flick'r)
+ * Video playback (poor man's You Tube)
+ * User accounts supported through web server's HTTP basic auth
  * Per-page ACLs
- * Simple title and full text search
- * Easy CGI installation (no WSGI, mod_python, FCGI...)
+ * Title and full-text search with full regex power
+ * Easy drop-in installation (no WSGI, mod_python, FCGI...)
  * Fast!
- * Only 800 LOCs!
- * Derived from PikiWiki, like MoinMoin
- * FreeSoftware and OpenSource, to please everybody
- * GuruMeditation alerts :-)
+ * Small! Codebase is just 800 LOCs!
+ * Derived from [[PikiWiki]], like [[MoinMoin]]
+ * [[GuruMeditation]] alerts :-)
+
+== License ==
+
+GeekiGeeki is Gratis Software as in Gratuitous Speech, not Cheap as in Cheap Beer.
+Consult your lawyer before using to check whether this is compatible with your current
+brand of beer.
+
+Naa! GeekiGeeki is really distributed under the [[http://www.fsf.org/licensing/licenses/agpl-3.0.html|GNU Affero General Public License version 3]] or later.
 
 == 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 ||
+|| 01-May-2009 || [[http://src.codewiz.org/wikigit/geekigeeki.git?a=snapshot;h=v4.0|geekigeeki-4.0.tar.gz]] ||
+|| 11-Dec-2008 || [[http://src.codewiz.org/wikigit/geekigeeki.git?a=snapshot;h=v3.0|geekigeeki-3.0.tar.gz]] ||
+|| 23-Sep-2008 || [[http://src.codewiz.org/wikigit/geekigeeki.git?a=snapshot;h=v2.0|geekigeeki-2.0.tar.gz]] ||
 
 
 ==== Source ====
@@ -48,57 +59,29 @@ Tags: [[Tags/fast|fast]], [[Tags/stupid|stupid]], [[Tags/!bloated|!bloated]], [[
 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/
+git clone http://src.codewiz.org/~bernie/git/geekigeeki.git/
+git clone git://src.codewiz.org/~bernie/geekigeeki.git/
 }}}
 
 ===== Revision history =====
 
-Browse it online with GitWeb: http://www.codewiz.org/wikigit/geekigeeki.git
+Browse it with [[http://src.codewiz.org/wikigit/geekigeeki.git|GitWeb]]
 
 ===== 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 ==
+ * [[http://www.codewiz.org/wikigit/geekigeeki.git/blob_plain/HEAD:/geekigeeki.py        | geekigeeki.py      ]] -- The CGI itself
+ * [[http://www.codewiz.org/wikigit/geekigeeki.git/blob_plain/HEAD:/geekigeeki.conf.py.. | geekigeeki.conf.py ]] -- Sample site config
+ * [[http://www.codewiz.org/wikigit/geekigeeki.git/blob_plain/HEAD:/post_edit_hook.sh    | post_edit_hook.sh  ]] -- Some glue to integrate with git
+ * [[http://www.codewiz.org/wikigit/geekigeeki.git/blob_plain/HEAD:/wiki_apache.conf     | wiki_apache.conf   ]] -- Sample conf file for Apache
+ * [[sys/geekigeeki.css                                                                  | geekigeeki.css     ]] -- The stylesheet used at this site
 
-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}
-}}}
+== Installation and upgrade ==
 
-where '##{tree-ish}## could be a tag, a branch name, or a specific commit.
+See [[geeki/install]] for new installations, [[geeki/upgrade]] if you are already running a previous version of GeekiGeeki.
 
 == Contributing ==
 
-Please send your patches!  See the GeekiGeekiToDo list for ideas.
+Please send your patches!  See the [[geeki/TODO]] list for ideas.
 
 Bugfixes and cute hacks welcome.  BloatWare //will// be rejected: this is
 a minimalistic wiki, damn'it!