Mapping ODD processing

This page is intended to help us map out and document the various processing steps that are applied to ODD files, both in the current Stylesheets and in a future alternative ODD processor. The main goal is to document the steps in generating TEI schemas from a TEI customization ODD file. However, processing P5 itself is part of that process. And although not our primary goal, we hope to also provide documentation for generating custom documentation from a TEI customization ODD file.

An italicized name in column A (NAME) indicates a step that is performed for building P5, but not necessarily for generating a customization.

The bold stylesheet name in column F (XSLT FILES) is the one that is called; the others are the ones that the called one imports or includes.

NAME	INPUT	OUTPUT FORM	PROCESSES INVOLVED	PREREQS	XSLT FILES	COMMENTS
Generate P5	guidelines-[lang].xml	p5.xml (TEI)	Combine all chapter and spec files into a single document; processing instructions such as the generation of a table for chapter ST are handled.	There must be a repodate.xml file containing an XML representation of the git repo state.	TEI/P5/Utilities/expand.xsl	*Spec elements occur in specGrp and in div.
Generate P5 Subset	p5.xml (generated above)	p5subset.xml (TEI); p5subsetDoctored.xml (TEI)	Create a special cut-down version of P5 which has only divisions and their headers along with all the specs.	Complete guidelines	TEI/P5/Utilities/subset.xsl; TEI/P5/Utilities/dtdMagic.xsl (for Doctored)	Why are all the div/head elements included? Why is a schemaSpec not created? Is it the case that schemaSpec always and only represents a customization of an existing source, which must eventually chain back to p5subset? If so, ODD is not a generic language; it depends on P5. This also generates the beautiful p5subsetDoctored.xml, which is a hack for DTD production.
Generate JSON from p5subset	p5subset.xml	p5subset.json	D	E	F	G
Merge ODD customization with P5 source (SR calls this oddexpand)	ODD customization; p5subset	file.processedodd	The macrodef oddexpan is called, and that calls odd2odd.xsl with params	p5subset[Doctored].xml; ODD customization	Stylesheets/odds/odd2odd.xsl	The Doctored version of the subset should be used if creating DTDs; this happens in the P5 build, but not in the Stylesheets.
ODD chaining	An ODD customization (#2) whose @source points to another customization (#1)	file.processedodd	#1 undergoes merging with p5subset.xml, then #2 undergoes merging with the result of that.	Both ODDs and p5subset[Doctored].xml	[See above]	Wrinkle: either #1 or #2 might have components that point out to another source, which would then be imported. See Lou's tutorial [1]
Generate RELAX NG from processed ODD	file.processedodd (output of rows above)	file.rng	Straight conversion, albeit complicated		Stylesheets/odds/odd2relax.xsl; odds/teiodds.xsl; odds/classatts.xsl; common/functions.xsl; common/i18n.xsl; common/common_param.xsl	The output is used to generate rnc and xsd using trang.
Extract Schematron	file.processedodd	file.isosch	Generate a Schematron file with all rules correctly contextualized.		Stylesheets/odds/extract-isosch.xsl	Obsolete stuff with "sch" exists alongside iso-sch; former should be removed and latter renamed to "sch".
Generate DTD from ODD	B	C	D	E	F	G
Generate TEI Lite from ODD	file.processedodd ($tmpodd in teianttasks.xml; output of odds/odd2odd.xsl)	TEI Lite XML document	odd2lite.xsl		Stylesheets/odds/odd2lite.xsl; odds/teiodds.xsl; classatts.xsl; common/verbatim.xsl; common/common.xsl; common.tagdocs.xsl; common/common_param.xsl; common/common_core.xsl; common/common_textstructure.xsl; common/common_header.xsl; common/common_linking.xsl; common/common_msdescription.xsl; common/common_figures.xsl; common/common_textcrit.xsl; common/common_gaiji.xsl; common/i18n.xsl; common/functions.xsl	This is the prerequisite step for generating XHTML5, ePub and PDF documentation.
A	B	C	D	E	F	G
A	B	C	D	E	F	G
A	B	C	D	E	F	G
A	B	C	D	E	F	G