Libri augmentati

XProc 3.0 Libraries for Digital Books Download and Enrichment

This software downloads all available (or selected) data and metadata, like MODS, FOXML, DC, ALTO, and images, from digital libraries based on the system Kramerius and stores it on the local system.

At this time, Librari augmenti only supports digital libraries provided by Moravian Library in Brno (Kramerius version 7) and National Library (Kramerius version 5). Further libraries can be added to the libraries.xml settings file. See registry of all running instances of the Kramerius system.

Prerequisites

• Java 11
• Saxon-HE 12.3
• MorganaXProc-IIIse 1.4.5

TODO list

• Install Java JDK 11
• Extract content of the MorganaXProc-IIIse-1.4.5.zip
• Extract content of the SaxonHE12-3J.zip file
  • copy extracted saxon-he-12.3.jar and saxon-he-xqj-12.3.jar files to the MorganaXProc-IIIse_lib folder
• On your operating system, set environment PATH variable to point to the location of the MorganaXProc-IIIse folder
• for example on Windows:
  • (run command line as administrator): setx /m PATH "%PATH%;C:\Programs\MorganaXProc-IIIse"
  • (run command line as usual user): setx PATH "%PATH%;C:\Programs\MorganaXProc-IIIse"

How to use it

Clone the repository using Git

git clone https://github.com/moravianlibrary/libri-augmentati.git

or download zipped version of the repository.

Go to the run folder of this project and run one of the following command:

• sample-book.cmd uses sample-book.xpl pipeline for downloading and processing digital book from Moravian Library in Brno.
• in the client.cmd file you can set parameters of the book to be processed; this batch file uses client.xpl pipeline
• in the client-mzk.cmd file change -option:document-id and -option:nickname argument and download (meta)data from Moravian Library in Brno
• in the client-nkp.cmd file change -option:document-id and -option:nickname argument and download (meta)data from National Library
• test-samples.cmd uses test-samples.xpl pipeline for downloading and processing all used as a sample in the libraries.xml settings file

After the data processing, a report (report.html) is generated in the selected folder from which you can access all the data locally or online in the original digital library.

When viewing a title in a digital library, you can find the document-id of the publication in the URL. For example, the sample book is accessible via https://www.digitalniknihovna.cz/mzk/view/uuid:de87a0e0-643b-11ea-a744-005056827e51?page=uuid:73648039-1b21-4921-9b08-13161ae6d239. For the document-id use the first unique identifier, UUID, after /view/, in this case uuid:de87a0e0-643b-11ea-a744-005056827e51.

Or you can go through the sharing dialog where you have to select the book to share:

Acknowledgment

The software was funded by the Institutional support for long term conceptual development of a research organization (The Moravian Library) by the Czech Ministry of Culture.