Modèle:Table des caractères Unicode/Légende/Documentation
Ce modèle permet d'afficher une légende pour une table de caractères Unicode (p.ex. {{Table des caractères Unicode/U0000}} – dans Table des caractères Unicode/U0000 –, ou {{Table des caractères Unicode/U0300}} – dans Table des caractères Unicode/U0300 –).
La légende construite par ce modèle est spécifique aux tables de caractères Unicode. Les tables indiquent certains caractères (point de code) avec une couleur de fond différente.
La couleur de fond précise les particularités selon les types de point de code.
Les différents fonds de cellule, dans l'affichage des points de code, sont :
- le point de code est attribué à un caractère normalisé et utilisé le plus souvent dans une écriture de gauche à droite ;
- le point de code est attribué à un caractère normalisé et utilisé dans une écriture de droite à gauche ;
- le point de code est attribué et affichable, mais de façon conditionnelle (p.ex. le trait d'union conditionnel) ;
- le point de code est attribué à un diacritique sans chasse, utilisé dans les textes codés après un autre caractère de base qu'il modifie ;
- le point de code est attribué à un diacritique sans chasse dit « double », utilisé dans les textes codés entre deux caractères de base qu'il modifie conjointement ;
- le point de code est attribué mais n'est pas affichable en tant que tel, par exemple un caractère de contrôle ou de mise en forme contextuelle ;
- le point de code est attribué pour un usage privé, non défini dans la norme ISO/CEI 10646 ou le standard Unicode, mais utilisable dans l'échange de textes interopérables entre systèmes autonomes ayant des conventions d'usage communes ;
- le point de code est attribué mais réservé en tant que « non-caractère » pour des usages techniques strictement locaux et internes, mais pas pour l'échange de textes interopérables ;
- le point de code est réservé car il n'est pas pas encore attribué à un caractère bien défini (ou ce caractère est proposé et son attribution est à l'étude et n'est pas encore définitive).
La légende générée par ce modèle est configurable. Elle permet ainsi de documenter les particularités des points de code présents dans la table.
Paramètre
Un seul paramètre, facultatif, consiste en la combinaison de différents attributs, séparés par des espaces :
allouéOui(facultatif)droiteAgaucheaffichableOptiondiacritiqueOuidiacritiqueDoubleaffichableNonusagePrivénonCaractèreallouéNon
Cette liste de neuf noms d'attributs correspond, dans le même ordre, aux neuf couleurs présentées dans l'introduction.
La légende générée dépend uniquement des attributs invoqués. Elle ne dépend pas des attributs présents dans la table légendée.
Exemples
Pour une invocation sans paramètre :
{{Table des caractères Unicode/Légende}}affiche :
- Légende, point de code :
- alloué
Pour une invocation avec le paramètre constitué de tous les attributs :
{{Table des caractères Unicode/Légende|allouéOui allouéNon diacritiqueOui diacritiqueDouble affichableNon affichableOption droiteAgauche usagePrivé nonCaractère}}affiche :
- Légende, point de code :
- alloué
- alloué (écrit de droite à gauche)
- signe diacritique
- diacritique double
- contrôle ou mise en forme
- usage privé
- non-caractère
- non alloué
Notes :
- Dans le paramètre, l'attribut
allouéOuiest facultatif, il est toujours considéré comme actif.
Ainsi, dans la légende affichée, l'état « alloué » est toujours présent. - Si un attribut est dupliqué, seul le premier est pris en compte.
- Quel que soit leur assemblage, les attributs sont toujours affichés dans un seul ordre, celui présenté ci-dessus.
Par exemple, pour une invocation avec des attributs dans un ordre inversé et où l'attribut allouéOui est omis, et l'attribut diacritiqueOui est dupliqué :
{{Table des caractères Unicode/Légende|diacritiqueDouble diacritiqueOui diacritiqueOui allouéNon}}affiche :
- Légende, point de code :
- signe diacritique
- diacritique double
- non alloué
En illustration, pour compléter, trois exemples :
{{Table des caractères Unicode/Légende|affichableOption affichableNon}}affiche :
- Légende, point de code :
- contrôle ou mise en forme
{{Table des caractères Unicode/Légende|droiteAgauche affichableNon}}affiche :
- Légende, point de code :
- alloué (écrit de droite à gauche)
- contrôle ou mise en forme
{{Table des caractères Unicode/Légende|usagePrivé nonCaractère}}affiche :
- Légende, point de code :
- usage privé
- non-caractère