Les observations

Partie technique : le fichier d'observation#

Ce qui suit est pour qui écrit ces fichiers à la main, les génère ou les lit en code. Dans l'éditeur, rien de cela n'a besoin d'être connu.

Un enregistrement est un simple fichier JSON. Rien dedans n'est un blob binaire, un identifiant dans une base de données, ni une référence à ce site — vous pouvez en écrire un à la main, en engendrer depuis vos propres archives, ou en comparer deux dans une relecture de code.

Chaque extrait ci-dessous est en lecture seule, et chacun connaît le format : placez le curseur dans un objet et faites Ctrl+Espace (⌥+I sur Mac) pour lister toutes les clés qui pourraient y figurer, avec ce que le modèle dit de chacune.

L'observation#

Plusieurs observateurs : le dossier#

Chaque observateur a son propre enregistrement, et un enregistrement ne dit pas à quel dossier il appartient : un compte rendu se suffit à lui-même. Ce qui les montre ensemble est le dossier, qui les désigne : le case.json d'un dossier RR0, qui énonce le titre, la date et la classification du dossier, et liste tout ce qui lui est arrivé en events. Ses événements de type sighting sont ses comptes rendus, chacun pointant vers l'enregistrement d'un observateur :

{
  "id": "ChilesWhitted",
  "title": "Chiles et Whitted",
  "time": "1948-07-24 02:45",
  "events": [
    { "type": "event", "eventType": "sighting", "url": "observer-chiles.json" },
    { "type": "event", "eventType": "sighting", "url": "observer-whitted.json" }
  ]
}

Donnez-le à <rr0-sighting src> ou au lecteur, et chaque observateur se choisit dans une liste. Un enregistrement peut être donné directement, sans dossier, mais un dossier à un seul compte rendu marche de la même façon et nomme ce qu'il montre. Essayez avec case-chiles-whitted.json (le jouer).

Le dire en plusieurs langues#

Un enregistrement se transmet d'un lecteur à un autre : chaque champ écrit par un auteur peut donc porter une chaîne par langue au lieu d'une seule — description, le title d'une forme ou d'un élément de décor, le label et la note d'un repère.

{
  "description": {
    "fr": "Tout le compte rendu de Lonnie Zamora, d'un seul tenant…",
    "en": "Lonnie Zamora's whole account, of a piece…"
  }
}

Les clés sont des étiquettes de langue telles qu'un navigateur les donne (fr, en, pt-BR), et aucune n'est obligatoire. Une chaîne simple reste parfaitement valide et signifie « dans la langue où cela a été écrit » — ce qu'est tout enregistrement antérieur. Un lecteur dont aucune langue n'est présente reçoit ce que le fichier A, plutôt qu'un champ vide : une traduction manquante ne doit jamais transformer ce qu'un observateur a dit en ce qu'il n'a pas dit.

La langue reçue est celle du navigateur, sauf si la page en dit autre chose : un lang sur l'élément lui-même, ou sur ce qui l'entoure, est pris d'abord — un article qui déclare sa langue a déjà énoncé dans quelle langue son lecteur le lit. La liste du navigateur vient ensuite : déclarer une langue force donc un choix sans jeter les autres.

L'éditeur montre une langue, celle du lecteur, et n'écrit que dans celle-là — ouvrir le fichier dans l'autre langue et taper est donc la façon d'ajouter une traduction, et un auteur ne peut pas effacer celle d'un autre.

Ce qui a été vu#

timeline.keyframes est une liste de { t, shapes }, t en millisecondes depuis le début. Chaque forme porte un sourceId — plusieurs formes peuvent partager une chronologie (le phénomène, une flamme qui traîne, une seconde lumière) — et une shape :

{
  "kind": "oval",
  "bounds": { "x": 0, "y": 0, "width": 0, "height": 0 },
  "color": "#39ff14",
  "angle": 0,
  "transparency": 0,
  "haloScale": 1.5,
  "brightness": 0,
  "blur": 0,
  "selected": false,
  "title": "le phénomène",
  "angular": { "widthDeg": 1.2, "heightDeg": 0.4 },
  "aim": { "azimuthDeg": 353.6, "altitudeDeg": 0.6 }
}

aim le place, angular le dimensionne. bounds est la projection des deux sur le canevas fixe de 640×360, au cap et au champ de la pose, à travers l'instrument de l'enregistrement ; il est redérivé au chargement, si bien qu'un fichier survit à un changement de canevas, de champ, d'instrument, ou de direction du regard. Si les pixels et les angles divergent, les angles gagnent : déplacer bounds dans un fichier ne fait rien tant que aim est là. Un fichier écrit à la main peut omettre bounds entièrement.

timeline.order est l'ordre de tracé de l'arrière vers l'avant, timeline.groups les identifiants groupés. Les deux sont facultatifs.

Tout ce qu'il y a autour#

Un objet du décor s'énonce en mètres, comme tout ce qui n'est pas le phénomène :

Ce que c'était : les interprétations#

Un enregistrement énonce des angles, et un corps en mètres ne fait jamais partie de ce qui a été vu. C'est une affirmation à son sujet, et elle se met à l'épreuve en la posant dans la scène et en la regardant depuis l'endroit où se tenait l'observateur : elle projette son ombre, le sol peut la cacher, et son contour est confronté à chaque instant à ce que l'observateur a dit. Une interprétation s'affiche seule, comme le monde qu'elle affirme ; quand on demande la comparaison (le bouton ◌, ou compare-account sur <rr0-sighting>), le lecteur dessine à côté tout ce que l'observateur a vu, en contours pointillés, et indique l'écart de direction et combien de fois plus large et plus haut chaque corps paraît, en rouge quand un observateur n'aurait pas pu se tromper d'autant.

La lecture de l'observateur lui-même va dans l'enregistrement, en interpretation. Celle d'un autre n'est pas dans le compte rendu : c'est une autre observation, listée dans le dossier (voir plus bas). Un compte rendu dont l'observateur a dit ce que c'était se dessine en volume, comme il l'a dit ; celui qui ne dit rien en mètres se dessine avec les angles qu'il énonce. Le lecteur le propose, ainsi que chaque interprétation d'analyste, une à la fois.

{
  "interpretation": {
    "title": "Un engin posé sur ses pieds",
    "bodies": [{
      "id": "craft",
      "explains": ["ufo-1"],
      "model": { "id": "ellipsoid" },
      "track": [
        { "t": 52000, "eastM": -571.6, "northM": -965.5, "onGround": true,
          "sizeM": { "widthM": 3.36, "lengthM": 3.36, "heightM": 1.73 },
          "appearance": { "color": "#e8e6df", "albedo": 0.7 } },
        { "t": 83000, "azimuthDeg": 195.9, "altitudeDeg": 4.1, "distanceM": 44 }
      ]
    }]
  }
}

Événements du ciel#

Ce qui s'est passé dans le ciel pendant l'enregistrement, en tant que faits : un tir laser, un lancement de fusée, une rentrée atmosphérique. Chacun a eu lieu que quelqu'un l'ait vu ou non : ce n'est donc ni l'interprétation, qui lit le compte rendu, ni le décor, qui dure plus longtemps que l'observation (une maison, un arbre). Ils sont déclarés sous skyEvents, au premier niveau de l'enregistrement ; un enregistrement qui les mettait dans son interpretation, comme le faisaient les versions précédentes, est encore lu.

{
  "skyEvents": {
    "beams": [{
      "id": "meudon-paris",
      "path": [
        { "lat": 48.805055, "lng": 2.231171, "altitudeM": 172.5 },
        { "lat": 48.83632, "lng": 2.33702, "altitudeM": 88 }
      ],
      "wavelengthNm": 532,
      "powerW": 10
    }]
  }
}

Une autre lecture : une interprétation est une autre observation#

La lecture qu'un autre fait d'un compte rendu (celle d'un analyste, d'un enquêteur, une comparaison faite pour la mettre à l'épreuve) n'est pas dans le compte rendu : c'est une autre observation, celle qui a eu lieu telle que son auteur la tient. Elle est donc listée dans le dossier comme l'original, en événement de type sighting, marqué comme lecture par interpretationOf, et a un enregistrement à elle à url :

{
  "id": "McMinnville1950",
  "events": [
    { "type": "event", "eventType": "sighting", "id": "trent", "title": "Paul Trent", "url": "observer-mcminnville.json" },
    { "type": "event", "eventType": "sighting",
      "interpretationOf": "trent",
      "time": "2013-06",
      "by": [{ "people": "CousynAntoine" }, { "people": "LouangeFrancois" }],
      "title": "A model on a thread under the line",
      "url": "interpretation-mcminnville-2.json" }
  ]
}

L'enregistrement à url est un enregistrement comme les autres. Il partage le lieu, l'heure et la pose de l'observateur du compte rendu qu'il lit, si bien qu'un corps placé depuis l'observateur, ou en mètres depuis l'endroit où il se tenait, veut dire la même chose dans les deux ; il ne dessine aucune forme (une timeline vide) ; et il porte les corps dans son propre interpretation, décrit plus haut. Les explains d'un corps désignent les formes du compte rendu.

{
  "version": 2,
  "id": "1950-05-11-TrentPaul-interpretation-2",
  "time": "1950-05-11T19:45",
  "utcOffsetHours": -7,
  "place": { "locations": [{ "lat": 45.104167, "lng": -123.330556 }] },
  "observerTrack": { "keyframes": [{ "t": 0, "pose": { "lat": 45.104167, "lng": -123.330556, "headingDeg": 41.3, "pitchDeg": 14.85, "fovDeg": 33.4 } }] },
  "tags": ["interpretation"],
  "timeline": { "keyframes": [], "order": [], "groups": [] },
  "interpretation": {
    "title": "A model on a thread under the line",
    "bodies": [{
      "id": "model",
      "explains": ["ufo-1"],
      "model": { "id": "disc" },
      "track": [
        { "t": 0, "eastM": -52, "northM": 118, "altitudeAboveGroundM": 7.5,
          "sizeM": { "widthM": 0.3, "lengthM": 0.3, "heightM": 0.1 } }
      ]
    }]
  }
}

Le lecteur liste les observateurs du dossier d'après les événements sans interpretationOf et propose chaque lecture à côté du compte rendu qu'elle désigne, une à la fois (le bouton ◌ la mesure contre le compte rendu). Un enregistrement seul n'a d'autre lecture que son propre interpretation. L'ancienne forme, un événement de type interpretation qui désigne l'enregistrement dans sighting avec ses corps sur place ou dans un fichier à url, est encore lue. L'éditeur ouvre un dossier : son sélecteur au-dessus du rendu liste les comptes rendus et les lectures, chacun s'ouvrant comme l'enregistrement qu'il est, avec un bouton pour ajouter une lecture (un nouvel enregistrement qui partage le lieu, l'heure et la pose du compte rendu, et un événement pour lui), un pour la supprimer, et un pour exporter le dossier et chaque enregistrement ajouté ou modifié en zip. Essayez avec case-mcminnville.json (le jouer, l'éditer).

La météo, et ses nuages#

Un point weather énonce l'état du ciel à un instant de l'horloge de l'enregistrement ; entre deux points chaque nombre est interpolé, le type de précipitation et l'orage sont maintenus. Il porte :

Chaque couche de cloudLayers est une nappe de nuages à une hauteur réelle, et reste elle-même d'un point à l'autre :

Un nuage individuel dans instances est un nuage de sa couche que le fichier place exactement, parce que le récit le fait : celui derrière lequel le phénomène est passé, celui qui était là et nulle part ailleurs. Il est dessiné comme un nuage de sa couche — même texture, même seuil — et ne se distingue de ses voisins que par sa position et sa taille ; il est là même quand la coverage de la couche est nulle. Il suit le vent de la couche comme les autres, et il masque un phénomène devant lequel il passe.

{
  "weather": {
    "cloudLayers": [
      {
        "id": "low", "type": "cumulus",
        "baseM": 1500, "thicknessM": 800,
        "coverage": 0.55, "sizeM": 1400, "density": 1, "darkness": 0.15,
        "instances": [
          { "id": "the-one", "eastM": 0, "northM": 4200,
            "baseM": 1500, "thicknessM": 800,
            "widthM": 1900, "depthM": 1300, "rotationDeg": 12, "density": 1 }
        ]
      },
      { "id": "high", "type": "cirrus", "baseM": 8000, "thicknessM": 400,
        "coverage": 0.2, "sizeM": 2200, "density": 0.35, "iceCrystalAlignment": 0.65 }
    ],
    "precipitationType": "none", "precipitationIntensity": 0,
    "windDirectionDeg": 90, "windSpeed": 5, "storm": false
  }
}

Un enregistrement dont la météo a été relevée (il a un weatherSource) garde la réponse du relevé, pas un lien vers lui : ERA5 donne les bandes basse, moyenne et haute en trois couches nommées record-low, record-mid et record-high, la base basse estimée depuis l'écart entre température et point de rosée, les deux autres à 3 500 m et 8 000 m. Leur type est unknown (cirrus pour la haute), leur taille et leur densité sont des hypothèses de dessin : une réanalyse sait quelle part de chaque bande était couverte, pas à quoi les nuages ressemblaient. Redemandez le relevé depuis l'éditeur et les couches sont réécrites ; modifiez une couche à la main et l'enregistrement devient celui de l'auteur, la source retirée.

D'où vient chaque valeur#

Toute valeur d'un enregistrement peut s'écrire nue, ou enveloppée de sa provenance :

{
  "durationSeconds": {
    "value": 15,
    "basis": "derived",
    "rationale": "13 à 18 s dans la synthèse de l'enquêteur ; le milieu retenu"
  }
}

basis vaut stated (l'observateur l'a dit, et c'est ce que signifie une valeur nue), derived (déduit de ce qu'il a dit et de quelque chose de vérifiable : la largeur d'une route, une carte, un dessin mesuré ; rationale donne le calcul) ou assumed (choisi pour que la reconstitution ait une valeur, sur rien que l'observateur ait dit). La liste des valeurs assumed est la liste de ce qu'il faut retourner demander à l'observateur ou au dossier : c'est pourquoi elle vaut d'être écrite même quand rien d'autre ne l'est.

Vérifier un fichier#

Le format est aussi publié en JSON Schema, engendré depuis les mêmes types que le lecteur : toutes les clés qu'il connaît, ce que chacune peut contenir, et les mots qu'accepte une liste fermée. Une clé mal orthographiée ou une valeur inconnue y échoue. Il ne dit rien de ce qui peut être omis, question de sens à laquelle répond cette page. Pour voir le résultat, ouvrez le fichier dans le lecteur, depuis un lien, ou depuis votre disque avec les images et modèles qu'il nomme. Le lecteur le vérifie de la même façon au chargement, et dit derrière un ⚠ sur l'image ce qu'il n'a pas pu jouer comme écrit : une clé que rien ne lit, un mot hors de sa liste, et ce qu'il a dû inventer parce que la première keyframe d'une forme l'omettait (un champ tenu depuis la keyframe précédente relève de la règle ci-dessus, pas d'un problème).

Versions du format#

Un fichier indique la version de son format dans version : 2 depuis novembre 2026. C'est la version du FORMAT, pas celle d'UFO@home : ajouter un champ ne la change pas, puisqu'un lecteur plus ancien ignore ce qu'il ne connaît pas. Elle ne change que le jour où un champ change de sens ou de forme, et le lecteur lit alors les deux, l'ancienne par une conversion. La version 2 écrit time et endTime en texte EDTF plutôt qu'en champs d'une date ({ "year": 1964, "month": 4, … }), et place comme un lieu plutôt que comme une liste de positions portant chacune son nom, pour qu'un enregistrement et un événement de RR0 disent « quand » et « où » de la même façon ; tout fichier de version 1 se joue encore, converti à la lecture, ce qu'il disait de l'origine de ses valeurs conservé. Un fichier d'une version plus récente que le lecteur est refusé avec un message qui le dit, plutôt que joué comme ce qu'il ne dit pas.

Chaque version a son schéma, à une adresse qui la nomme : https://ufoathome.org/schema/2/sighting.schema.json (et case.schema.json, interview.schema.json à côté). /sighting.schema.json est toujours la version courante. Un fichier peut nommer celle d'après laquelle il a été écrit dans "$schema", dont se servent des éditeurs comme VS Code pour le vérifier pendant la frappe ; le lecteur ne le lit pas.

Un fichier entier#

Le plus petit enregistrement qui énonce encore quelque chose — un ovale silencieux traversant le ciel en douze secondes, à une date réelle et en un lieu réel. Tout le reste du format est facultatif, et tout ce qui suit sert à quelque chose :

{
  "version": 2,
  "description": "The smallest recording that still states something: one silent orange oval, a degree and a half wide, crossing the south-western sky from left to right over twelve seconds.",
  "time": "2024-08-12T22:30",
  "durationSeconds": 12,
  "utcOffsetHours": 2,
  "place": {"name": "Grenoble, Isère, France", "locations": [{"lat": 45.19, "lng": 5.72}]},
  "timeline": {
    "keyframes": [
      {
        "t": 0,
        "shapes": [
          {
            "sourceId": "ufo-1",
            "shape": {
              "kind": "oval",
              "bounds": { "x": 150, "y": 150, "width": 10, "height": 3 },
              "angular": { "widthDeg": 1.6, "heightDeg": 0.5 },
              "color": "#ff8c1a",
              "angle": 0,
              "transparency": 0,
              "haloScale": 1.2,
              "selected": false
            }
          }
        ]
      },
      {
        "t": 12000,
        "shapes": [
          {
            "sourceId": "ufo-1",
            "shape": {
              "kind": "oval",
              "bounds": { "x": 480, "y": 130, "width": 10, "height": 3 },
              "angular": { "widthDeg": 1.6, "heightDeg": 0.5 },
              "color": "#ff8c1a",
              "angle": 0,
              "transparency": 0,
              "haloScale": 1.2,
              "selected": false
            }
          }
        ]
      }
    ]
  },
  "observerTrack": {
    "keyframes": [
      {
        "t": 0,
        "pose": { "lat": 45.19, "lng": 5.72, "elevationM": 0, "headingDeg": 215, "pitchDeg": 20, "fovDeg": 60 }
      }
    ]
  },
  "soundTrack": { "keyframes": [{ "t": 0, "sound": { "kind": "none", "volume": 0, "pitchHz": 100 } }] }
}

Pour le modifier et le voir jouer, collez-le dans l'éditeur, qui complète sur chaque clé du format, propose les mots que chacune accepte, et dit ce que le modèle en dit.

C'est /demo-data/example-minimal.json sur ce site : vous pouvez le récupérer, et le jouer avant d'y toucher. Remarquez que angular et bounds y figurent tous deux : l'angle est ce que le fichier SIGNIFIE, et les pixels en sont redérivés au chargement — écrivez l'angle, et laissez corriger une mauvaise estimation des pixels.

De plus gros, à lire#

Chaque démo de ce site est un simple fichier que vous pouvez ouvrir. Ces quatre-là valent la lecture pour voir comment un vrai enregistrement est bâti :

Quatre règles qui décident du sens d'un fichier#

• Les champs discrets sont tenus, les continus sont interpolés. Une forme absente d'un keyframe ultérieur reste dans son état, et de même tout champ qu'un keyframe omet dans une forme qu'il énonce : un keyframe qui ne donne qu'un nouvel aim déplace la forme et garde tout le reste (énoncer bounds sans aim ni angular est lu comme la déplacer par ses pixels) ; une forme dont le premier keyframe est à cinq secondes est déjà peinte, dans cet état, dès zéro. Pour qu'une chose cesse d'être visible, posez-lui un keyframe à transparency: 1.
• Des angles, rien d'autre. Aucune taille ni distance réelle n'est stockée où que ce soit. Les mètres sont déduits, en inégalités, de ce que le phénomène a été déclaré passer derrière ou devant (decor[].occludesSourceIds).
• L'énoncé l'emporte sur le déduit. occludesSourceIds contient des affirmations de l'observateur. Rien dans ce format ne peut les déduire : il décrit une apparence dans un champ de vision, pas une position dans l'espace.
• Absent n'est pas zéro. Pas de piste sonore signifie que personne n'a posé la question ; kind: "none" signifie que l'observateur a déclaré n'avoir rien entendu. La même distinction traverse la météo et les nuages de glace.

Cette page est la référence du format. Le raisonnement derrière chaque champ est dans les commentaires de documentation de son type, que les extraits ci-dessus proposent à la complétion, et dans le code source.

Les composants#

Trois des éléments standards concernent une observation : la scène où elle est rejouée, le lecteur qui la montre, et l'éditeur qui la décrit. L'éditeur de dossier et l'éditeur d'interview ont leurs sections, sur les pages qui en parlent.

Standards, et c'est toute la conception#

Ce sont cinq composants web — le standard du navigateur pour un élément personnalisé, et non le composant du framework de quelqu'un. Ce qui en découle mérite d'être dit, car c'est ce qui permet de vous le remettre :

• Ils fonctionnent dans n'importe quelle page. Un site statique, WordPress, une application React ou Vue, un wiki, un fichier HTML écrit à la main. Ce sont des éléments : une page qui peut contenir une <video> peut les contenir.
• Rien à construire. Ni bundler, ni étape de compilation, ni configuration dans votre projet. Le module enregistre son élément à l'import et le navigateur fait le reste.
• Rien à suivre. Il n'y a pas de version de framework à faire correspondre : la version majeure de quelqu'un d'autre ne peut pas les périmer.
• Leur intérieur est à eux. Chacun porte son balisage et ses styles dans un shadow root : le CSS de votre page ne peut pas les casser, et eux ne peuvent pas casser votre page.

Ils se composent en ligne : <rr0-sighting> comme <rr0-sighting-editor> contiennent un <rr0-scene>, et la scène contient la couche de lecture — la chronologie, les commandes, le canevas du pointeur. Tout ce à quoi la scène répond est donc disponible dans les trois — via .scene et .scene.ufoElement depuis le plus extérieur, la composition vivant dans un shadow root.

À quoi sert chacun#

• <rr0-scene> — le phénomène dans le monde autour. La forme dessinée par un observateur, sa couleur, son halo, son mouvement, debout dans le ciel, l'horizon, la météo et le sol réels d'une date, d'une heure et d'un lieu énoncés — cachée par ce qui se tenait devant. Utile seul aussi, pour un ciel où il n'y a rien du tout.
• <rr0-sighting> — le compte rendu, à regarder. Une scène, plus qui témoigne, les métadonnées de l'observation, ses crédits, et les lignes qui permettent à un lecteur de l'emporter ailleurs. C'est à cela que ressemble une observation publiée.
• <rr0-sighting-editor> — le compte rendu, à reconstruire. Tout ce qui précède, plus la barre d'outils de saisie : décrire une observation, ou en corriger une.
• <rr0-case-editor> — un dossier, à assembler. Contient un <rr0-sighting-editor> et lui présente un enregistrement d'un case.json à la fois : les comptes rendus des observateurs et les lectures qu'on en fait. Il les ajoute, les sélectionne et les supprime, et exporte le dossier.
• <rr0-date-input> — une date, avec sa précision. Un sélecteur pour un instant complet, un texte pour moins (EDTF), et le degré de certitude. Les éditeurs s'en servent pour le début et la fin d'une observation et pour la date d'un dossier ; il dit ce qu'il contient par un événement datechange.

Comment ils s'emboîtent#

Vous n'écrivez jamais l'imbrication. Chaque élément construit celui du dessous dans son propre shadow root : ce que votre page contient, c'est une seule balise.

<rr0-sighting>           qui témoigne, le panneau de métadonnées, les lignes d'intégration
└─ <rr0-scene>           le ciel, l'horizon, la météo et le décor réels, le phénomène, la lecture

<rr0-sighting-editor>    les huit panneaux de saisie
└─ <rr0-scene>           une scène, pas une observation : un éditeur a sa propre barre d'outils

C'est pourquoi une seule balise de script embarque ceux du dessous :

Une page qui montre une observation puis, plus bas, un ciel seul, n'a donc besoin que d'un script et de deux balises : le second élément est déjà enregistré.

On peut entrer dans une composition, une propriété à la fois :

const sighting = document.querySelector("rr0-sighting")
sighting.scene                    // le <rr0-scene> qu'il compose
sighting.scene.ufoElement         // et la couche de lecture en dessous
sighting.scene.ufoElement.play()  // la lecture est donc à deux propriétés

<rr0-sighting-editor> garde sa composition pour lui : ce qu'il offre à une page, c'est l'enregistrement — sightingData — et l'événement qui dit qu'il a changé.

Celui qu'il vous faut#

Ce ne sont pas des variantes d'un même bundle : chacun est autonome, ne chargez donc que celui dont vous avez besoin. Tous trois embarquent Three.js et un catalogue d'étoiles — c'est ce que coûte un vrai ciel.

En poser un sur une page, c'est deux lignes.

Intégrer dans votre application#

Après npm install @rr0/ufoathome :

import "@rr0/ufoathome/scene"    // enregistre <rr0-scene>
import "@rr0/ufoathome/sighting" // enregistre <rr0-sighting>
import "@rr0/ufoathome/editor"   // enregistre <rr0-sighting-editor>

Ou recopiez le contenu des répertoires dist-embed* du paquet sur votre serveur et pointez le <script src> dessus. Chaque module référence ses ressources — catalogue d'étoiles, sons de météo — relativement à lui-même : il fonctionne donc depuis n'importe quel chemin, il suffit de garder ensemble les fichiers d'un même bundle. Plus rien ne dépend alors de ce site.

Langue#

Chaque libellé est traduit par détection, sans sélecteur : la langue déclarée par la page d'abord — l'attribut lang le plus proche, donc <html lang="fr"> donne des libellés français — puis les préférences du navigateur, puis l'anglais. Une page qui ne déclare rien retombe sur le navigateur, exactement comme avant.

<rr0-sighting>#

La vue standard d'une observation

Le choix par défaut pour une observation réelle, à un observateur ou plusieurs. Il compose un <rr0-scene> et ajoute la barre d'outils : qui témoigne, et le panneau i avec les métadonnées de l'observation et ses crédits, et un bouton de partage : le lien qui la rejoue, et ses lignes d'intégration.

<rr0-sighting src="sighting.json"></rr0-sighting>
<rr0-sighting src="case.json"></rr0-sighting>  <!-- un dossier, et tous ses observateurs -->

Un enregistrement qui ne nomme aucun observateur n'affiche aucune ligne « compte rendu de » — ce qui est exact pour un ciel réglé pour montrer un halo.

L'enregistrement de chaque observateur est chargé dès que la liste est connue : en choisir un autre est immédiat. La liste nomme chacun par son title, sinon ses prénoms et son nom, sinon son id ; celui qui ne nomme personne est numéroté selon sa place dans la liste.

Le panneau i s'ouvre en popover, que ferment Échap ou un clic à l'extérieur (seulement un clic à l'extérieur, sur un navigateur sans popover). Il énonce le dossier, la date, le lieu, le compte rendu et les tags ; date, lieu et tags le quittent tant que le bandeau show-labels les énonce déjà. La date est à l'heure de l'observateur (utcOffsetHours, ou une heure approchée depuis la longitude), pas à celle du lecteur. La version en pied de panneau ouvre cette observation dans l'éditeur. La description le quitte aussi tant que les chips sont affichés : elle est dans leur boîte Résumé, qu'un clic ouvre.

Le bouton Partager, parmi ceux du lecteur, ouvre une seule fenêtre qui donne le lien ou le code d'intégration (le code dans un éditeur qui passe à la ligne et qu'on peut modifier), pour le lecteur ou pour l'éditeur, avec les options de la page de partage, chacune proposée telle que le lecteur est. Le code d'intégration charge l'élément depuis l'endroit d'où cette copie a elle-même été chargée : un extrait copié depuis une copie locale ou de recette renvoie à cette copie.

Ce qu'il émet

L'intégrer

<script type="module" src="https://ufoathome.org/lib/rr0-sighting.mjs"></script>
<rr0-sighting src="sighting.json"></rr0-sighting>

sighting.json est un fichier d'observation. Ou, après npm install @rr0/ufoathome : import "@rr0/ufoathome/sighting". Le bundle pèse 249 Ko compressé et enregistre le tag lui-même — rien d'autre à appeler. La présentation plus haut dit ce que cela suppose par ailleurs, et partager une observation a l'exemple complet, à essayer et à copier.

<rr0-scene>#

Le phénomène, le ciel et le sol

La forme dessinée par un observateur, debout dans le ciel, l'horizon, la météo et le sol réels de la date, de l'heure et du lieu de l'enregistrement, cachée par ce qui se tenait devant — avec les commandes de lecture en dessous. C'est l'élément sur lequel les deux autres se construisent.

<rr0-scene src="sighting.json"></rr0-scene>

Le survol nomme ce qui est sous le curseur — une étoile avec sa magnitude et sa hauteur, une planète, une comète, un bâtiment, un autre observateur — et ne dit rien là où le sol cache ce que vous pointez.

Le bouton © dans son coin liste les crédits de ce qu'il montre — l'imagerie du sol et de la carte, les modèles, les photos du lieu, les sons. Dans <rr0-sighting>, ce bouton est masqué : ils sont dans son panneau i.

La lecture, sur ufoElement

Tout ce qui rejoue l'enregistrement vit une propriété plus bas, sur la couche de lecture — scene.ufoElement.play() — la même que les deux autres composants atteignent par leur propre scene.

Ces deux-là sont les seuls défauts positif et négatif de cet élément, et la différence est voulue. Les moments nommés d'un enregistrement sont ses propres mots sur lui-même : ils s'affichent partout où ils existent. La carte, elle, coûte des requêtes de tuiles à un tiers dès la première ouverture, et ce n'est pas à une page de les dépenser au nom d'un lecteur sans le dire. Dans les deux cas le lecteur garde les deux boutons, à côté de celui du plein écran : une page qui pose un défaut n'interdit pas le contraire.

La barre d'outils et les boutons du coin n'apparaissent que tant que le pointeur survole l'image, en lecture comme en pause, ou quand le clavier y amène le focus. Un écran tactile, qui n'a pas de pointeur pour survoler, les garde affichés.

Quand la barre de temps a le focus, les touches font comme sur un site de vidéos : ← recule de 5 s, → avance de 5 s, et Espace lance ou met en pause. Lancer ou mettre en pause, au clavier, au bouton ou d'un clic sur l'image, en montre le signe un instant au milieu de l'image.

Ce qu'il émet

L'intégrer

<script type="module" src="https://ufoathome.org/lib/rr0-scene.mjs"></script>
<rr0-scene src="sighting.json"></rr0-scene>

sighting.json est un fichier d'observation. Ou, après npm install @rr0/ufoathome : import "@rr0/ufoathome/scene". Le bundle pèse 238 Ko compressé et enregistre le tag lui-même — rien d'autre à appeler. La présentation plus haut dit ce que cela suppose par ailleurs, et partager une observation a l'exemple complet, à essayer et à copier.

<rr0-sighting-editor>#

L'éditeur

Tout ce qui précède, plus la barre d'outils de saisie. À poser sur une page où l'on doit pouvoir décrire ou corriger une observation soi-même.

<rr0-sighting-editor></rr0-sighting-editor>
<rr0-sighting-editor src="sighting.json"></rr0-sighting-editor>

Son canevas est une surface d'édition : enableClickToPlay y est désactivé, un clic sélectionne et déplace une forme au lieu de basculer la lecture. Ce que font les huit groupes de sa barre d'outils est sur la page de l'éditeur.

Ce qu'il émet

L'intégrer

<script type="module" src="https://ufoathome.org/lib/rr0-sighting-editor.mjs"></script>
<rr0-sighting-editor></rr0-sighting-editor>

Ou, après npm install @rr0/ufoathome : import "@rr0/ufoathome/editor". Le bundle pèse 293 Ko compressé et enregistre le tag lui-même — rien d'autre à appeler. La présentation plus haut dit ce que cela suppose par ailleurs, et partager une observation a l'exemple complet, à essayer et à copier.

Sources et choix#

Rien de ce que l'outil dessine n'est inventé. Chaque valeur vient d'une source nommée, lue à un moment dit, et là où aucun relevé n'existe l'interface le dit au lieu de combler le vide.

Les principes#

• Une source n'est lue que quand on en a besoin. Les catalogues sont construits une fois dans le dépôt ; les services ne sont appelés que pour un enregistrement qui en a besoin (un lieu, une date dans leur période, un bouton pressé), et jamais pour une date antérieure au début de leur relevé.
• Ce qui peut disparaître est hébergé ici. Les données qu'un tiers pourrait retirer ou qu'un navigateur ne peut pas lire (éléments orbitaux, modèles 3D) sont copiées, réduites, et servies depuis ufoathome.org avec leur crédit, pour toute page qui intègre une scène.
• Le mesuré passe avant le modélisé, et le modélisé avant le supposé. Une brillance est une observation publiée quand il en existe une ; une formule ne comble que ce que personne n'a mesuré, et un objet sans l'un ni l'autre est calculé mais pas dessiné.
• Chaque service est remplaçable. Météo, relief, imagerie, lieu, fuseau, modèles et rédaction passent par un même registre : la source est un choix visible, avec son crédit à côté, et une seconde peut s'ajouter sans toucher au reste.
• Les limites sont dites. Chaque source ci-dessous dit où elle s'arrête : avant 1940 pour la météo, avant 1957 pour les satellites, avant février 2021 pour les passages individuels.

Le ciel · L'air · Satellites · Avions et traînées · Météo · Le sol · Lieu et heure · Décor, photos et son

Le ciel

L'air

La lumière du ciel est calculée, pas dessinée : lumière du Soleil et de la Lune suivie à travers une atmosphère sphérique d'air, de brume et d'ozone à quinze longueurs d'onde, puis montrée comme la verrait un œil adapté ou un appareil photo. Chaque entrée ci-dessous est une mesure ou un modèle publié ; les deux ancres d'affichage sont les seuls choix.

Satellites

Deux niveaux. Pour toute date depuis Spoutnik, ce que permettait l'ombre de la Terre et combien d'objets étaient en orbite. Depuis février 2021, quels satellites ont réellement traversé le ciel, où, et avec quelle brillance.

Avions et traînées

Depuis 2022, les avions qui étaient dans le ciel de l'observateur à l'heure d'un enregistrement, l'air dans lequel ils volaient, et la traînée que leurs moteurs y laissaient. Ce qui est dessiné est un candidat compatible, jamais une identification, et un ciel vide dans le relevé n'exclut rien.

Météo

Le sol

Lieu et heure

Décor, photos et son

Le détail de chaque choix, avec les mesures qui l'ont décidé, est dans les commentaires du code de chaque source.