About this site
================

This site was designed with the help of `Sphinx
<http://sphinx-doc.org/>`_, originally *"a tool that makes it easy to
create intelligent and beautiful documentation, written by Georg
Brandl"*, and used here a bit beside its original meaning.

Sphinx makes use of `reStructuredText
<http://docutils.sf.net/rst.html>`_ as markup language.

The mathematical display is done with the help of `MathJax
<http://www.mathjax.org/>`_ with `LaTex
<http://www.latex-project.org/>`_ markups.

.. topic:: About the use of Sphinx and reStructuredText

   **Advantages** of `Sphinx <http://sphinx-doc.org/>`_ and
   `reStructuredText <http://docutils.sf.net/rst.html>`_ are

   * Consistent integration of python docstrings that can be extended
     by usefull formatting instructions
   * Reasonably good and easy document compilation
   * Integration of LaTex
   * Various output formats/media are possible (html, pdf, ...)

   **Disadvantages** are

   * A shallow learning curve 
   * Sometimes inconsistent usage is necessary to accomplish some
     needed html features

   **Clonclusion**: Good for programmers, not recommended for anybody else.

Programming is done with `Python <https://www.python.org>`_,
`Matplotlib <http://www.matplotlib.org>`_ and `Numpy
<http://www.numpy.org/>`_ .