Home

RiC-O Converter

Welcome to the RiC-O converter documentation ! RiC-O converter is a command-line tool to convert EAD and EAC files to RDF files expressed using Records in Contexts ontology.

The tool can be downloaded from the release section of the Github repository of the converter.

Table of Contents

The documentation is divided in these sections :

About RiC-CM, RiC-O

• RiC-CM and RiC-O: start here to learn more about Records in Contexts - Conceptual Model and Ontology ;
• About the RiC-O converter project: get an understanding of the RiC-O converter project;
• Mappings: learn how EAD and EAC files are mapped to Records in Contexts Ontology by this conversion tool.

Technical documentation of RiC-O converter

• Getting Started: start here to test drive the converter, understand the directory structure, learn how to print help message and adjust the command parameters;
• Conversion: main documentation for the EAD and EAC conversion process;
• Running unit tests: explains how to run the unit tests of the converter;
• Customize the conversion: explains how to customize the conversion for your own files;
• Common Problems: give answers to common problems;
• Compile ricoconverter: if you need to adjust something in the Java code and recompile, read this.

Reference lists of error codes

• Error Codes: reference list of the error codes of the application;
• EAC XSLT Error Codes: reference list of the possible error codes during EAC conversion;
• EAD XSLT Error Codes: reference list of the possible error codes during EAD conversion.

Licence

This project is licensed under the terms of the CeCILL-B license (equivalent to MIT license and close to a public domain license) (see the license file in english or in french).

Contact

If you have questions on RiC-O converter, you can contact :

• Florence Clavaud, head of the Lab at the Archives nationales de France, who also leads the development of RiC-O ontology;
• Thomas Francart at Sparna, developer of RiC-O converter (blog).