Edit page GeekiGeeki
[wiki.git] / GeekiGeeki
index 6c8cde1778f6f447bf09a321725f3653009d1c88..780c642cbcc8b669169cb540791d2fa82c3b92df 100644 (file)
@@ -3,54 +3,55 @@
 == 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 clean syntax.
+backend, an unusually high features/complexity ratio and a clean wiki 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!
+**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]] [[tags/cheapasincheapbeer|cheapasincheapbeer]]
 
 
 == 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...
+ * 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
- * Automatic [[Pictures]] and video 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 (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 ==
 
-Geeki Geeki is Gratis Software as in Gratuitous Speech, not Cheap as in Cheap Beer.
+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! 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.
+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 || **[[http://www.codewiz.org/wikigit/geekigeeki.git?a=snapshot;h=v3.0;sf=tbz2|v3.0]]** ||
-|| 23-Sep-2008 || **[[http://www.codewiz.org/wikigit/geekigeeki.git?a=snapshot;h=v2.0;sf=tbz2|v2.0]]** ||
+|| 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 ====
@@ -58,57 +59,29 @@ Naa! Geeki Geeki is really distributed under the [[http://www.fsf.org/licensing/
 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 with [[http://www.codewiz.org/wikigit/geekigeeki.git|GitWeb]]
+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
+ * [[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
 
-== Installation ==
+== Installation and upgrade ==
 
-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.
+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!