Sur cette page

• Traduction de texte
  • Exemples
• Fichiers de traduction
• Localisation de la date

Localisation

Cecil prend en charge traduction du texte et localisation de la date.

Traduction de texte

Utilise le trans tag ou filter pour traduire des textes dans des templates.

{% trans with variables into locale %}{% endtrans %}

{{ message|trans(variables = []) }}

Exemples

{% trans %}Hello World!{% endtrans %}

{{ message|trans }}

Inclure des variables :

{% trans with {'%name%': 'Arnaud'} %}Hello %name%!{% endtrans %}

{{ message|trans({'%name%': 'Arnaud'}) }}

Forcer les paramètres régionaux :

{% trans into 'fr_FR' %}Hello World!{% endtrans %}

Pluraliser :

{% trans with {'%count%': 42}%}{0}I don't have apples|{1}I have one apple|]1,Inf[I have %count% apples{% endtrans %}

Fichiers de traduction

Les fichiers de traduction doivent être nommés messages.<locale>.<extension> et stockés dans le répertoire translations. Les extensions prises en charge sont définies pour chaque format de traduction dans layouts.translations.formats.

Le code locale (ex. : fr_FR) d'une langue est défini dans les entrées languages de la configuration.

Exemple:

<mywebsite>
└─ translations
   ├─ messages.fr_FR.mo   <- Machine Object format
   └─ messages.fr_FR.yaml <- Yaml format

Localisation de la date

Utilise le filtre Twig format_date pour localiser une date dans les templates.

{{ page.date|format_date('long') }}
{# September 30, 2022 #}

Les valeurs prises en charge sont : short, medium, long et full.