[add] 'public_html/README.txt'

Rookbook.yaml

@@ -133,7 +133,7 @@ recipes:
 	end
 	rm_f "#{dir}/test/Rookbook.yaml", "#{dir}/test/test.log"
 	#
-	store 'public_html/{index.cgi,index.rhtml,_htaccess}', dir
+	store 'public_html/{index.cgi,index.rhtml,_htaccess,README.txt}', dir
 	#
 	store 'benchmark/{bench.rb,bench_context.yaml}',
 	      'benchmark/templates/*', 'benchmark/Makefile', dir

public_html/README.txt

@@ -0,0 +1,54 @@
+======
+README
+======
+
+This directory contains helper CGI script and files for Apache web server.
+Using these files, it is able to publish *.rhtml as *.html under Apache.
+
+* index.cgi   :  CGI script
+* _htaccess   :  .htaccess file for Apache
+* index.rhtml :  Example eRuby script
+
+
+Installation
+------------
+
+Steps to install:
+
+    ### install Erubis
+    $ tar xzf erubis-X.X.X.tar.gz
+    $ cd erubis-X.X.X/
+    $ ruby setup.py install
+    ### copy files to ~/public_html
+    $ mkdir -p ~/public_html
+    $ cp public_html/_htaccess   ~/public_html/.htaccess
+    $ cp public_html/index.cgi   ~/public_html/
+    $ cp public_html/index.rhtml ~/public_html/
+    ### add executable permission to index.cgi
+    $ chmod a+x ~/public_html/index.cgi
+    ### edit .htaccess
+    $ vi ~/public_html/.htaccess
+    ### (optional) edit index.cgi to configure
+    $ vi ~/public_html/index.cgi
+
+
+Edit ~/public_html/.htaccess and modify user name.
+
+~/public_html/.htaccess:
+
+    ## enable mod_rewrie
+    RewriteEngine on
+    ## deny access to *.rhtml and *.cache
+    #RewriteRule \.(rhtml|cache)$ - [R=404,L]
+    RewriteRule \.(rhtml|cache)$ - [F,L]
+    ## rewrite only if requested file is not found
+    RewriteCond %{SCRIPT_FILENAME} !-f
+    ## handle request to *.html and directories by index.cgi
+    RewriteRule (\.html|/|^)$ /~{{*username*}}/index.cgi
+    #RewriteRule (\.html|/|^)$ index.cgi
+
+
+After these steps, *.rhtml will be published as *.html.
+For example, if you access to http:host.domain/~username/index.html
+(or http://host.domain/~username/), file ~/public_html/index.rhtml
+will be displayed.