[doc] Add new installation section

doc/baselines.rst

@@ -11,38 +11,6 @@ The first thing you might want to do is to execute one of the vein
 recognition algorithms that are implemented in ``bob.bio.vein``.
 
 
-Setting up Databases
---------------------
-
-In order to run vein recognition algorithms using this package, you'll need to
-make sure to download the raw files corresponding to the databases you'd like
-to process. The raw files are not distributed with Bob_ software as biometric
-data is, to most countries, considered sensible data that cannot be obtained
-without explicit licensing from a data controller. You must visit the websites
-below, sign the license agreements and then download the data before trying out
-to run the baselines.
-
-.. note::
-
-   If you're at the Idiap Research Institute in Switzlerand, the datasets in
-   the baselines mentioned in this guide are already downloaded and
-   pre-installed on our shared file system. You don't need to re-download
-   databases or create a ``~/.bob_bio_databases.txt`` file.
-
-
-The current system readily supports the following freely available datasets:
-
-* ``vera``: `Vera Fingervein`_
-* ``utfvp``: `UTFVP`_
-* ``put``: `PUT`_ Vein Dataset
-
-
-After downloading the databases, annotate the base directories in which they
-are installed. Then, follow the instructions in
-:ref:`bob.bio.base.installation` to let this framework know where databases are
-located on your system.
-
-
 Running Baseline Experiments
 ----------------------------
 
@@ -221,6 +189,7 @@ Wide Line Detector           None                                10.4
 
 WLD + HEQ (preproc) @ Vera/Full = 10.9%
 
+
 Available Resources
 -------------------
 

doc/index.rst

@@ -21,6 +21,7 @@ Users Guide
 .. toctree::
    :maxdepth: 2
 
+   installation
    baselines
    references
    api

doc/installation.rst

+.. vim: set fileencoding=utf-8 :
+.. Fri 19 Aug 2016 15:03:52 CEST
+
+
+==============
+ Installation
+==============
+
+The installation of this package is divided in 2-parts. Installation of the
+package and its software dependencies and the installation of databases.
+
+
+Package Installation
+--------------------
+
+To install this package, first follow our `installation`_ instructions. Then,
+using the Python interpreter provided by the distribution, bootstrap and
+buildout this package:
+
+
+.. code-block:: sh
+
+  $ python bootstrap-buildout.py
+  $ ./bin/buildout
+
+
+Sphinx Documentation Building
+-----------------------------
+
+Once the package is installed, you may re-build this documentation locally by
+running:
+
+.. code-block:: sh
+
+  $ ./bin/sphinx-build doc html
+
+The resulting HTML documentation will be output inside the directory `html`.
+
+
+Setting up Databases
+--------------------
+
+In order to run vein recognition algorithms using this package, you'll need to
+make sure to download the raw files corresponding to the databases you'd like
+to process. The raw files are not distributed with Bob_ software as biometric
+data is, to most countries, considered sensible data that cannot be obtained
+without explicit licensing from a data controller. You must visit the websites
+below, sign the license agreements and then download the data before trying out
+to run the baselines.
+
+.. note::
+
+   If you're at the Idiap Research Institute in Switzlerand, the datasets in
+   the baselines mentioned in this guide are already downloaded and
+   pre-installed on our shared file system. You don't need to re-download
+   databases or create a ``~/.bob_bio_databases.txt`` file.
+
+
+The current system readily supports the following freely available datasets:
+
+* ``vera``: `Vera Fingervein`_
+* ``utfvp``: `UTFVP`_
+* ``put``: `PUT`_ Vein Dataset
+
+
+After downloading the databases, annotate the base directories in which they
+are installed. Then, follow the instructions in
+:ref:`bob.bio.base.installation` to let this framework know where databases are
+located on your system.
+
+
+Development
+-----------
+
+If you're developing this package, you may automatically clone all necessary
+Bob_ repositories on your local package installation. This allows you to build
+against an environment which contains all of our dependencies_, but no
+previously installed Bob_ packages. To do so, use the buildout recipe in
+``develop.cfg`` just after bootstraping:
+
+.. code-block:: sh
+
+  $ python bootstrap-buildout.py
+  $ ./bin/buildout -c develop.cfg
+
+
+Database SQL support files
+==========================
+
+If you installed all packages from scratch like above, you'll need to download
+the SQL support files of some of the database front-ends available in this
+package. This operation can be easily done like this:
+
+.. code-block:: sh
+
+  $ ./bin/bob_dbmanage.py all download
+
+
+.. include:: links.rst

doc/links.rst

@@ -22,3 +22,7 @@
 .. _vera palmvein: https://www.idiap.ch/dataset/vera-palmvein
 .. _utfvp: http://scs.ewi.utwente.nl/downloads/show,Finger%20Vein/
 .. _put: http://biometrics.put.poznan.pl/vein-dataset/
+.. _installation: https://gitlab.idiap.ch/bob/bob/wikis/Installation
+.. _dependencies: https://gitlab.idiap.ch/bob/bob/wikis/Dependencies
+.. _mailing list: https://groups.google.com/forum/?fromgroups#!forum/bob-devel
+.. _bob.bio.base: https://pythonhosted.org/bob.bio.base/