GEUL (General Encoding Unified Language) est un langage artificiel et un format binaire permettant aux humains et à l’IA de communiquer sans ambiguïté.

Ces documents définissent la grammaire GEUL v1. La version actuelle est un brouillon antérieur à la publication et peut changer. La spécification est publiée sous CC0 1.0.

Vue d’ensemble

  • Toutes les données sont une suite de mots de 16 bits (WORD), écrits en big-endian.
  • L’unité de données est l’enregistrement. Un enregistrement commence par un seul TAG WORD, et ce TAG WORD indique le type et la longueur de l’enregistrement.
  • Il existe quatre types d’enregistrement (Kind).
KindRôleExemple
ReferenceDésigne une cibleWikidata Q42, #7 dans ce document
ValueContient une valeur en tant que telledate, quantité, texte accompagné d’une langue
EdgeRelie d’autres enregistrements pour énoncer quelque chose« Q42 est une personne », « Le nom anglais de Q42 est Douglas Adams »
MetaParle du documentversion de la spécification, ID du document, auteur, signature
  • Les enregistrements sont contenus dans un document. Comme en HTML, un document se divise en HEAD (Meta, ainsi que la provenance SOURCE de l’ensemble du document et son QUALIFIER) et BODY (Reference, Value, Edge).
  • Un document est émis par un Issuer (l’entité émettrice) et chaque version est figée par un hachage du contenu. Une version publiée ne change pas.

Principes de conception

  1. On peut sauter les enregistrements sans codebook. Le type et la longueur d’un enregistrement sont dans les 16 bits du TAG WORD. Un décodeur qui ne connaît pas la méthode d’interprétation (le codebook) peut quand même compter les enregistrements et les sauter.
  2. On consigne des énoncés, non des faits. Un document note, avec Meta et des Edge de fondement, qui a énoncé quoi, quand et à partir de quoi.
  3. L’identification se fait par Reference. On désigne par ID, non par nom. Le nom est attaché par un Edge.
  4. Ce qui est publié ne change pas. Une correction paraît dans une nouvelle version. Un ID à l’intérieur d’un document désigne la même cible d’une version à l’autre.
  5. On laisse du vide. On réserve à l’avenir la plus grande partie de l’espace de bits. Les codes directs ne peuvent pas être repris, on n’attribue donc que ceux dont la fréquence est établie.

Documents subordonnés

Pour une première lecture, suivez le tableau de haut en bas.

DocumentContenu
Structure d’un enregistrementdisposition du TAG WORD, Length, Codec, TAG d’extension
Issuer et publicationniveaux d’Issuer, table d’attribution des 2 WORD, mode de publication, signature, clé de vérification
Adresse de publication et liste des versionsnotation des ID, adresse de publication, spécification de format, liste des Issuer, liste des versions, niveaux de confiance
Documents de spécification de Codeccodebook écrit avec DECLARE, FIELD, ENUM, CODEC
Document ordinaireDOC, HEAD, BODY, END, ID du document, hachage du contenu, versions et révisions
Index des codesles 227 cases attribuées, tableaux de Codec par Kind et par famille
Disposition des sections16 sections et disposition des cases, plages attribuées et Reserved
Marqueur d’emplacementABSENT, UNKNOWN-VALUE, NO-VALUE, règles d’acceptation
Referenceidentification de la cible, LOCAL, références externes, Quantifier, marqueurs d’emplacement
Valuefamilles de valeurs, codes directs, texte, quantité, date
Metastructure, définition, provenance, lignée, vérification, politique, IMPORT
Edgefamilles d’énoncé, de fondement, d’exécution et TOULMIN, TRIPLE, QUALIFIER, LABEL
TOULMINfamille des graphes de verdict et d’exécution, dispositions NODE, LINK, SOURCE
Exemple : un élément Wikidatalecture d’un document mot par mot

Ce que l’on sait sans codebook

InformationSans codebookFondement
Kindconnuplage de la section w >> 9 du TAG WORD (Reference 0~2, Value 3 et 4, Edge 5~13, Meta 14 et 15)
Longueur totale de l’enregistrement, position du suivantconnuesLength du TAG WORD
Numéro de CodecconnuTAG WORD (en format Issuer, l’Issuer et le numéro de Codec du TAG d’extension)
Famille, classeen partie connuesPour les codes directs d’Edge, seule la famille est connue par les bits. La famille des codes directs de Value et du format Issuer, ainsi que la classe de Meta, ne sont pas connues par les bits. En format Issuer, on connaît l’Issuer et le numéro de Codec. La classe de vérification de Meta est connue par C >= 5 (w >= 0x1E50) de la section 15
Edge Id d’un Edgeconnule premier composant d’un Edge (sections 5~13) est toujours une Reference LOCAL
Marqueur d’emplacement (non noté, inconnu, aucun)connule WORD vaut 0x0000, 0x0010, 0x0020 (Reference, C < 3, L 0). Marqueur d’emplacement
Quantifierconnupar le décalage C dans la section : si 5 <= C < 30 en section 0, ou C < 30 en section 1, alors C % 5
Longueur du TAG par Codec, début du Payloadinconnuscodebook
Interprétation du Payload, rôle des composants d’un Edgeinconnuscodebook
  • Un décodeur sans codebook peut sauter les enregistrements et les compter par Kind et par Codec, mais il ne peut pas suivre la structure du graphe.
  • Tout décodeur doit traiter les classes structure, définition et IMPORT de Meta. Ces Codec appartiennent au codebook central de GEUL, et le décodeur les connaît par une table de numéros intégrée (Meta).

Les codebooks sont publiés sous forme de documents GEUL (Documents de spécification de Codec). Un décodeur n’a donc qu’à récupérer et lire le document de spécification dont il a besoin.

Structure des zones

Les bits de poids fort du TAG WORD divisent les zones.

PrefixZonePartDéfinition
1Futur lointain50 %Reserved (futur lointain). Non utilisé
01Futur25 %Reserved (futur proche). Non utilisé
001Standard12,5 %grammaire officiellement adoptée et en exploitation
000Libre / proposition12,5 %grammaire actuelle. Une fois adoptée, la disposition reste telle quelle et seul le Prefix passe à 001

Toute la grammaire actuelle se trouve dans la zone 000. Tous les TAG WORD de cette spécification commencent par 000.

  • Un décodeur v1 rejette les TAG WORD dont le Prefix n’est pas 000. Les autres zones seront fixées par les versions ultérieures.
  • La zone 000 est un espace de proposition. Aucune inscription ni aucune protection n’y est appliquée pour l’instant.