X-Git-Url: https://codewiz.org/gitweb?a=blobdiff_plain;f=GeekiGeeki;h=b33d8e49f79179f6ea62ac04fb173629c070330f;hb=6e17aca60e39da25b6baa0e4f88ed08f81a645a6;hp=c04b52d84c2f71693f176888a63ee0d72ad601bf;hpb=07ccf35434ab4a18be8a46d7908b48fa51eec561;p=wiki.git
diff --git a/GeekiGeeki b/GeekiGeeki
index c04b52d..b33d8e4 100644
--- a/GeekiGeeki
+++ b/GeekiGeeki
@@ -1,95 +1,85 @@
-
GerryStich.jpg
+== Geeki Geeki, the Stupid Stupid Wiki Wiki ==
-==== What is Geeki Geeki? ====
+{{GerryStich.png}}
-GeekiGeeki is a minimalistic wiki with a [[http://git.or.cz/ | git]] backend,
-a high features/complexity ratio and a clean syntax similar to WikiCreole.
-Check the EditingTips to get an idea the supported wiki syntax.
+GeekiGeeki is a minimalistic wiki with a [[http://git.or.cz/ | Git]]
+backend, an unusually high features/complexity ratio and a clean wiki syntax.
+Check the EditingTips page for an idea the supported markup.
-GeekiGeeki is a descendant of PikiWiki, like MoinMoin, and it is written
-in Python.
+
+The stupid choice for your geeky wiki needs!
+
== Features ==
- * Git versioned backend
- * Interfaces with Gitweb for history browsing, RSS...
+ * S^3: Simple, Small, Stupid
+ * 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
+ * [[pictures | 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!
- * GuruMeditation alerts :-)
+ * Small! Codebase is just 800 LOCs!
+ * Derived from [[PikiWiki]], like [[MoinMoin]]
+ * [[GuruMeditation]] alerts :-)
-==== Download ====
+== License ==
-==== 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 ||
+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.
-===== Source repository ====
+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.
-You can obtain the latest source snapshot through git:
+== Download ==
-{{{
-git clone http://www.codewiz.org/~bernie/git/geekigeeki.git/
-git clone git://www.codewiz.org/~bernie/geekigeeki.git/
-}}}
+==== Releases ====
-===== Revision history =====
+|| 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]] ||
-Browse it online with GitWeb: http://www.codewiz.org/wikigit/geekigeeki.git
-===== Individual source files =====
+==== Source ====
- * [[../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
+You can obtain the latest version -- actually ''any'' version -- through git:
-==== Installation ====
+{{{
+git clone http://src.codewiz.org/~bernie/git/geekigeeki.git/
+git clone git://src.codewiz.org/~bernie/geekigeeki.git/
+}}}
-The easiest way is:
+Browse the revision history in [[https://www.codewiz.org/gitweb/geekigeeki.git/|GitWeb]]
- * 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
+Individual source files:
-==== Update procedure ====
+ * [[http://src.codewiz.org/wikigit/geekigeeki.git/blob_plain/HEAD:/geekigeeki.py | geekigeeki.py ]] -- The CGI itself
+ * [[http://src.codewiz.org/wikigit/geekigeeki.git/blob_plain/HEAD:/geekigeeki.conf.py.. | geekigeeki.conf.py ]] -- Sample site config
+ * [[http://src.codewiz.org/wikigit/geekigeeki.git/blob_plain/HEAD:/post_edit_hook.sh | post_edit_hook.sh ]] -- Some glue to integrate with git
+ * [[http://src.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:
+Yes, that's the whole thing!
-{{{
-git pull
-}}}
-to switch to a different version of GeekiGeeki:
+== Installation and upgrade ==
-{{{
-git checkout {tree-ish}
-}}}
+See [[geeki/install]] for new installations, [[geeki/upgrade]] if you are already running a previous version of GeekiGeeki.
-==== Contributing ====
+== 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!