Commit 21997ff4 authored by Antoine Bernard's avatar Antoine Bernard

Création du README.md et v1 de la doc traduction.

parent ab6496ee
Configuration requise
--------------------
#### Paquets requis :
Sous Debian:
* gettext -> Pour la traduction
TODO
Comment enrichir la traduction
------------------------------
Pour commencer, il vous faut vous placer à la racine du répertoire,
c'est à dire à l'emplacement de ce README ou dans le sous-dossier note/.
En effet, l'utilitaire Django parcourt uniquement l'arborescence descendante.
Ensuite, deux méthodes s'offre à vous:
django-admin makemessages
ou
python manage.py makemessages
makemessages parcours les fichiers ( par défaut *.py, *.html, *.txt ) à la rehcherche
de
Dans les fichiers python
------------------------
Ajouter en import du fichier
from django.utils.translation import ugettext_lazy as _
Pour comprendre ce que fait cette fonction, et découvrir ses dérivés :
https://docs.djangoproject.com/fr/1.9/topics/i18n/translation/
Pour déclarer une chaine de texte ou une variable comme à traduire
Original À traduire
"ma chaine de texte" -> _(u"ma chaine de texte")
Lorsque que vous faites ceci, cela informe l'utilitaire Django que
Notez que vous pouvez aussi
Quand vous créer un nouveau template
------------------------------------
Pensez à ajouter la ligne suivante :
{% load i18n %}
Cela chargera les outils de traduction fourni par Django.
Pour des textes simples, vous pourrez utilisez le tag trans :
{% trans "Mon texte ici" %}
où "Mon texte ici" est le texte à traduire
Pour des textes plus compliqués :
{% blocktrans %}
Le texte,
sur plusieurs lignes.
{% endblocktrans %}
ou comprenant des variables :
{% blocktrans with newvar=ildvar %}
Mon nom est {{ newvar }}.
{% endblocktrans %}
Dans un fichier javascript
--------------------------
Do no do it. please.
srsly
Appliquer vos traductions
-------------------------
Un fois que vous traduit et complétez le django.po, il faut encore compilez le fichier.
Pour cela
django-admin compilemessages
Cette commande va créer un django.mo qui servira effctivement de traduction.
Comment ajouter une nouvelle langue à traduire
----------------------------------------------
D'abord, dans le settings.py, il vous faut rajouter la langue voulue au dictionnaire LANGUAGES
LANGUAGES = [
('fr', _(u"Français")),
('en', _(u"Anglais")),
]
Par exemple, si l'on souhaite rajouter le portugais :
LANGUAGES = [
('fr', _(u"Français")),
('en', _(u"Anglais")),
('pt', _(u"Portugais")),
]
Il faut maintenant créer le fichier dans lequel seront stockés
les traductions dans la nouvelle langue.
Pour ceci, lancer la commance suivante :
django-admin makemessages --locale=code_langue
Par exemple, pour du portugais brésilien :
django-admin makemessages --locale=pt_BR
Django devrait créer l'arborescence et le fichier django.po nécéssaire
dans le dossier locale/
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment