Added installation instructions to README.
authorAaron Taylor <ataylor@subgeniuskitty.com>
Thu, 4 Jan 2018 07:29:19 +0000 (23:29 -0800)
committerAaron Taylor <ataylor@subgeniuskitty.com>
Thu, 4 Jan 2018 07:29:19 +0000 (23:29 -0800)
README.md

index 088090a..0a9853a 100644 (file)
--- a/README.md
+++ b/README.md
@@ -12,8 +12,69 @@ Status
 
 CMless is not yet functional. The stages required to reach basic functionality are:
 
 
 CMless is not yet functional. The stages required to reach basic functionality are:
 
-1. Figure out deployment scheme
+1. ~~Figure out deployment scheme~~
 2. Interpret URL and locate/serve appropriate page
 3. Feed pages through a document processor
 4. Feed pages through a template engine
 5. Generate menu based on directory structure
 2. Interpret URL and locate/serve appropriate page
 3. Feed pages through a document processor
 4. Feed pages through a template engine
 5. Generate menu based on directory structure
+
+Installation Example - Debian Linux
+-----------------------------------
+
+Enable CGI scripts:
+
+```
+a2enmod cgi
+```
+
+Create and enable an Apache vhost.
+
+```
+vi /etc/apache2/sites-available/cmless.subgeniuskitty.com
+```
+
+```
+<VirtualHost *:80>
+        DocumentRoot "/mnt/data/apache_vhosts/cmless.subgeniuskitty.com"
+        ServerName cmless.subgeniuskitty.com
+        ServerAdmin webmaster@subgeniuskitty.com
+        ErrorLog /var/log/apache2/error_log.cmless.subgeniuskitty.com
+        CustomLog /var/log/apache2/access_log.cmless.subgeniuskitty.com combined
+        AddHandler cgi-script .py
+        <Directory "/mnt/data/apache_vhosts/cmless.subgeniuskitty.com">
+                Options -ExecCGI -Indexes
+                AllowOverride None
+                Order allow,deny
+                Allow from all
+        </Directory>
+        <Directory "/mnt/data/apache_vhosts/cmless.subgeniuskitty.com/bin">
+                Options ExecCGI
+                AllowOverride None
+                Order allow,deny
+                Allow from all
+        </Directory>
+        RewriteEngine On
+        RewriteRule (.*) /mnt/data/apache_vhosts/cmless.subgeniuskitty.com/site/$1
+        RewriteRule .* /mnt/data/apache_vhosts/cmless.subgeniuskitty.com/bin/cmless.py
+</VirtualHost>
+```
+
+```
+a2ensite cmless.subgeniuskitty.com
+service apache2 reload
+```
+
+Clone the CMless git repository into the Apache vhost directory.
+
+```
+cd /mnt/data/apache_vhosts
+git clone https://github.com/subgeniuskitty/cmless.git cmless.subgeniuskitty.com
+chown -R www-data:www-data ./cmless.subgeniuskitty.com
+```
+
+Clone your content into the site/ folder.
+
+```
+cd /mnt/data/apache_vhosts/cmless.subgeniuskitty.com
+git clone your_site_content_repo site
+```