The installation instructions assume that the installation is done on a Windows computer.

• genericode-transformer: clone this repository on your local machine (no releases are available at the moment);
• Java:
  • Ensure you have a Java 11 (or later) installation;
  • Ensure that environment variable JAVA_HOME is set and points to that Java installation;
• Saxon:
  • Download and unzip the XSLT 3 processor Saxon into a suitable directory;
  • Set environment variable SAXON_CP to the location of the principal Saxon jar file, saxon-he-x.y.jar;
• Morgana:
  • Download and unzip the XProc 3 processor Morgana into a suitable directory;
  • Add the path to that directory to your user's Path environment variable;
  • Place a copy of jar file saxon-he-x.y.jar in the MorganaXProc-IIIse\MorganaXProc-IIIse_lib folder.
• AsciidoctorJ:
  • Download and unzip AsciidoctorJ into a suitable directory;
  • Add the path to that directory to your user's Path environment variable.
• schxslt:
  • Download the Schematron processor schxslt (schxslt-x.y.z-xslt-only.zip), extract the zip file and move the contents to an appropriate place.
• XSpec (only needed for development):
  • Download/clone the unit testing framework XSpec
  • Set the environment variable XSPEC_HOME to the location where XSpec is stored.

Create a file morgana-config.xml file in folder local-scripts.

<morgana-config xmlns="http://www.xml-project.com/morganaxproc">	
	<XSLTValidationMode>LAX</XSLTValidationMode>
	
	<!-- See "Selecting the XSLTConnector" on https://www.xml-project.com/manual/ch02.html#configuration_s1_1_s2_2 -->
	<xslt-connector>saxon12-3</xslt-connector>
    
	<!-- See "Selecting the Schematron processor" on https://www.xml-project.com/manual/ch02.html#configuration_s1_1_s2_5 -->
	<schematron-connector>schxslt</schematron-connector>
	<path_to_SchXSLT_2>file:///path/to/schxslt-x.y.z/2.0</path_to_SchXSLT_2>
    
	<!-- See "Adding media type mappings" on https://www.xml-project.com/manual/ch02.html#configuration_s1_5 -->
	<mediatype-mapping>
		<map file-extension="gc" media-type="application/xml" />
	</mediatype-mapping>	
    
</morgana-config>

Customize morgana-config.xml:

• Customise the value of element xslt-connector to match the value specified for your version of Saxon as specified in https://www.xml-project.com/manual/ch02.html#configuration_s1_1_s2_2;
• Customise the path in element path_to_SchXSLT_2.

To check your configuration, run batch file print-configuration.bat in folder scripts from the root directory of the working tree of your local repository:

scripts\print-configuration.bat

The output will show the versions of the applications needed by the sripts.

The usage instructions assume that the application is used on a Windows computer.

To update the publication details of a genericode code list, run batch file update-publication-details.bat in folder scripts from the root directory of the working tree of your local repository:

scripts\update-publication-details.bat "C:\path\to\codelist.gc" https://example.org/codelistregister/subregister/

To generate a whole code list register site, run batch file generate-code-list-register-site.bat in folder scriptsfrom the root directory of the working tree of your local repository:

scripts\generate-code-list-register-site.bat "C:\path\to\local\copy\of\codelisteregister" "https://example.org/codelistregister/" "C:\path\to\report.xml"

The generated report will contain additional information, such as the validation errors of the Atom feeds generated, if the validation failed.

If you want to overwrite existing CSV, HTML and Atom encodings of the code list versions, invoke the batch file as follows:

scripts\generate-code-list-register-site.bat "C:\path\to\local\copy\of\codelisteregister" "https://example.org/codelistregister/" "C:\path\to\report.xml" true

Run the batch file without arguments to see all the options:

scripts\generate-code-list-register-site.bat

The XSLT stylesheets are tested using XSpec, a unit test and behaviour-driven development (BDD) framework for XSLT, XQuery, and Schematron.

On Windows, the XSpec XSLT tests can be run using the batch files in the scripts folder. Run the batch files from the root directory of the working tree of your local repository, for instance:

scripts\run-xslt-tests.bat

Genericode, also known as Code List Representation, is “a single semantic model for code lists and accompanying XML serialization that is designed to IT-enable and standardize the publication of machine-readable code list information and its interchange between systems”¹. Genericode is developed by the Organization for the Advancement of Structured Information Standards (OASIS). See the website of the OASIS Code List Representation TC for more information.

Xproc is an XML based programming language for processing documents in pipelines. XProc 3 is developed by the XProc Next Community Group, a community group of the World Wide Web Consortium (W3C).