Category:P4toP5 - Revision history

Piotr Banski: Reverted edits by ZeldrOnric (Talk); changed back to last version by James

2008-01-16T07:10:57Z

Reverted edits by ZeldrOnric (Talk); changed back to last version by James

New page

[[Category:XSLT]]

== Introduction ==
Stylesheets in this subcategory should handle a particular aspect of
P4 to P5 translation. That is, the stylesheet should expect to read in
an XML instance that conforms to a P4:2004 vanilla DTD, and write out
the same document with one particular aspect changed so that it (the
particular aspect) would conform to P5. (Which release, you ask?
Whichever one is current at the time you write the stylesheet will
have to do — but please document the release number in your
stylesheet.) Currently there is not a full set of conversion stylesheets, so please add some!

== Rationale ==
The idea is not to build a single, monolithic stylesheet that
converts P4 to P5, but rather to build a long pipeline of smaller
transformations that will do the job. This makes division of labor
easier, makes debugging much easier, and permits multiple
possibilities for a given task (e.g., one person might write a
stylesheet that converts lang= to xml:lang=, and just deletes all
<language> elements; another might write a similar stylesheet that
retains <language> elements).

== Shell Scripts to Help Transformation ==
The shell script [[P4_enroute_to_P5.bash]] is provided to make it easy to execute
all of these in a row on a single input file.
For an alternative, more flexible method of executing a sequence of stylesheets one after the other, see [[PipedStylesheets.bash]].

== Adding Your Own Stylesheets ==
If you add a new stylesheet to this category, please either update [[P4_enroute_to_P5.bash]] (by adding your stylesheet to the STYLESHEETS variable before Dot-two.xslt) or ask [mailto:stylesheets@tei-c.org stylesheets@tei-c.org] to do so for you.
There is no need to put "P4toP5" or anything like that in the name of your stylesheet — that much is implied by its being on this page!

You should include the stylesheet itself inside a <nowiki> element inside a <pre> element. Do not put any whitespace between the <pre> start-tag and the XML declaration of your stylesheet. I.e., the stylesheet itself should start with
<pre><nowiki><pre><nowiki><?xml ...</nowiki></pre>

To make your stylesheet appear in this sub-section simply include at the top of the page:
<nowiki>[[Category:P4toP5]]</nowiki>

If your stylesheet is also of use to those doing something other than just
P4 to P5 conversion, you might also want to include:
<nowiki>[[Category:XSLT]]</nowiki>

== Stylesheet Assumptions ==

The XSLT stylesheets available here make certain assumptions, and we should all make the same assumptions so that they inter-operate well:

=== Copying Existing Elements ===
Because all of these stylesheets need to copy all elements that they are not dealing with, you should
include a:
<nowiki><xsl:import href="Copy-All.xsl"/></nowiki>
at the beginning of your stylesheets -- see the existing stylesheets below for examples. If you are going to use any of the stylesheets, then you should also download that one.

=== Namespaces ===
TEI P5 uses the http://www.tei-c.org/ns/1.0 namespace. However, since it is more complicated to write stylesheets which cope with both possibilities of the incoming data either already being in a namespace or not, we have standardized on leaving the transfer of the elements to the TEI namespace to the final stylesheet 'Dot-two.xslt'. This changes the TEI P4 element 'TEI.2' to 'TEI' and imports the rest of the document into the TEI namespace. So if you are writing P4toP5 stylesheets you should output everything without a namespace, and assume the input had no namespace.

James: Reverted edit of QqtJzd, changed back to last version by Piotr Banski

2007-06-22T09:25:36Z

Reverted edit of QqtJzd, changed back to last version by Piotr Banski

New page

Piotr Banski: revert

2007-06-03T02:30:10Z

revert

New page

Syd: Add "no whitespace before XML decl" instructions

2006-10-06T00:59:59Z

Add "no whitespace before XML decl" instructions

← Older revision		Revision as of 00:59, 6 October 2006
Line 29:		Line 29:
	If you add a new stylesheet to this category, please either update [[P4_enroute_to_P5.bash]] (by adding your stylesheet to the STYLESHEETS variable before Dot-two.xslt) or ask [mailto:stylesheets@tei-c.org stylesheets@tei-c.org] to do so for you.		If you add a new stylesheet to this category, please either update [[P4_enroute_to_P5.bash]] (by adding your stylesheet to the STYLESHEETS variable before Dot-two.xslt) or ask [mailto:stylesheets@tei-c.org stylesheets@tei-c.org] to do so for you.
	There is no need to put "P4toP5" or anything like that in the name of your stylesheet — that much is implied by its being on this page!		There is no need to put "P4toP5" or anything like that in the name of your stylesheet — that much is implied by its being on this page!

			You should include the stylesheet itself inside a <nowiki> element inside a <pre> element. Do not put any whitespace between the <pre> start-tag and the XML declaration of your stylesheet. I.e., the stylesheet itself should start with
			<pre><nowiki><pre><nowiki><?xml ...</nowiki></pre>

	To make your stylesheet appear in this sub-section simply include at the top of the page:		To make your stylesheet appear in this sub-section simply include at the top of the page:

DavidSewell: /* Rational */ spelling fix

2006-08-29T13:46:00Z

Rational: spelling fix

← Older revision		Revision as of 13:46, 29 August 2006
Line 11:		Line 11:
	stylesheet.) Currently there is not a full set of conversion stylesheets, so please add some!		stylesheet.) Currently there is not a full set of conversion stylesheets, so please add some!

	== ~~Rational~~ ==		== Rationale ==
	The idea is not to build a single, monolithic stylesheet that		The idea is not to build a single, monolithic stylesheet that
	converts P4 to P5, but rather to build a long pipeline of smaller		converts P4 to P5, but rather to build a long pipeline of smaller
Line 20:		Line 20:
	<language> elements; another might write a similar stylesheet that		<language> elements; another might write a similar stylesheet that
	retains <language> elements).		retains <language> elements).


	== Shell Scripts to Help Transformation ==		== Shell Scripts to Help Transformation ==

James at 12:56, 4 July 2006

2006-07-04T12:56:57Z

← Older revision		Revision as of 12:56, 4 July 2006
Line 44:		Line 44:
	=== Copying Existing Elements ===		=== Copying Existing Elements ===
	Because all of these stylesheets need to copy all elements that they are not dealing with, you should		Because all of these stylesheets need to copy all elements that they are not dealing with, you should
	include a <nowiki><xsl:import href="Copy-All.xsl"/></nowiki> at the beginning of your stylesheets -- see the existing stylesheets below for examples. If you are going to use any of the stylesheets, then you should also download that one.		include a:
			<nowiki><xsl:import href="Copy-All.xsl"/></nowiki>
			at the beginning of your stylesheets -- see the existing stylesheets below for examples. If you are going to use any of the stylesheets, then you should also download that one.

	=== Namespaces ===		=== Namespaces ===
	TEI P5 uses the http://www.tei-c.org/ns/1.0 namespace. However, since it is more complicated to write stylesheets which cope with both possibilities of the incoming data either already being in a namespace or not, we have standardized on leaving the transfer of the elements to the TEI namespace to the final stylesheet 'Dot-two.xslt'. This changes the TEI P4 element 'TEI.2' to 'TEI' and imports the rest of the document into the TEI namespace. So if you are writing P4toP5 stylesheets you should output everything without a namespace, and assume the input had no namespace.		TEI P5 uses the http://www.tei-c.org/ns/1.0 namespace. However, since it is more complicated to write stylesheets which cope with both possibilities of the incoming data either already being in a namespace or not, we have standardized on leaving the transfer of the elements to the TEI namespace to the final stylesheet 'Dot-two.xslt'. This changes the TEI P4 element 'TEI.2' to 'TEI' and imports the rest of the document into the TEI namespace. So if you are writing P4toP5 stylesheets you should output everything without a namespace, and assume the input had no namespace.

TestUser at 12:32, 4 July 2006

2006-07-04T12:32:53Z

← Older revision		Revision as of 12:32, 4 July 2006
Line 47:		Line 47:

	=== Namespaces ===		=== Namespaces ===
	TEI P5 uses the http://www.tei-c.org/ns/1.0 namespace. However, since it is more complicated to write stylesheets which cope with both possibilities of the incoming data either already being in a namespace or not, we have standardized on leaving the transfer of the elements to the TEI namespace to the final stylesheet 'Dot-two.xslt'. This changes the TEI P4 element 'TEI.2' to 'TEI' and imports the rest of the document into the TEI namespace. So if you are writing P4toP5 stylesheets you should output everything without a namespace.		TEI P5 uses the http://www.tei-c.org/ns/1.0 namespace. However, since it is more complicated to write stylesheets which cope with both possibilities of the incoming data either already being in a namespace or not, we have standardized on leaving the transfer of the elements to the TEI namespace to the final stylesheet 'Dot-two.xslt'. This changes the TEI P4 element 'TEI.2' to 'TEI' and imports the rest of the document into the TEI namespace. So if you are writing P4toP5 stylesheets you should output everything without a namespace, and assume the input had no namespace.

James at 11:33, 4 July 2006

2006-07-04T11:33:04Z

← Older revision		Revision as of 11:33, 4 July 2006
Line 44:		Line 44:
	=== Copying Existing Elements ===		=== Copying Existing Elements ===
	Because all of these stylesheets need to copy all elements that they are not dealing with, you should		Because all of these stylesheets need to copy all elements that they are not dealing with, you should
	include a <nowiki><xsl:import href="Copy-All.xsl"/></nowiki> at the beginning of your stylesheets as the ~~others~~ below do. If you are going to use any of the stylesheets, then you should also download that one.		include a <nowiki><xsl:import href="Copy-All.xsl"/></nowiki> at the beginning of your stylesheets -- see the existing stylesheets below for examples. If you are going to use any of the stylesheets, then you should also download that one.

	=== Namespaces ===		=== Namespaces ===
	TEI P5 uses the http://www.tei-c.org/ns/1.0 namespace. However, since it is more complicated to write stylesheets which cope with both possibilities of the incoming data either already being in a namespace or not, we have standardized on leaving the transfer of the elements to the TEI namespace to the final stylesheet 'Dot-two.xslt'. This changes the TEI P4 element 'TEI.2' to 'TEI' and imports the rest of the document into the TEI namespace. So if you are writing P4toP5 stylesheets you should output everything without a namespace.		TEI P5 uses the http://www.tei-c.org/ns/1.0 namespace. However, since it is more complicated to write stylesheets which cope with both possibilities of the incoming data either already being in a namespace or not, we have standardized on leaving the transfer of the elements to the TEI namespace to the final stylesheet 'Dot-two.xslt'. This changes the TEI P4 element 'TEI.2' to 'TEI' and imports the rest of the document into the TEI namespace. So if you are writing P4toP5 stylesheets you should output everything without a namespace.

James: structured preamble

2006-07-04T11:21:31Z

structured preamble

← Older revision		Revision as of 11:21, 4 July 2006
Line 1:		Line 1:
	[[Category:XSLT]]		[[Category:XSLT]]

			== Introduction ==
	Stylesheets in this subcategory should handle a particular aspect of		Stylesheets in this subcategory should handle a particular aspect of
	P4 to P5 translation. That is, the stylesheet should expect to read in		P4 to P5 translation. That is, the stylesheet should expect to read in
Line 8:		Line 9:
	Whichever one is current at the time you write the stylesheet will		Whichever one is current at the time you write the stylesheet will
	have to do — but please document the release number in your		have to do — but please document the release number in your
	stylesheet.)		stylesheet.) Currently there is not a full set of conversion stylesheets, so please add some!

			== Rational ==
	The idea is not to build a single, monolithic stylesheet that		The idea is not to build a single, monolithic stylesheet that
	converts P4 to P5, but rather to build a long pipeline of smaller		converts P4 to P5, but rather to build a long pipeline of smaller
Line 19:		Line 21:
	retains <language> elements).		retains <language> elements).

	~~Because all of these stylesheets need to copy all elements that they are not dealing with, you should~~
	include a <nowiki><xsl:import href="Copy-All.xsl"/></nowiki> at the beginning of your stylesheets as the others below do. If you are going to use any of the stylesheets, then you should also download that one.

			== Shell Scripts to Help Transformation ==
	The shell script [[P4_enroute_to_P5.bash]] is provided to make it easy to execute		The shell script [[P4_enroute_to_P5.bash]] is provided to make it easy to execute
	all of these in a row on a single input file.		all of these in a row on a single input file.
	(For an alternative, more flexible method of executing a sequence of stylesheets one after the other, see [[PipedStylesheets.bash]]~~.) If you add a new stylesheet to this category, please either update [[P4_enroute_to_P5.bash]] (by adding your stylesheet to the STYLESHEETS variable) or ask one of the wiki mainters to do so for you~~.		For an alternative, more flexible method of executing a sequence of stylesheets one after the other, see [[PipedStylesheets.bash]].

			== Adding Your Own Stylesheets ==
			If you add a new stylesheet to this category, please either update [[P4_enroute_to_P5.bash]] (by adding your stylesheet to the STYLESHEETS variable before Dot-two.xslt) or ask [mailto:stylesheets@tei-c.org stylesheets@tei-c.org] to do so for you.
	There is no need to put "P4toP5" or anything like that in the name of your stylesheet — that much is implied by its being on this page!		There is no need to put "P4toP5" or anything like that in the name of your stylesheet — that much is implied by its being on this page!

Line 34:		Line 37:
	P4 to P5 conversion, you might also want to include:		P4 to P5 conversion, you might also want to include:
	<nowiki>[[Category:XSLT]]</nowiki>		<nowiki>[[Category:XSLT]]</nowiki>

			== Stylesheet Assumptions ==

			The XSLT stylesheets available here make certain assumptions, and we should all make the same assumptions so that they inter-operate well:

			=== Copying Existing Elements ===
			Because all of these stylesheets need to copy all elements that they are not dealing with, you should
			include a <nowiki><xsl:import href="Copy-All.xsl"/></nowiki> at the beginning of your stylesheets as the others below do. If you are going to use any of the stylesheets, then you should also download that one.

			=== Namespaces ===
			TEI P5 uses the http://www.tei-c.org/ns/1.0 namespace. However, since it is more complicated to write stylesheets which cope with both possibilities of the incoming data either already being in a namespace or not, we have standardized on leaving the transfer of the elements to the TEI namespace to the final stylesheet 'Dot-two.xslt'. This changes the TEI P4 element 'TEI.2' to 'TEI' and imports the rest of the document into the TEI namespace. So if you are writing P4toP5 stylesheets you should output everything without a namespace.

Syd at 17:41, 3 July 2006

2006-07-03T17:41:40Z

← Older revision		Revision as of 17:41, 3 July 2006
Line 22:		Line 22:
	include a <nowiki><xsl:import href="Copy-All.xsl"/></nowiki> at the beginning of your stylesheets as the others below do. If you are going to use any of the stylesheets, then you should also download that one.		include a <nowiki><xsl:import href="Copy-All.xsl"/></nowiki> at the beginning of your stylesheets as the others below do. If you are going to use any of the stylesheets, then you should also download that one.

	(For ~~one~~ method of executing a sequence of stylesheets one after the other, see [[PipedStylesheets.bash]].)		The shell script [[P4_enroute_to_P5.bash]] is provided to make it easy to execute
			all of these in a row on a single input file.
			(For an alternative, more flexible method of executing a sequence of stylesheets one after the other, see [[PipedStylesheets.bash]].) If you add a new stylesheet to this category, please either update [[P4_enroute_to_P5.bash]] (by adding your stylesheet to the STYLESHEETS variable) or ask one of the wiki mainters to do so for you.

	There is no need to put "P4toP5" or anything like that in the name of		There is no need to put "P4toP5" or anything like that in the name of your stylesheet — that much is implied by its being on this page!
	your stylesheet — that much is implied by its being on this page!

	To make your stylesheet appear in this sub-section simply include at the top of the page:		To make your stylesheet appear in this sub-section simply include at the top of the page: