Aller au contenu

Modèle:Table des caractères Unicode/Légende/Documentation

Ajouter des liens
Une page de Wikipédia, l'encyclopédie libre.
< Modèle:Table des caractères Unicode/Légende
Ceci est une version archivée de cette page, en date du 27 novembre 2024 à 22:08 et modifiée en dernier par Verdy p (discuter | contributions). Elle peut contenir des erreurs, des inexactitudes ou des contenus vandalisés non présents dans la version actuelle.

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é à 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 différents 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 où un tel non-caractère peut à tout moment être substitué ou même bloquer la transmission et l'interprétation de la totalité du texte ; de nombreux standards et systèmes interdisent son usage dans les textes échangés dans leurs clauses de conformité, d'interopérabilité ou de sécurité ;
  • le point de code 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) et son usage est réservé, en attendant une possible affectation et une définition de ses propriétés effectives dans une mise à jour de la norme ISO/CEI 10646 et du standard Unicode (un tel caractère peut cependant être échangé et utilisé d'un système à l'autre même s'il ne le reconnait pas encore, mais son rendu et son interprétation peut y être localement aléatoire tant qu'un tel système n'est pas lui-même mis à jour).

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)
  • droiteAgauche
  • affichableOption
  • diacritiqueOui
  • diacritiqueDouble
  • affichableNon
  • usagePrivé
  • nonCaractère
  • alloué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 :

Notes :

  • Dans le paramètre, l'attribut allouéOui est 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 :

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 :
  • {{Table des caractères Unicode/Légende|usagePrivé nonCaractère}} affiche :
  • Légende, point de code :
  • usage privé
  • non-caractère
Ce document provient de « https://fr.wikipedia.org/w/index.php?title=Modèle:Table_des_caractères_Unicode/Légende/Documentation&oldid=220666943 ».