How the Guidelines (HTML version) are built - Revision history

Mholmes: /* guidelines.xsl[.model] */

2013-06-05T21:39:57Z

‎guidelines.xsl[.model]

Kshawkin: fixed typo and added Category:Council

2013-06-01T01:49:14Z

fixed typo and added Category:Council

Mholmes: /* guidelines.xsl[.model] */

2013-05-31T16:43:16Z

‎guidelines.xsl[.model]

Mholmes: /* Makefile */

2013-05-31T16:39:01Z

‎Makefile

Mholmes: Created page with " == Intro == This is a page where I'm going to gather together notes on what I figure out about the Guidelines build process. I'm trying to change the generation of tehe index.h..."

2013-05-31T16:36:32Z

Created page with " == Intro == This is a page where I'm going to gather together notes on what I figure out about the Guidelines build process. I'm trying to change the generation of tehe index.h..."

New page

== Intro ==

This is a page where I'm going to gather together notes on what I figure out about the Guidelines build process. I'm trying to change the generation of tehe index.html and index-toc.html pages, replacing the former with a new version of the latter, and the latter with a redirect for people with obsolete bookmarks. To do this I need to understand the build process, which is not uncomplicated, and it may help others to have my notes to start from if they're also working on the same code.

== Makefile ==

The process is triggered by the P5/Makefile, specifically this target chain (AFAICS):

* teiwebsiteguidelines, which calls
* html-web, passing all languages as parameters, which calls check.stamp (checking for required tools), then
* p5.xml, which generates all the schemas and the p5.xml file used as input, then
* html-web.stamp, which runs a perl process which converts P5/guidelines.xsl.model to guidelines.xsl (don't know what the perl thing does yet), then uses it to generate the HTML version of the Guidelines in a directory called Guidelines-web/[language]/html

The initial teiwebsiteguidelines packages up the result into a zip file.

@@ Line 19: / Line 19: @@
 guidelines.xsl[.model]
 *odds2/odds2.xsl
 **teiodds.xsl

@@ Line 1: / Line 1: @@
 == Intro ==
-This is a page where I'm going to gather together notes on what I figure out about the Guidelines build process. I'm trying to change the generation of tehe index.html and index-toc.html pages, replacing the former with a new version of the latter, and the latter with a redirect for people with obsolete bookmarks. To do this I need to understand the build process, which is not uncomplicated, and it may help others to have my notes to start from if they're also working on the same code.
+This is a page where I'm going to gather together notes on what I figure out about the Guidelines build process. I'm trying to change the generation of the index.html and index-toc.html pages, replacing the former with a new version of the latter, and the latter with a redirect for people with obsolete bookmarks. To do this I need to understand the build process, which is not uncomplicated, and it may help others to have my notes to start from if they're also working on the same code.
 == Makefile ==
@@ Line 43: / Line 42: @@
 The original HTML version was built using the xhtml2 libraries primarily; the HTML5 version largely imports xhtml2 templates and overrides where necessary.

@@ Line 25: / Line 25: @@
 **classatts.xsl
 **../html5/tei.xsl
-*** ../xhtml2/tei.xsl
+***../xhtml2/tei.xsl
-**** ../common2/tei.xsl
+****../common2/tei.xsl
 ******tei-param.xsl
 ******core.xsl
@@ Line 37: / Line 37: @@
 ******i18n.xsl
 ******functions.xsl
-**** ../common2/verbatim.xsl
+****../common2/verbatim.xsl
 **** tei-param.xsl
-*** textstructure.xsl
+***textstructure.xsl
 **../xhtml2/oddprocessing.xsl

← Older revision		Revision as of 16:39, 31 May 2013
Line 14:		Line 14:

	The initial teiwebsiteguidelines packages up the result into a zip file.		The initial teiwebsiteguidelines packages up the result into a zip file.
		+
		+	== guidelines.xsl[.model] ==
		+
		+	The guidelines.xsl file created from the .model file imports a stack of files from the Stylesheets tree, like this:
		+
		+	guidelines.xsl[.model]
		+	*odds2/odds2.xsl
		+	**teiodds.xsl
		+	***../common2/odds.xsl
		+	**classatts.xsl
		+	**../html5/tei.xsl
		+	*** ../xhtml2/tei.xsl
		+	**** ../common2/tei.xsl
		+	******tei-param.xsl
		+	******core.xsl
		+	******textstructure.xsl
		+	******header.xsl
		+	******linking.xsl
		+	******msdescription.xsl
		+	******figures.xsl
		+	******textcrit.xsl
		+	******i18n.xsl
		+	******functions.xsl
		+	**** ../common2/verbatim.xsl
		+	**** tei-param.xsl
		+	*** textstructure.xsl
		+	**../xhtml2/oddprocessing.xsl