From d58959b834a9cfb2c2e4e14ba97ff8ba625125fd Mon Sep 17 00:00:00 2001
From: Scott Wallace <scott@wallace.sh>
Date: Tue, 25 Jun 2013 18:49:33 +0200
Subject: [PATCH] Update README.md

Used Markdown to make the instructions more readable.
---
 apache/README.md | 59 ++++++++++++++++++++++++++++++++++--------------
 1 file changed, 42 insertions(+), 17 deletions(-)

diff --git a/apache/README.md b/apache/README.md
index bd94bc9..9bdac1a 100644
--- a/apache/README.md
+++ b/apache/README.md
@@ -1,43 +1,68 @@
 # Compilation
+
 1. Ensure the SQLite development libraries (sqlite-devel) are installed.
 2. Either run the `build_from_scratch.sh` script or run the following commands:
-    1. `libtoolize`
-    2. `aclocal`
-    3. `autoconf`
-    4. `automake -a`
-    5. `./configure --with-apache=<Apache location>`
-    6. `make CFLAGS=-lsqlite3`
+
+    ```Shell
+    libtoolize
+    aclocal
+    autoconf
+    automake -a
+    ./configure --with-apache=<Apache location>
+    make CFLAGS=-lsqlite3
+    ```
 
 # Installation
+
 1. Activate in Apache using:
     * (automatic) Using APXS:
-        ```
+
+        ```Shell
         apxs -i -a -n blockinator libmodblockinator.la
         ```
-      _*or*_
+
+    _*or*_
     * (manual) Add the following commands to the Apache configuration:
-        ```
+
+        ```ApacheConf        
         LoadModule blockinator_module modules/libmodblockinator.so
         ```
-2. Configure mod\_blockinator by adding the following lines in the appropriate location(s):
+
+2. Configure mod_blockinator by adding the following lines in the appropriate location(s):
     1. Define where the blocklist DB can be found:
-        ```
+
+        ```ApacheConf
         <IfModule blockinator_module>
             BlockinatorBlocklistDB    /path/to/blocklist.db
         </IfModule>
         ```
-    2. Create a mod\_rewrite rule to block requests, if matched:
-        ```
+
+    2. Create a mod_rewrite rule to block requests, if matched:
+
+        ```ApacheConf
         RewriteCond %{HTTP:X-Block}	1
         RewriteRule .			-  [R=403,L]
         ```
+
 3. Create the SQLite DB:
-    1. `sqlite3 /path/to/blocklist.db`
-    2. Run the following SQL:
+    1. Start SQLite3 on a new file:
+
+        ```Shell
+        sqlite3 /path/to/blocklist.db
         ```
+
+    2. Run the following SQL:
+
+        ```SQL
         CREATE TABLE IF NOT EXISTS blocklist(remote_ip VARCHAR(15), forwarded_ip VARCHAR(15), useragent VARCHAR(256), cookie VARCHAR(1024), PRIMARY KEY(remote_ip));
         ```
+
     3. (optional) Insert some test data:
-        Block requests from IP address 1.2.3.4
-        e.g. ```INSERT INTO blocklist VALUES("1.2.3.4", "ANY", "ANY", "ANY");```
+
+        e.g. Block requests from IP address 1.2.3.4
+
+        ```SQL
+        INSERT INTO blocklist VALUES("1.2.3.4", "ANY", "ANY", "ANY");
+        ```
+
 4. Restart Apache