Istruzioni tecniche per gli editori

Nota del 22.12.2016: le specifiche tecniche che seguono in questo pagina sono in corso di aggiornamento. 

Per partire con la sperimentazione sono offerte inizialmente due modalità:

  • 1. raccolta automatica (o harvesting) delle pubblicazioni da parte di MD a partire da un repository che espone i metadati attraverso il protocollo OAI-PMH;
  • 2. invio telematico delle risorse a MD effettuato direttamente dal depositante

1. Raccolta automatica

Per la raccolta automatica verrà messa a disposizione una procedura analoga a quella prevista per le tesi di dottorato

2. Invio telematico

Per rendere la sperimentazione applicabile in tempi brevi Magazzini Digitali ha deciso di adottare il formato di aggregazione BagIt In pratica i file da inviare a Magazzini Digitali dovranno essere aggregati in un unico file (zip o tar) rispettando alcune semplici regole previste dal formato BagIt. Per facilitare il trattamento da parte di Magazzini Digitali è richiesto inoltre che i file che veicolano la pubblicazione da depositare siano accompagnati anche dai relativi metadati descritttivi. L’abbinamento tra dati e metadati avviene con una semplice convenzione di denominazione dei nomi di file: il nome del file che contiene i metadati avrà lo stesso nome del file contenente i dati con l’aggiunta finale dell’estensione .metadata Anche se i metadati sono in molti casi inclusi nel file di dati (ad esempio perché previsto dal formato) si ritiene importante che i metadati descrittivi di base siano sempre evidenziati in un file autonomo. La sintassi dei metadati dovrà essere in formato XML. Sono accettati i formati più diffusi come per esempio DC,ONYX, MAG, DIDL, MARC21XML (scrivere a Magazzini Digitali per il supporto di altri formati) L’invio del BagIt avviene al momento esclusivamente tramite posta elettronica all’indirizzo bagitatdepositolegaledotit. Effettuati i controlli di validità Magazzini digitali invierà una “ricevuta di ritorno” contenente il manifest del BagIt. La pagina che segue presenta un esempio di BagIt

Un_Bagit_pronto_per_essere_inviato
|
| manifest-md5.txt
| (49afbd86a1ca9f34b677a3f09655eae9 data/Via_con_il_vento.pdf )
| (408ad21d50cef31da4df6d9ed81b01a7 data/Via_con_il_vento.pdf.metadata)
| …. altri file inviati (md5 data/ …)
|
| bagit.txt
| (BagIt-version: 0.96 )
| (Tag-File-Character-Encoding: UTF-8 )
|
--- data/
|
| Via_con_il_vento.pdf [1]
| (... byte del contenuto ..
|
| Via_con_il_vento.pdf.metadata [2]
| (... byte del contenuto …. )
|
| altre sequenze di file_a.estensione_b, file_a.estensione_b.metadata [3]
[1] Sono accettati formati standard e non protetti da DRM (per esempio PDF/A, EPUB). I formati saranno validati da validatori quali Jhove Droid ecc . E’ richiesto almeno un file per considerare valido il file Bagit ai fini del deposito

[2] Medatati in formato XML (per esempio DC,ONYX, MAG, DIDL, MARC21XML) Anche se i metadati possono essere inclusi nel file di dati [1] si ritiene importante che i metadati descrittivi di base siano sempre evidenziati in un file autonomo. I metadati verranno messi in relazione con i dati tramite la convenzionale aggiunta del .metadata al nome di file contenenti i dati: file_a.estensione_b (contiene i dati) file_a.estensione_b.metadata (contiene i metadati del file_a.estensione_b)

E’ richiesto almeno un file di metadati che rispetti la nomenclatura convenzionale (aggiunta di .metadata al nome del file che contiene i dati) per considerare valido il Bagit ai fini del deposito

[3] Nota: BagIt non prevede limiti di grandezza del file. Visto tuttavia che – almeno nelle prime fasi della sperimentazione – l’invio verrà effettuato tramite posta elettronica non vanno superati i limiti di 25 Megabyte per invio (limite del nostro sistema di posta elettronica)

Si segnala qui una raccolta di tools open source per la produzione di un file BagIt