.. _guide_project:

Creating a new `Chrysalio` Project  with `CioWarehouse2` Module
===============================================================

Creation
--------

To create a new Web site based on `Chrysalio` with `CioWarehouse2` module, you
simply type the following command and answer the questions:

.. code-block:: bash

    (virtualenv3)$ pip install cookiecutter
    (virtualenv3)$ cookiecutter http://cookiecutter.chrysal.io/cookiecutter-ciowarehouse2-project.zip

Then, you have to install it in your Python virtual environment:

.. code-block:: bash

    (virtualenv3)$ pip install -e .

Or, in development mode:

.. code-block:: bash

    (virtualenv3)$ pip install -e ".[development]"

Now, you can run your instance and visit it (http://localhost:6544):

.. code-block:: bash

    (virtualenv3)$ <prefix>populate development.ini && pserve development.ini


Localization
------------

To generate the localization files, first of all, you create your favorite
languages with:

.. code-block:: bash

    (virtualenv3)$ ./i18n.sh fr
    (virtualenv3)$ ./i18n.sh es

Then, you add your new languages to the list of available languages in the
option ``languages`` in your INI files (``development.ini``…).

All that's left is to generate the PO files, translate them and generate the MO
files:

.. code-block:: bash

    (virtualenv3)$ ./i18n.sh

Translate your freshly generate PO files and run again:

.. code-block:: bash

    (virtualenv3)$ ./i18n.sh