From c71bd3a81dbae6f31f4ff225d461dad4a8e496c6 Mon Sep 17 00:00:00 2001
From: Luqman Aden <laden@uwaterloo.ca>
Date: Thu, 23 Feb 2012 01:46:22 -0500
Subject: [PATCH] Added readme. .htaccess and config.d are also now ignored in
 git instead samples are provided to be copied over and modified.

---
 .gitignore                        |  2 ++
 .htaccess                         |  4 ---
 README.md                         | 53 +++++++++++++++++++++++++++++++
 htaccess-sample                   |  4 +++
 src/{config.d => config.d.sample} |  2 +-
 5 files changed, 60 insertions(+), 5 deletions(-)
 delete mode 100644 .htaccess
 create mode 100644 README.md
 create mode 100644 htaccess-sample
 rename src/{config.d => config.d.sample} (89%)

diff --git a/.gitignore b/.gitignore
index cebac2a..7087134 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,5 @@
 pub/*
 srv/*
 bin/web
+.htaccess
+src/config.d
diff --git a/.htaccess b/.htaccess
deleted file mode 100644
index 0039b2c..0000000
--- a/.htaccess
+++ /dev/null
@@ -1,4 +0,0 @@
-RewriteEngine on
-RewriteBase /~j3parker/
-RewriteRule ^pub/(.*) - [L]
-RewriteRule ^(.*) /users/j3parker/www/bin/web [L]
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bd0dab3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,53 @@
+dweb - A simple website written in D
+=====
+dweb is a simple website framework based off the [werc][werc] software.
+
+Its principles are:
+
+- Database free, uses files and directories instead.
+- Written using the D programming language.
+- Minimize tedious work: eg., no need to ever write HTML, use markdown instead.
+- Very minimalist yet extensible codebase. Handlers for special things should be easy to add.
+
+It was created because werc was annoying to deploy on UW Computer Science Club's Apache setup and because [Not Invented Here](http://en.wikipedia.org/wiki/Not_Invented_Here).
+
+[werc]:http://werc.cat-v.org/
+[md]:http://daringfireball.net/projects/markdown
+
+Install Guide
+------
+You will need:
+- An HTTP server with CGI support.
+- The D compiler.
+
+Extract the contents into the location you want to serve webpages from. Create <code>$DWEB\_ROOT/.htaccess</code> and <code>$DWEB\_ROOT/src/config.d</code> by copying the provided sample files. Then edit the following files:
+
+- <code>$DWEB_ROOT/.htaccess</code>: make the paths work for your setup.
+- <code>$DWEB_ROOT/src/config.d</code>: change these strings as necessary.
+- <code>$DWEB_ROOT/src/web.d</code>: this is the main web code.
+- <code>$DWEB_ROOT/pub/</code>: static content goes here.
+- <code>$DWEB_ROOT/srv/</code>: directories, markdown webpages etc. go in here.
+- <code>$DWEB_ROOT/bin/</code>: custom handlers go here.
+
+Run <code>build</code> in <code>$DWEB_ROOT/src</code> to recompile the website software.
+
+Source
+--------
+
+You can get the source code on [github](https://github.com/j3parker/dweb) or by running
+
+     git clone git://github.com/j3parker/dweb.git
+
+Contact
+--------
+For questions, suggestions, bug reports and contributing patches email [j3parker](mailto:j3parker@csclub.uwaterloo.ca)
+
+License
+-------
+Public domain.
+
+Credits
+-------
+The idea and css stolen from [werc][werc]. This page itself also plagarised.
+
+Thanks to John Gruber for the [Markdown.pl][md] script.
diff --git a/htaccess-sample b/htaccess-sample
new file mode 100644
index 0000000..23c9137
--- /dev/null
+++ b/htaccess-sample
@@ -0,0 +1,4 @@
+RewriteEngine on
+RewriteBase /
+RewriteRule ^pub/(.*) - [L]
+RewriteRule ^(.*) bin/web [L]
diff --git a/src/config.d b/src/config.d.sample
similarity index 89%
rename from src/config.d
rename to src/config.d.sample
index b7f1171..2e12188 100644
--- a/src/config.d
+++ b/src/config.d.sample
@@ -1,4 +1,4 @@
-const string url_root = "/~j3parker/";
+const string url_root = "/";
 
 const string site_title = "This is a Title";
 const string site_subtitle = "but this is a subtitle";