README - wigit in WiGit

***************************
* WiGit: A Git-based Wiki *
***************************

About
-----
WiGit is a simple Wiki written in PHP, using Git (http://git.or.cz/) as 
a backend for tracking changes. Besides Git, this wiki makes use of Textile
(http://textile.thresholdstate.com/) for marking up text. 


Features
--------
* Very simple and light
* Easily customizable using themes
* Extensive syntax for marking up text (using Textile)
* Full history tracking support
* Basic support for users/authors, by using the HTTP authentication headers 
  to extract the user.
* Support for pretty URLs (using URL rewriting)


Requirements
------------
* Webserver
* PHP4
* Git


Installation
------------
* Put the WiGit dir in some place where the webserver can find it
* Make sure there's a 'data' subdir, and that it is writable by the webserver
* Copy config.php.sample to config.php, and edit config.php to reflect your 
  local settings
* Surf to the wigit URL, and you should start by editing the front page

For URL rewriting, change the SCRIPT_URL to be the base URL prefix (as 
is shown in the config file), and add the necessary URL rewrite rules for
your webserver. E.g.,
* For Apache, add the following to .htaccess in your wigit install dir:
		<IfModule mod_rewrite.c>
			RewriteEngine On
			RewriteBase /wigit/
			RewriteCond %{REQUEST_FILENAME} !-f
			RewriteRule (.*) /wigit/index.php?r=$1 [L] 
		</IfModule>
* For lighttpd, add the following to your config file:
    url.rewrite-once = (
        "^/wigit/themes/(.*)" => "$0",
        "^/wigit(.*)" => "/wigit/index.php?r=$1",
      )
(where /wigit is replaced by your own base url)

For user support, configure your webserver to require authentication for
the wigit install dir. E.g.
* For Apache, add the following to .htaccess in your wigit install dir:
		AuthType Basic
		AuthName "My WiGit"
		AuthUserFile /path/to/passwords/file
		Require valid-user
* For lighttpd, add the following to your config file:
		auth.backend = "htdigest"
		auth.backend.htdigest.userfile = "/path/to/htdigest/file"
		auth.require = (
		      "/wigit" => (
							"method" => "digest",
							"realm" => "My WiGit",
							"require" => "valid-user",
						)
				)


Contact
-------
More information can be found on http://el-tramo.be/software/wigit
Bugs and/or feature requests can be sent to me. For contact information,
see http://el-tramo.be/about.

1	***************************
2	* WiGit: A Git-based Wiki *
3	***************************
4
5	About
6	-----
7	WiGit is a simple Wiki written in PHP, using Git (http://git.or.cz/) as
8	a backend for tracking changes. Besides Git, this wiki makes use of Textile
9	(http://textile.thresholdstate.com/) for marking up text.
10
11
12	Features
13	--------
14	* Very simple and light
15	* Easily customizable using themes
16	* Extensive syntax for marking up text (using Textile)
17	* Full history tracking support
18	* Basic support for users/authors, by using the HTTP authentication headers
19	to extract the user.
20	* Support for pretty URLs (using URL rewriting)
21
22
23	Requirements
24	------------
25	* Webserver
26	* PHP4
27	* Git
28
29
30	Installation
31	------------
32	* Put the WiGit dir in some place where the webserver can find it
33	* Make sure there's a 'data' subdir, and that it is writable by the webserver
34	* Copy config.php.sample to config.php, and edit config.php to reflect your
35	local settings
36	* Surf to the wigit URL, and you should start by editing the front page
37
38	For URL rewriting, change the SCRIPT_URL to be the base URL prefix (as
39	is shown in the config file), and add the necessary URL rewrite rules for
40	your webserver. E.g.,
41	* For Apache, add the following to .htaccess in your wigit install dir:
42	<IfModule mod_rewrite.c>
43	RewriteEngine On
44	RewriteBase /wigit/
45	RewriteCond %{REQUEST_FILENAME} !-f
46	RewriteRule (.*) /wigit/index.php?r=$1 [L]
47	</IfModule>
48	* For lighttpd, add the following to your config file:
49	url.rewrite-once = (
50	"^/wigit/themes/(.*)" => "$0",
51	"^/wigit(.*)" => "/wigit/index.php?r=$1",
52	)
53	(where /wigit is replaced by your own base url)
54
55	For user support, configure your webserver to require authentication for
56	the wigit install dir. E.g.
57	* For Apache, add the following to .htaccess in your wigit install dir:
58	AuthType Basic
59	AuthName "My WiGit"
60	AuthUserFile /path/to/passwords/file
61	Require valid-user
62	* For lighttpd, add the following to your config file:
63	auth.backend = "htdigest"
64	auth.backend.htdigest.userfile = "/path/to/htdigest/file"
65	auth.require = (
66	"/wigit" => (
67	"method" => "digest",
68	"realm" => "My WiGit",
69	"require" => "valid-user",
70	)
71	)
72
73
74	Contact
75	-------
76	More information can be found on http://el-tramo.be/software/wigit
77	Bugs and/or feature requests can be sent to me. For contact information,
78	see http://el-tramo.be/about.

Gitorious