← Documentation

Partager une observation

Les deux partent de la même chose : un enregistrement, à une URL. Rien n'est téléversé ici et il n'y a pas de compte — le fichier reste le vôtre, où que vous le gardiez.

Comment elle s'ouvre#

Le bouton Partager du lecteur donne les mêmes deux choses que cette page, sur un seul écran : le lien ou le code d'intégration, pour le lecteur ou pour l'éditeur ouvert sur le même enregistrement. Les options ci-dessous sont celles qu'il propose, chacune partant de l'état du lecteur à cet instant ; elles s'appliquent au lien et au code des sections suivantes.

Ce que chacune écrit#

OptionDans l'adresseSur l'élément
Commencer n secondes après le début (ou 1:30, 1m30s, PT1M30S)d=nstart-time="n"
Commencer à une heure dite pendant l'observation (02:33:15, ou 2026-08-11T02:33:15)t=02:33:15start-clock="02:33:15"
Afficher les chipsrien — ils sont affichés ; labels=0 les masqueshow-labels
Ouvrir la cartemap=1show-observer-map
Afficher les momentsmoments=0 les masquehide-milestones quand décoché
Comparer au compte renducompare=1compare-account
Ouvrir un dossier sur l'un de ses enregistrementsobserver=IdObservateur (ou un nom de fichier, ou son rang dans la liste)observer="IdObservateur"

Les chips de résumé sont le bandeau de ce que l'enregistrement énonce, sous l'image : la date dite en toutes lettres avec son jour de la semaine, la position, l'observateur, la météo, et un chip Description qui montre les premiers mots du récit et ouvre le texte entier à la place des chips (une croix les rend). La page du lecteur les affiche sauf avec labels=0 ; l'élément lui-même ne les affiche qu'avec show-labels. L'éditeur ne prend aucune option, seulement l'enregistrement.

Le plus simple des deux, et le seul qui n'exige rien de l'endroit où vous l'envoyez. Qui le suit voit l'observation jouée sous le ciel réel de la date et du lieu qu'elle énonce, dans sa propre langue.

Essayer

Bon pour un courriel, un message, un commentaire, un forum qui n'accepte que du texte — partout où l'on peut mettre une URL. Le champ ci-dessus part d'un enregistrement de ce site pour que le bouton fasse quelque chose ; l'adresse que vous y mettez est la vôtre, sur votre hébergement, et ce site n'en a jamais besoin d'une copie.

Là où le lien s'affiche en carte (réseau social, messagerie, forum qui déplie les liens), la carte peut en dire plus que le logo du projet. Le serveur lit votre fichier quand le lien est consulté : la carte montre le nom de l'observation, son image (une adresse, absolue ou relative au fichier) et son summary (une phrase ou deux, en simple texte ou une par langue). Sans summary, la carte dit qui l'a vue, dans quel dossier et quand, autant que le fichier et son adresse le disent ; sans image, elle montre le logo. Un fichier de dossier prend les deux mêmes champs. summaryTime (secondes) dit à l'outil de capture du projet quel instant de la simulation photographier pour l'image, quand le premier ne montre pas le phénomène.

2. Dans votre propre page#

Deux lignes de HTML posent la reconstitution elle-même dans votre page, comme on y pose une vidéo. Aucun framework, et rien à construire pour votre site.

Le résultat :

C'est un élément vivant, pas une image — celui-là même que ces deux lignes vous donneraient. Lequel des trois composants employer à la place, et tout ce qu'on peut leur dire, est sur la page des composants.

L'adresse du script ne porte pas de version : votre page suit donc chaque version sans être modifiée. Les navigateurs demandent à chaque visite s'il a changé, et la réponse ne coûte rien tant qu'il n'a pas changé.

Ce qu'il faut à un enregistrement pour être partageable#

Une chose : une adresse publique. N'importe où un navigateur peut aller la chercher — un site statique, un hébergeur de fichiers, les pages d'un dépôt. Un fichier sur votre disque n'a pas d'URL que quelqu'un d'autre puisse suivre, et c'est là la seule vraie exigence.

Si l'adresse est publique, s'ouvre bien dans votre propre navigateur, et que le lecteur dit malgré tout n'avoir pas pu la lire, la cause est presque toujours la même : le serveur ne dit pas aux navigateurs que d'autres sites ont le droit de lire le fichier. Le remède est un en-tête de réponse, Access-Control-Allow-Origin: *, sur le JSON. La plupart des hébergements statiques — GitHub Pages, Netlify, S3 — l'envoient déjà ou permettent de l'ajouter en une ligne de configuration ; si le serveur n'est pas le vôtre, c'est la seule chose à demander à son administrateur. Le lecteur et l'éditeur le disent quand ils le détectent, vous ne devriez donc pas avoir à le deviner.

Nulle part où le poser encore ? L'éditeur accepte aussi un enregistrement collé directement, ce qui suffit à en vérifier un avant de le publier — mais un enregistrement collé ne se partage évidemment pas par lien.

Pas d'enregistrement du tout ? Créez-en un ; ce que contient le fichier est décrit sur la page du fichier d'observation.