Aller au contenu

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

Ajouter des liens
Une page de Wikipédia, l'encyclopédie libre.
  • Légende, point de code :
  • alloué
 Documentation[voir] [modifier] [historique] [purger]

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 de base et utilisé le plus souvent dans une écriture de gauche à droite ; cependant certains caractères normalisés, notamment certains signes de ponctuation et symboles (dont les propriétés sont détaillés dans le standard Unicode) sont utilisables dans diverses écritures bidirectionnelles, mais présenter un glyphe en miroir dans le contexte d'une écriture de droite à gauche (les tables les présentent cependant sous leur forme écrite de gauche à droite) ;
  • le point de code est attribué à un caractère de base et utilisé dans une écriture de droite à gauche ;
  • le point de code est attribué à un caractère diacritique sans chasse, utilisé dans les textes après un caractère de base qu'il modifie ;
  • le point de code est attribué à un caractère diacritique sans chasse dit « double », utilisé dans les textes 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 établi des conventions communes d'usage et qu'il leur appartient de négocier et reconnaître ;
  • 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

[modifier le code]

Un seul paramètre, facultatif, consiste en la combinaison de différents attributs, séparés par des espaces :

  • allouéOui
  • droiteAgauche
  • diacritiqueOui
  • diacritiqueDouble
  • affichableNon ou affichableOption
  • 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

[modifier le code]

Pour une invocation sans paramètre :

  • {{Table des caractères Unicode/Légende}} affiche :
  • Légende, point de code :
  • alloué

En illustration, pour compléter, trois exemples :

  • {{Table des caractères Unicode/Légende|allouéOui affichableOption affichableNon}} affiche :
  • Légende, point de code :
  • alloué
  • non affichable
  • {{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

Pour une invocation avec le paramètre constitué de tous les attributs :

  • {{Table des caractères Unicode/Légende|allouéOui droiteAgauche diacritiqueOui diacritiqueDouble affichableNon affichableOption usagePrivé nonCaractère allouéNon}} affiche :

Notes :

  • Dans le paramètre, l'attribut allouéOui est facultatif, il est toujours considéré comme actif s'il n'y a aucun autre attribut indiqué (cela ne peut pas s'appliquer aux tables non entièrement allouées à des caractères écrits de gauche à droite).
    Ainsi, dans la légende affichée, l'état «  alloué » est alors présent par défaut.
  • Si un attribut est dupliqué, une seule occurrence est prise en compte.
  • Quel que soit leur assemblage, les attributs sont toujours affichés dans le même ordre, celui présenté ci-dessus.

Par exemple, pour une invocation avec des attributs dans un ordre inversé, 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 :
Ce type de légende sans cellule blanche par défaut apparait par exemple dans les tables pour les blocs {{Table des caractères Unicode/U0300}}, {{Table des caractères Unicode/U0590}}, {{Table des caractères Unicode/U0600}} et d'autres.

Voir aussi

[modifier le code]
  • {{Table des caractères Unicode/Légende plan}}, présentation complète détaillée, utilisée dans les pages présentant la liste des blocs de caractères alloués dans chacun des 17 plans de codage conjointement défini par la norme ISO/CEI 10646 et le standard Unicode.

La documentation de ce modèle est générée par le modèle {{Documentation}}.
Elle est incluse depuis sa sous-page de documentation. Veuillez placer les catégories sur cette page-là.
Les éditeurs peuvent travailler dans le bac à sable (créer) et la page de test (créer).
Voir les statistiques d'utilisation du modèle sur l'outil wstat.

Ce document provient de « https://fr.wikipedia.org/w/index.php?title=Modèle:Table_des_caractères_Unicode/Légende&oldid=221999316 ».