doc: better explain internationalization

The concise information in skeleton/locale/README.md is not helping me much. Can you provide a working example? I have a couple of questions:

1. how many languages can I set in config.json? One is working, but if I try to set an array with two values I get an error when I run cactus messages:make (TypeError: unhashable type: ‘list’):

   "locale"   : ["en", "fr"]
   

   The config file is meant to be one per website? I should use one config file for each different language?

2. How should the block look like? I tried this but no po file is generated:

   <p>{% trans %} Esempio di traduzione {% endtrans %}</p>
   

[good-lly]

When i run: cactus messages:make -c config.json -c en.json or cactus messages:make -c config.json -c it.json

it generates file directories e, n and i, t ---- somebody had a similar experience?

[m-thielen]

The ‘e’, ‘n’, ‘i’ ,‘t’ subdirectories are apparently due to a bug in Django 1.6.11, which is used by Cactus. I have not investigated this in depth, the bug might be in Cactus, too, but changing one line of code in Django did it for me. Unfortunately, cactus does not work with later Django versions.

Forget what I just wrote… the bug is in Cactus. Leave your Django installation alone. There is an easy workaround, though. In your project directory, just run

django-admin.py makemessages -l en

where ‘en’ is of course the locale you want to build a PO file for.