Some considerations for translating uMap

README.rst

@@ -78,3 +78,31 @@ Go to the admin (http://localhost:8000/admin/) and add:
 
 - almost one licence
 - almost one tilelayer
+
+Translating
+-----------
+
+For translating uMap in a new language, three repositories must be taken into account:
+
+- this current one
+- `Leaflet.Storage <https://github.com/yohanboniface/Leaflet.Storage>`_
+- `django-leaflet-storage <https://github.com/yohanboniface/django-leaflet-storage>`_
+
+**If you are not comfortable with python and/or git, you can fill an issue for me to
+create the needed files.**
+
+For this repository and django-leaflet-storage, here are the steps:
+
+1. got the root of the python module (for example `umap/umap` in this case)
+1. run `django-admin.py makemessages -l fr` using your language code instead of `fr`
+1. translate what's needed in the ad hoc file in the `locale` repository (for example
+   `umap/umap/locale/fr/LC_MESSAGES/django.po`)
+1. from the root of the python module, run `django-admin.py compilemessages`
+1. commit, push, PR :)
+
+For Leaflet.Storage, here are the steps:
+
+- add your language in 'bin/i18n.js'
+- run `node bin/i18n.js"
+- update the dedicated file in the `src/locale` repository
+- commit, push, PR :)