The development setup
=====================

Obtain a copy of the source code
--------------------------------
Just clone our git repository including its submodules::

    git clone --recursive https://github.com/tixl/tixl.git 
    cd tixl/

Dependencies
------------
* Python 3.4 or newer
* ``pip`` for Python 3
* ``git``
* ``lessc`` (Debian package: ``node-less``)

Your local python environment
-----------------------------

Please execute ``python -V`` or ``python3 -V`` to make sure you have Python 3.4 installed. Also make sure you have pip for Python 3 installed, you can execute ``pip3 -V`` to check. Then use Python 3.4's internal tools to create a virtual environment and activate it for your current session::

    pyvenv env
    source env/bin/activate

You should now see a ``(env)`` prepended to your shell prompt.

Working with the code
---------------------
The first thing you need are all the main application's dependencies::

    cd src/
    pip install -r requirements.txt

Then, create the local database::

    python manage.py syncdb

Create the translation files
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
To generate updated translation files, run a::

    make localegen

To compile the language files for use, run::

    make localecompile

Run the development server
^^^^^^^^^^^^^^^^^^^^^^^^^^
Execute::

    python manage.py runserver

to start a local development webserver on port 8000.

Static code checks
^^^^^^^^^^^^^^^^^^
Before you check in your code into git, always run::

    flake8 .

to check for syntax, style and other errors.

Working with the documentation
------------------------------
First, you should install the requiremente necessary for building the documentation. Make sure you have your virtual python enviroment activated (see above). Then, install the packages by executing::

    cd doc/
    pip install -r requirements.txt

To build the documentation, run the following command from the ``doc/`` directory::

    make html

You will now find the generated documentation in the ``doc/_build/html/`` subdirectory.