Sept pages

Documentation d'UFO@home

Ce qu'est un dossier ufologique et ce qu'il contient, comment créer une observation, comment la partager ou l'intégrer, et d'où viennent ses données. Rangées par la question posée : prenez celle qui est la vôtre.

Comprendre#

Qu'est-ce qu'un dossier ufologique ?

Ce qu'un dossier réunit, les trois sortes d'événements qu'il contient (observations, interprétations, interviews) et comment ils peuvent être liés.

Les observations

Ce qu'est une observation, puis ce que contient son fichier, champ par champ. Avec un exemple entier.

Les interviews

Ce que contient une interview d'un dossier : l'événement, sa transcription, les passages retirés, qui l'a approuvée, les liens avec l'observation, et l'import d'une transcription d'un autre format.

Faire#

Créer une observation

Dans l'éditeur, ou en écrivant le fichier vous-même. Les deux produisent la même chose : un fichier JSON qui est le vôtre.

Créer une interprétation

Dans l'éditeur de dossier, ou dans le fichier de dossier : une explication alternative de ce qui a été vu, comme une observation à part.

Créer une interview

Dans l'éditeur de dossier, ou dans les fichiers : qui y a pris part, comment, et la transcription si vous en avez une.

Un lien à envoyer, ou deux lignes de HTML sur votre propre page. Les deux avec un exemple qui marche, à essayer et à copier.

Installer les sources#

Pour déboguer un comportement, changer quelque chose, ou partir de ce code et en faire le vôtre.

git clone https://github.com/RR0/UfoAtHome.git
npm install
npm run dev          # démo locale, serveur de développement Vite
npm test             # vitest
npm run build:all    # les trois bundles d'intégration

Les catalogues sont engendrés, pas saisis à la main : npm run build:stars (HYG), npm run build:comets (JPL Horizons), npm run build:novae (les courbes AAVSO et les supernovae historiques) et npm run build:satellites (le SATCAT de CelesTrak) reconstruisent chacun le sien depuis sa source publique — la donnée est donc reproductible autant que lisible. npm run build:tle réduit une copie locale de l'archive d'éléments orbitaux de Laurent Chabin (ufowaves.org) aux fichiers hebdomadaires servis sous /tle/.

Ces pages sont la référence. Le README dit ce qu'il faut pour contribuer : installer, reconstruire les données, tester, déboguer, publier ; le raisonnement derrière chaque choix est dans les commentaires du code. Tout est en MIT — voir la FAQ pour ce que cela vous autorise.