Table des matières
Entités
DokuWiki peut remplacer certains caractères ou chaînes de caractères par d'autres chaînes basées sur un fichier de configuration. Par défaut, ce fichier est utilisé pour convertir diverses combinaisons de caractères en leur équivalent typographique.
Par exemple :
<< en « >> en » => en ⇒ \_ en
voir aussi les conversions_textuelles.
Les détails des conversions sont dans le ficher conf/entities.conf
. Vous pouvez ajouter les vôtres en créant un fichier conf/entities.local.conf
et en indiquant vos propres conversions dans ce fichier. Il est aussi possible de modifier le fichier de DokuWiki conf/entities.conf
, cependant cela peut provoquer l'écrasement de vos modifications lors d'une mise à jour de DokuWiki. Si vous souhaitez désactiver certaines des conversions par défaut, vous pouvez le faire en ajoutant les mêmes caractères dans les deux colonnes du fichier conf/entities.local.conf
, cette ligne s'y trouvant aura la priorité sur celle du fichier conf/entities.conf
. Par exemple, ajouter
(c) (c)
au fichier conf/entities.local.conf
si vous ne souhaitez pas avoir la lettre c entre parenthèses automatiquement remplacée par le signe copyright.
Même si par défaut il n'est utilisé qu'avec de simples remplacements de caractères, le système d'entités peut également être utilisé pour insérer des constructions plus complexes dans vos pages. Cela inclut le HTML. Cependant, vous devez être conscient que cette méthode est vouée à l'échec lorsqu'elle est utilisée en combinaison avec des outils de rendu non-HTML (comme ODT par exemple). Il est recommandé d'utiliser des caractères UTF-8 à la place, chaque fois que cela est possible.
Veillez à lire à propos de l'encodage UTF-8 avant de modifier le fichier de configuration.
Exemples
Le mécanisme d'entité peut être utilisé pour adapter DokuWiki à certaines règles typographiques françaises qui nécessitent des espaces insécables avant ou après certains signes de ponctuation.
<< « ? ? : : ! ! ; ; >> »
Utiliser la typographie pour le système X de l'esperanto :
CX Ĉ cx ĉ GX Ĝ gx ĝ HX Ĥ hx ĥ JX Ĵ jx