Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:entities [2008-08-15 23:10] – moved from fr:config:entities ach
+++ fr:entities [2020-05-18 16:45] (Version actuelle) – mise à jour Digitalin
@@ Ligne 1: / Ligne 1: @@
 ====== Entités ======
-[[DokuWiki]] peut convertir diverses combinaisons de caractères en leur équivalent typographique.
+[[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.
-e.g. <code>
+Par exemple : <code>
 <<  en «
 >>  en »
 =>  en ⇒
+\_  en &nbsp;
 </code>
-voir aussi la [[fr:syntax#typographie]].
+voir aussi les [[fr:wiki:syntax#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 causer le fait que vos modifications soient écrasées lors d'une mise à jour de Dokuwiki.
+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 <code>(c)    (c)</code>  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.
-====== Exemples ======
+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.
-> Il semblerait qu'il soit possible d'utiliser ce tableau pour adapter DokuWiki à certaines règles de la typographie Française nécessitant des espaces non sécables avant ou après certains signes de ponctuation. Par exemple, dans le fichier ''conf/entities.conf'', j'ai écrit des règles telles que:
+Veillez à lire à propos de l'[[fr:utf-8|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.
   << &laquo;&nbsp;
@@ Ligne 22: / Ligne 27: @@
   ! &nbsp;!
   ; &nbsp;;
+  >> &nbsp;&raquo;
-> Utiliser la typographie pour le système X de [[wpfr>Alphabet_de_l'espéranto#Le_syst.C3.A8me_X|l'esperanto]]:
+> Utiliser la typographie pour le système X de [[wpfr>Alphabet_de_l'espéranto#Le_syst.C3.A8me_X|l'esperanto]] :
-  cx	─Й
-  Cx	─И
-  CX	─И
-  gx	─Э
-  Gx	─Ь
-  GX	─Ь
-  hx	─е
-  Hx	─д
-  HX	─д
-  jx	─╡
-  Jx	─┤
-  JX	─┤
-  sx	┼Э
-  Sx	┼Ь
-  SX	┼Ь
-  ux	┼н
-  Ux	┼м
-  UX	┼м
->>La typographie pour l'écriture de l'espéranto n'apparait pas correctement dans la section de code ci-dessus; pour ceux qui sont intéressés, voici les caractères tels qu'ils devraient apparaitre: (--- //[[visuallucho_plusplus@yahoo.es|'Ryan Chappelle']] 2008/05/28 06:04//)
-  CX  Ĉ     cx   ĉ
-  GX  Ĝ     gx   ĝ
-  HX  Ĥ     hx   ĥ
-  JX  Ĵ     jx   ĵ
-  SX  Ŝ     sx   ŝ
-  UX  Ŭ     ux   ŭ
-====== Édition du fichier ======
+  CX   Ĉ
+  cx   ĉ
+  GX   Ĝ
+  gx   ĝ
+  HX   Ĥ
+  hx   ĥ
+  JX   Ĵ
+  jx
-Comme indiqué dans entities.conf, vous pouvez utiliser des entités HTML pour configurer vos entités, mais ce n'est pas recommandé, parce que cela pourrait ne pas fonctionner avec les moteurs de rendu non-HTML.
-Aussi, des caractères UTF-8 sont directement utilisés à la place. Pour ce faire, veuillez utiliser soit un éditeur de texte conforme avec l'UTF-8, comme [[SourceForge>projects/notepad-plus|notepad++]]; soit un éditeur hexadécimal, comme [[SourceForge>projects/hexplorer/|hexplorer]] et une [[http://www.unicode.org/Public/5.2.0/ucd/|table de caractères UTF-8]]. Cependant, les éditeurs de textes normaux ne doivent **PAS** être utilisés pour cela, car certains caractères utilisés par l'encodage UTF-8 ne sont pas accessibles via un clavier standard.
-Par exemple, l'équivalent du caractère ≠ (HTML: &ne;) en UTF-8 est 0xE2; 0x89; 0xA0; et 0xA0 apparait comme un espace normal même si il n'en est pas un.
+===== Voir aussi =====
-D'autre part, n'essayez **PAS** de calculer les caractères UTF-8 vous même sans n'avoir aucune idée de ce qu'est l'UTF-8, ou vos entités pourraient ne pas fonctionner.
+  * [[fr:config|Configuration de DokuWiki]]