Category:P4toP5

2006-07-04T12:32:53Z

TestUser:

[[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!

== Rational ==
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!

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.

Category:Customization

2006-01-04T11:38:05Z

TestUser: Spam Removal

This page collects together any pages relating to customizations of the TEI schemas. If you have created a customization
that you think may be of use to others in the TEI community, then the TEI wiki is one place to put it.
All of the customizations posted here are freely available for public use. They are offered as is, and we make no guarantees about their usefulness or effectiveness. Please feel free to experiment with them. If you make any useful revisions, please post the modified version here. Customizations can be made on the web via [[Roma]], and saved as [[ODD]] files. It is these saved customizations which we are encouraging people to share.
----
'''To create a new page and post your customization, you should:'''
* Log in (Create a user account for this WIKI if you have not done so.)
* Add a new page.
** To do this, add the name of the new page to the URL in your browser's address bar after index.php/
** For example, if you wish to create a new page called "MyNewCustomization.odd", just edit the URL in your web browser's address bar to look like this:
'''<nowiki>http://www.tei-c.org.uk/wiki/index.php/MyNewCustomization.odd</nowiki>'''
* Assuming no one else has made a page with the name you chose, you will be brought to a blank page. Click the edit button and do the following:
** Provide accompanying detailed explanation at the top of the page
** Cut and paste your ODD into the window.
** Wrap any ODD content content in <nowiki></nowiki>

TEIWiki - User contributions [en]

Category:P4toP5

Category:Customization