Inserire un libro, senza perdere il filo.

Il percorso più rapido

1. Estrai l’intera cartella dallo ZIP e apri admin.html con Chrome o Edge. Mantieni i file nella stessa cartella.
2. In Cerca un libro, incolla l’ISBN stampato sul libro oppure scrivi titolo e autore. I dati automatici arrivano da Open Library e, se collegato, Google Books. Puoi aggiungere il nome dell’autore nel campo dedicato.
3. Apri Controlla questi dati. Verifica titolo, autore, editore, anno e ISBN rispetto alla tua edizione. Seleziona i campi da usare e conferma il controllo.
4. Scegli lo scaffale. Titolo, autore e scaffale sono obbligatori; puoi completare il resto in seguito.
5. Carica, trascina o incolla la copertina. Premi Salva e aggiungi un altro per continuare oppure Salva scheda per restare sul libro.

La ricerca online non copre tutte le edizioni e può essere temporaneamente indisponibile. In Compila tu puoi lavorare anche senza Internet. Non viene inventato alcun dato mancante.

Quando un libro non si trova

La ricerca non dipende più da un solo percorso. Dopo aver scritto titolo o ISBN, usa i pulsanti Google Books, IBS, Libraccio (via Google), SBN (via Google) o Cerca nel web. Aprono la ricerca già compilata in una nuova scheda e non richiedono collegamenti o chiavi. I collegamenti “via Google” cercano nelle pagine del sito indicato.

Se trovi il libro sul sito dell’editore o di una libreria, copia i dati e apri Ho trovato il libro altrove: incolla la scheda. Il pannello riconosce le etichette Titolo, Autore o Curatore, Editore, Anno, Pagine, Lingua ed EAN/ISBN. Sono accettati sia “Editore: Il Mulino” sia etichetta e valore su righe separate. I dati senza etichetta non vengono indovinati, tranne un ISBN univoco e valido. Se ci sono valori contrastanti, il campo viene escluso e segnalato.

Aggiungi l’indirizzo della pagina di origine e premi Riconosci i dati. La stessa anteprima permette di scegliere quali campi trasferire. Completa quelli mancanti nel modulo. Il testo incollato serve solo per preparare la scheda e non entra nel backup finché non trasferisci i campi.

Per importare automaticamente risultati di Google Books, apri Collega la ricerca automatica Google Books e inserisci una tua chiave Google Books API. Viene conservata solo nella sessione della scheda del browser, non nei file esportati. Il pannello invia la chiave esclusivamente all’API Google Books. Configura la chiave per la sola Books API e, per il sito pubblicato, limita i referrer secondo la documentazione Google. Senza chiave, il pulsante Google Books apre comunque il sito; non è prevista importazione automatica anonima. Quote, chiavi errate e indisponibilità sono mostrate accanto al nome della fonte.

La ricerca automatica offre 12 risultati per fonte e pagina, il pulsante Mostra altri risultati e un filtro per le edizioni italiane. I risultati di fonti diverse restano distinti, così puoi controllare le eventuali discrepanze. Gli ISBN non corrispondenti a quello cercato sono esclusi dai risultati Google.

Controlli che aiutano a essere precisi

Gli ISBN a 10 e 13 cifre vengono verificati con il codice di controllo. Spazi, trattini, caratteri invisibili e codici HTML copiati dai siti sono accettati. Puoi incollare insieme le righe ISBN-10 e ISBN-13 se identificano la stessa edizione; codici diversi vengono rifiutati. Il pannello mostra il codice riconosciuto prima della ricerca; due formati dello stesso ISBN vengono riconosciuti come duplicati. Un codice valido non dimostra da solo che il libro sia quello corretto.

Lo stesso ISBN non può essere aggiunto due volte: modifica la scheda esistente. Se titolo e autore coincidono, puoi confermare una seconda edizione o copia con ISBN diverso o assente. I filtri Da completare aiutano a trovare anno, ISBN, descrizione o copertina mancanti.

L’anno è quello dell’edizione posseduta, non necessariamente la prima pubblicazione dell’opera. La ricerca per titolo propone alcune edizioni, non un elenco completo: usa l’ISBN se l’edizione cercata non compare.

In questa consegna i dati bibliografici e le descrizioni dei 91 libri originali sono stati conservati, senza una verifica individuale delle fonti. Restano 41 schede senza anno. I dati nuovi proposti online richiedono il tuo controllo.

Copertine e dettagli

Puoi usare immagini JPG, PNG, WebP o GIF fino a 12 MB. Il pannello le converte in una copertina di 400 × 600 pixel, mantenendo le proporzioni e l’intera immagine. Le GIF vengono rese come immagine statica. La copertina è incorporata nel catalogo: non devi scaricarla né copiarla in img.

Le copertine indicate con un link, incluse quelle di Open Library, restano collegate alla fonte: richiedono Internet e possono diventare non disponibili. Per incorporarle, carica un’immagine che hai sul computer. I percorsi img/nome-file.webp richiedono che quel file sia presente nella cartella del sito.

La sezione Descrizione, temi e altri dettagli contiene categoria, tag, pagine, lingua, nota di lettura e fonte. Nota, descrizione, collocazione e dati bibliografici sono visibili al pubblico dopo la pubblicazione.

Importare un elenco o recuperare un backup

1. Apri Importa un elenco e scarica il modello CSV.
2. Compilalo con Excel o un altro foglio di calcolo. Mantieni gli ISBN come testo. Salva in formato CSV UTF-8.
3. Scegli il file. Se alcune righe non hanno scaffale, puoi assegnarne uno comune.
4. Controlla le righe: quelle non valide e gli ISBN duplicati sono esclusi; i titoli simili richiedono una selezione esplicita.
5. Premi Aggiungi i libri selezionati. L’importazione aggiunge libri e non aggiorna quelli esistenti.

Puoi importare anche un books.js esportato da questo pannello o dalla versione fornita. Il file viene letto come dati JSON, senza eseguire codice. I CSV possono contenere al massimo 2.000 righe per importazione; i file devono essere inferiori a 35 MB.

Un backup JSON contiene catalogo, copertine e scheda in corso. Se lo importi puoi scegliere di ripristinare tutta la bozza, oppure annullare il ripristino e selezionare singoli libri da aggiungere. Prima di sostituire la bozza viene preparato un backup della sessione attuale: controlla che il browser lo abbia scaricato. Usa JSON per i backup completi; CSV è pensato per gli elenchi e non conserva tutti i metadati.

Dalla bozza al sito

1. Salva la scheda in corso.
2. Apri Anteprima bozza per vedere come apparirà il catalogo. Il banner indica che stai guardando una bozza non pubblicata.
3. Premi Esporta catalogo. Il browser scarica books.js.
4. Sostituisci data/books.js nella cartella del sito. Se il browser lo chiama books (1).js, rinominalo esattamente books.js.
5. Pubblica la cartella aggiornata sul tuo hosting con la procedura abituale.

Su browser compatibili compare Salva direttamente nel file…: scegli il file data/books.js nella tua cartella locale. Il browser chiederà il permesso di scriverlo. Anche questo passaggio non pubblica il sito.

Per il primo aggiornamento dalla vecchia versione, pubblica tutta questa nuova cartella, che contiene anche i nuovi file del pannello. Per i successivi inserimenti è sufficiente aggiornare data/books.js.

Non perdere la bozza

Il pannello salva automaticamente la scheda in corso e il catalogo nella memoria del browser. Sono distinti: i cambiamenti nella scheda entrano nel catalogo solo premendo Salva. Prima di esportare, il pannello segnala le modifiche non ancora aggiunte.

Usa lo stesso browser, profilo e indirizzo. Spostare la cartella, cambiare browser o cancellarne i dati può rendere la bozza non disponibile. Scarica regolarmente il Backup completo JSON, soprattutto prima di cambiare computer o aggiornare il progetto. La vecchia bozza viene recuperata automaticamente solo se è accessibile nello stesso contesto del browser; altrimenti esporta il vecchio books.js e importalo qui.

Lavora in una sola scheda di gestione alla volta. Se viene rilevata una modifica da un’altra scheda, il pannello sospende il salvataggio per non sovrascriverla. In caso di errore di memoria, mantieni aperta la pagina e scarica un backup: non considerare salvati i dati finché l’avviso persiste.

Annulla ultima operazione ripristina l’ultima aggiunta, modifica, eliminazione o importazione effettuata nella sessione. Non è una cronologia permanente. Il sito resta statico: non c’è sincronizzazione tra dispositivi, account amministratore o salvataggio online.