Codage des caractères
MoinMoin utilise Unicode en interne et le codage utf-8 pour ses entrées et sorties externes, telles que les pages, les sorties HTML et les fichiers de traductions. Le jeu de caractère externe est défini à utf-8 dans config.charset. Cette valeur est adaptée à toutes les langues, car n'importe quel caractère peut être codé en utf-8. Bien que cela soit techniquement possible, vous ne devriez pas modifier cette valeur.
Important : pour utiliser des valeurs Unicode, vérifiez que la première ligne de votre fichier de paramétrage indique bien le codage utilisé par celui-ci. Et vérifiez que votre éditeur est correctement paramétré.
Les valeurs données à certaines options doivent être des valeurs Unicode. Par exemple, le nom du site pourrait contenir des trémas allemands, des accents français, être en chinois ou en hébreu. De ce fait, vous devez utilisez des chaînes de caractères Unicode pour ces paramètres. Les chaînes Unicode sont définies en ajoutant un préfixe u à la chaîne. Voici quelques exemples :
# Nom du site, utilisé par défaut en titre des pages [Unicode]
sitename = u"Wiki de Jérôme"
# ou encore :
sitename = u'私のウィき'Reportez-vous aux commentaires du fichier de paramétrage, qui vous indiqueront quelles sont les options nécessitant des valeurs Unicode.
Notes :
Il n'est pas possible de mélanger plusieurs codages dans le même fichier. Si votre ligne de codage indique iso-8859-1, tous les caractères du fichier de paramétrage devront respecter ce codage.
Si vous utilisez le codage UTF-8 (ou de l'ASCII pur), il n'est pas nécessaire d'utiliser des chaînes Unicode, MoinMoin décodera correctement vos chaînes.
Paramétrage international
Le fichier de paramétrage par défaut livré avec MoinMoin utilise le codage iso-8859-1. C'est très bien pour des langues utilisant des caractères latins, comme l'anglais, le français ou l'allemand, mais ce n'est pas utilisable pour les autres langues. Si vous voulez pouvoir utiliser des caractères non latins dans vos paramètres, votre fichier de paramétrage devra utiliser le codage UTF-8.
Pour ce faire, utilisez la ligne suivante comme première ligne de tous vos fichiers de paramétrage :
# -*- coding: utf-8 -*-
![/!\](/moin_static/capitoul-theme/img/alert.png "/!\")
Vous aurez besoin d'un éditeur de textes capable d'utiliser (et utilisant vraiment) le codage UTF-8 pour éditer les fichiers de paramétrage.
Les valeurs utilisant des chaînes Unicode sont les suivantes (les utilisateurs internationaux voudront sans doute les modifier) :
- sitename
- logo_string
- page_front_page
- navi_bar
- page_category_regex
- page_dict_regex
- page_group_regex
- page_template_regex
- page_license_page
- page_local_spelling_words
- acl_rights_default
- acl_rights_before
- acl_rights_after
- mail_from
Pour connaître les paramètres conseillés pour la langue française, consultez la page /WikiEnLangueFrançaise. Pour obtenir des configurations toutes faites pour toutes les langues, consultez la page ConfigMarket.
Personnalisation des préférences utilisateurs
Il est possible de prédéfinir, de désactiver ou de supprimer plusieurs des options de la page des PréférencesUtilisateur. Pour plus d'informations, consultez la page AideDeParamétrage/PréférencesUtilisateurs.