Sette pagine

Documentazione di UFO@home

Che cos'è un caso ufologico e cosa contiene, come creare un'osservazione, come condividerla o integrarla e da dove vengono i suoi dati. Ordinate secondo la domanda posta: scegli la tua.

Capire#

Che cos'è un caso ufologico?

Cosa riunisce un caso, i tre tipi di evento che contiene (osservazioni, interpretazioni, interviste) e come possono essere collegati.

Le osservazioni

Che cos'è un'osservazione, poi che cosa contiene il suo file, campo per campo. Con un esempio completo.

Le interviste

Cosa contiene un'intervista di un caso: l'evento, la sua trascrizione, i passaggi rimossi, chi l'ha approvata, i legami con l'osservazione e l'importazione di una trascrizione da un altro formato.

Fare#

Creare un'osservazione

Nell'editor, o scrivendo tu stesso il file. Entrambi producono la stessa cosa: un file JSON che è tuo.

Creare un'interpretazione

Nell'editor di casi, o nel file del caso: una spiegazione alternativa di ciò che è stato visto, come osservazione a parte.

Creare un'intervista

Nell'editor di casi, o nei file: chi ha preso parte, come, e la trascrizione se c'è.

Un link da inviare, o due righe di HTML sulla tua pagina. Entrambi con un esempio funzionante da provare e copiare.

Ottenere i sorgenti#

Per fare il debug di un comportamento, cambiare qualcosa, o partire da questo codice e farlo tuo.

git clone https://github.com/RR0/UfoAtHome.git
npm install
npm run dev          # demo locale, server di sviluppo Vite
npm test             # vitest
npm run build:all    # i tre bundle di integrazione

I cataloghi sono generati, non scritti a mano: npm run build:stars (HYG), npm run build:comets (JPL Horizons), npm run build:novae (le curve di luce dell'AAVSO e le supernove storiche) e npm run build:satellites (il SATCAT di CelesTrak) ricostruiscono ciascuno il proprio dalla sua fonte pubblica, così che i dati sono riproducibili oltre che leggibili. npm run build:tle riduce una copia locale dell'archivio di elementi orbitali di Laurent Chabin (ufowaves.org) ai file settimanali serviti sotto /tle/.

Queste pagine sono il riferimento. Il README dice cosa serve per contribuire: installare, ricostruire i dati, testare, fare il debug, pubblicare; il ragionamento dietro ogni scelta è nei commenti del codice. Tutto è sotto licenza MIT — vedi le FAQ per sapere cosa ti consente di fare.