Questo HOWTO spiega come inserire i metadati relativi alle licenze Creative Commons in un file PDF. Documento v. 2.0 Autore: Enrico Masala < masala at-symbol polito dot it > Data: Lug 12, 2006 1. Copyright, licenza e termini d'uso Copyright Enrico Masala 2006. Questo lavoro e' rilasciato sutto la licenza Creative Commons Attribuzione - Non commerciale - Condividi allo stesso modo 2.5 Italia http://creativecommons.org/licenses/by-nc-sa/2.5/it/deed.it Le informazioni riportate in questo documento sono fornite senza alcuna garanzia esplicita o implicita di alcun tipo e, in particolare, ma non esclusivamente, nessuna garanzia implicita sulla commerciabilità, l'idoneità a uno scopo particolare e la non violazione delle norme di utilizzazione. L'autore in nessun caso può essere ritenuto responsabile relativamente a qualsiasi danno incidentale, diretto, indiretto o consequenziale (inclusi danni per perdita di profitto, interruzioni dell'attività lavorativa, perdita di informazioni o qualsiasi altra perdita) derivanti dall'uso o collegati all'uso di questo documento. In breve: leggi e usa a tuo rischio e pericolo. 2. Descrizione Questo documento spiega la mia esperienza nell'inserire informazioni di licenza in file PDF. Inserire informazioni di licenza nei file PDF e' importante perche' consente ai motori di ricerca specificatamente programmati (quali Google e Yahoo) di riconoscere e ritornare questi file quando essi sono interrogati per trovare contenuti con una certa specifica licenza (in particolare Creative Commons), e gli utenti non rischieranno di usare alcun lavoro in un modo che l'autore originario non consente. 2.1 Introduzione Il formato PDF consente di inserire dei metadati nella forma di informazioni codificate in Extensible Metadata Format (XMP). (vedere http://partners.adobe.com/public/developer/xmp/topic.html per ottenere maggiori informazioni sull'XMP) I metadati XMP sono scritti usando una sintassi che e' un sottoinsieme del World Wide Web Consortium Resource Description Framework (RDF), che a sua volta e' basato sull'XML. Il sito di Creative Commons (http://www.creativecommons.org) consente di scaricare la descrizione XMP della licenza in cui si e' interessati. Una volta selezionata la licenza, cercate semplicemente questa frase: "To mark a PDF or other XMP-supported file, save this template following these instructions". Il file XMP che ho scaricato per la licenza Attribution-NonCommercial-ShareAlike 2.5 e' qui riportato: True http://creativecommons.org/licenses/by-sa/2.5/ This work is licensed to the public under the Creative Commons Attribution-ShareAlike 2.5 License. 2.2 Come inserire le informazioni XMP 2.2.1 Soluzione 1: Usare Adobe Acrobat 7 Professional Prima di tutto, aprire il documento PDF, poi scegliere "Document Properties", poi "Additional Metadata", poi "Advanced" nella parte sinistra della finestra. Usare il bottone "Append" per selezionare il file xmp. Sfortunatamente non sono stato in grado di importare il file XMP mostrato precedentemente in Acrobat. Semplicemente non sembrava funzionare, e il programma non mostrava nessun messaggio di errore o di avvertimento. Dopo molti tentativi e un po' di intuizione, sono riuscito a farlo funzionare come segue: correggete tutti i rdf:rdf in rdf:RDF correggete tutti i description in Description correggete tutti i xaprights in xapRights correggete tutti i marked in Marked correggete tutti i webstatement in WebStatement correggete tutti i alt in Alt (Sembra che le maiuscole/minuscole siano importanti) In ogni caso, Adobe Acrobat 7 Professional consente di specificare le informazioni di copyright a mano. Selezionare l'elemento "Description" nella parte sinistra della finestra, poi si puo' specificare: - Copyright status (selezionare: copyrighted) - Copyright notice (scrivere: "This work is licensed to the public under the Creative Commons Attribution-ShareAlike 2.5 License." o qualsiasi altra cosa dica la vostra licenza) - URL: (scrivere: "http://creativecommons.org/licenses/by-nc-nd/2.5/" o qualsiasi altra cosa dica la vostra licenza). Ho anche scaricato il Pannello CreativeCommons Panel da http://creativecommons.org/technology/CreativeCommonsPanel.txt che aggiunge un elemento CreativeCommons nella parte sinistra della finestra. (seguire le istruzioni a http://creativecommons.org/technology/xmp-help per copiare il file nella giusta directory) ma non sono riuscito a usarlo per inserire le informazioni. Comunque, le informazioni Creative Commons vengono mostrate correttamente una volta che sono inserite come ho descritto. Ricordate di premere il bottone OK per chiudere le finestre ed infine salvare il file per memorizzare le informazioni nel file. 2.2.2 Soluzione 2: Usare il programma PdfLicenseManager Ho scritto un semplice programma, chiamato PdfLicenseManager, vedi http://media.polito.it/masala/pdflicensemanager/index.html Questo programma e' scritto in Java ed e' basato sulla libreria iText (http://www.lowagie.com/iText/) che semplifica la gestione dei PDF. Il programma PdfLicenseManager e' scritto in Java quindi puo' essere fatto girare su qualsiasi piattaforma che supporti Java, incluso Linux e la maggior parte degli UNIX. La versione 2.0 ha un'interfaccia grafica che semplifica l'utilizzo del programma. Fate riferimento al file README.txt che viene insieme al programma per ulteriori istruzioni. Le seguenti istruzioni si applicano ancora a PdfLicenseManager v. 2.0 se volete usare l'interfaccia a linea di comando (molto utile per gli scripts). Assumendo che abbiate scaricato la libreria itext nella directory corrente, potete scrivere: java -classpath itext-1.4.2.jar:. pdflicense.ManagePdfLicense put filein.pdf fileout.pdf by-nc per prendere il conenuto di filein.pdf, inserire una licenza Creative Commons Attribution-NonCommercial e scrivere il file risultante nel file fileout.pdf Per mostrare le informazioni XMP di licenza associati a file.pdf, scrivere: java -classpath itext-1.4.2.jar:. pdflicense.ManagePdfLicense show file.pdf Vedere il README.txt del programma PdfLicenseManager per maggiori informazioni. 2.3 Mostrare i medatati Si possono mostrare i metadati che avete inserito usando: - Acrobat 7 Professional (scegliere "Document Properties", poi "Additiona Metadata" come nella descrizione fatta per l'inserimento dei dati). Non sono stato in grado di mostrare i metadati (di licenza) usando Acrobat 7 _Reader_, quindi credo che sia necessario la versione Professional. - pdfinfo Se usate Linux, potete mostrare l'informazione grezza XMP (cioe' in XML) che e' contenuta nel file PDF digitando: pdfinfo -meta file.pdf (Questo programma e' disponibile con il pacchetto poppler-utils di Fedora Core 5 - Poppler, a PDF rendering library, it's a fork of the xpdf PDF viewer) - PdfLicenseManager (vedere la sezione precedente) 3. Crediti Grazie a Juan Carlos De Martin che ha avuto l'idea di scrivere e pubblicare questo HOWTO.