Reorganizing installation instructions

Reorganizing installation instructions + better Markdown formatting of commands (copy&paste wouldn't work)

README.md

@@ -1,36 +1,41 @@
 # XPUB Library
 Library running on Flask and SQLight (maybe to be replaced with a python shelve)
 
-requirements.txt
+## Installation
+
+Install the required dependencies:
+
     $ pip3 install -r requirements.txt
 
-install rqlite
-install pyrqlite
-install sqlalchemy-rqlite
 
-initialize rqlite database
+Initialise database
-$ ./rqlited ~.node
 
-initialise database
     $ bash init_db.sh
 
-run script 
-python3 run.py
 
+### Install rqlite
 
-## API 
+#### Linux
+To download and start rqlite on Linux, execute the following in a shell.
 
-has currently 2 entrypoints:
+    curl -L https://github.com/rqlite/rqlite/releases/download/v4.3.0/rqlite-v4.3.0-linux-amd64.tar.gz -o rqlite-v4.3.0-linux-amd64.tar.gz
+    tar xvfz rqlite-v4.3.0-linux-amd64.tar.gz
+    cd rqlite-v4.3.0-linux-amd64
+    ./rqlited ~/node.1
 
-/api/books
-GETs all the books in the database
 
-/api/book/id
+#### OSX
-GETs a specific book by its id
+To download and start rqlite on OSX, execute the following in a shell.
+
+curl -L https://github.com/rqlite/rqlite/releases/download/v4.3.0/rqlite-v4.3.0-darwin-amd64.tar.gz -o rqlite-v4.3.0-darwin-amd64.tar.gz
+tar xvfz rqlite-v4.3.0-darwin-amd64.tar.gz
+cd rqlite-v4.3.0-darwin-amd64
+./rqlited ~/node.1
+
 
 
-## Installation
+
-Further installnotes (bugs)
+### Further install notes (bugs)
 
 * create the covers folder inside the uploadsfolder
 * don't forget to chmod the uploads and coverfolder ;-)
@@ -39,39 +44,38 @@ Further installnotes (bugs)
 
 For those on mac and using homebrew, it seems like Wand doesn't support imagemagick 7 yet as mentioned in other answers.
 There's a new brew formula for Imagemagick 6 which can be used to install the older version in the meanwhile:
-brew install imagemagick@6
+`brew install imagemagick@6`
+
 Create a symlink to this newly installed dylib file as mentioned in other answer to get things working.
+
     ln -s /usr/local/Cellar/imagemagick@6/<your specific 6 version>/lib/libMagickWand-6.Q16.dylib /usr/local/lib/libMagickWand.dylib
 
 
-## install rqlite
 
-### Linux
-To download and start rqlite on Linux, execute the following in a shell.
 
-curl -L https://github.com/rqlite/rqlite/releases/download/v4.3.0/rqlite-v4.3.0-linux-amd64.tar.gz -o rqlite-v4.3.0-linux-amd64.tar.gz
-tar xvfz rqlite-v4.3.0-linux-amd64.tar.gz
-cd rqlite-v4.3.0-linux-amd64
-./rqlited ~/node.1
 
-### OSX
-To download and start rqlite on OSX, execute the following in a shell.
 
-curl -L https://github.com/rqlite/rqlite/releases/download/v4.3.0/rqlite-v4.3.0-darwin-amd64.tar.gz -o rqlite-v4.3.0-darwin-amd64.tar.gz
+## Run the program
-tar xvfz rqlite-v4.3.0-darwin-amd64.tar.gz
-cd rqlite-v4.3.0-darwin-amd64
-./rqlited ~/node.1
 
+Initialize rqlite database on one terminal (from rqlite install directory)
+
+    $ ./rqlited ~.node
+
+Run the script in another terminal (from XPPL directory): 
+
+    python3 run.py
 
-## install pyrqlite
 
-git clone https://github.com/rqlite/pyrqlite.git
-pip install ./pyrqlite
 
 
-## install sqlalchemy-rqlite
 
-git clone https://github.com/rqlite/sqlalchemy-rqlite.git 
+## API 
-cd sqlalchemy-rqlite
+
-sudo python3 ./setup.py install
+Has currently 2 entrypoints:
+
+`/api/books`
+GETs all the books in the database
+
+`/api/book/id`
+GETs a specific book by its id