update docs

.gitignore

@@ -20,7 +20,7 @@ MANIFEST
 # Sphinx
 docs/api
 docs/_build
-
+site/
 # Eclipse editor project files
 .project
 .pydevproject

README.rst

@@ -42,6 +42,34 @@ The license section from the README file of the `SZpack.v1.1.1` tarball:
     //==================================================================================================
 
 
+Installation
+------------
+
+The SZpack depends on the
+`GNU Scientific Library <https://www.gnu.org/software/gsl/>`_ (GSL), which has
+to be installed and made available in the environment.
+
+The low level python interface comes along with SZPack also depends on
+`SWIG <http://www.swig.org/index.php>`_. Please refer to the documentation
+for how to install.
+
+To install ``szpack_wrapper``,
+
+.. code:: text
+
+    $ gsl-config --version  # check that GSL is installed
+    2.6
+    $ which swig  # check that swig is installed
+    /usr/local/bin/swig
+    $ pip install szpack_wrapper
+
+Behind the scene, the ``SZpack`` v1.1.1 is bundled with this package in the
+``szpack_wrapper/extern`` folder, and an accompanying ``setup_package.py`` file
+is used to leverage the
+`extension-helpers <https://extension-helpers.readthedocs.io/en/latest/>`_
+to build the code as a C extension.
+
+
 SZpackWrapper License
 ---------------------
 

mkdocs.yml

@@ -0,0 +1,2 @@
+site_name: szpack_wrapper
+docs_dir: docs/_build/html

setup.cfg

@@ -26,6 +26,7 @@ test =
     pytest-astropy
 docs =
     sphinx-astropy
+    mkdocs
 
 [options.package_data]
 szpack_wrapper = data/*

tox.ini

@@ -73,6 +73,23 @@ commands =
     pip freeze
     sphinx-build -W -b html . _build/html
 
+[testenv:docs]
+depends = build_docs
+description = invoke mkdocs to serve the docs
+extras = {[testenv:build_docs]extras}
+changedir = {toxinidir}
+commands =
+    mkdocs build --clean
+    python -c 'print("###### Starting local server. Press Control+C to stop server ######")'
+    mkdocs serve -a localhost:8888
+
+[testenv:docs-deploy]
+depends = {[testenv:docs]depends}
+description = invoke mkdocs to deploy the docs
+extras = {[testenv:build_docs]extras}
+changedir = {[testenv:docs]changedir}
+commands = mkdocs gh-deploy --clean
+
 [testenv:linkcheck]
 changedir = docs
 description = check the links in the HTML docs