Package fr.tireme.schemadoc.transform

Manage the transformations themselves, either using Saxon or Xalan, depending on the command line.

See:
Description

Class Summary

XSLTTransformationsManager

Transformation wrapper for all three XSLT needed transformations

Package fr.tireme.schemadoc.transform Description

Manage the transformations themselves, either using Saxon or Xalan, depending on the command line.

Transformation may be going to:

• html, using the xml2html.xslt stylesheet
• pdf, using the xml2pdf.xslt stylesheet and then transforming the resulting formating object (fo) tree
• docbook, using the xml2db.xslt stylesheet. This stylesheet is experimental and should be enhanced. It enables, for example, to output the result of all formatting system recognizing this model.
• For being able to manage all these different transformations, the program shares some different functions and declarations

Shared conversion modules explanations

localVarsAndKeys.xslt	For being able to manage all hyperlinks of the HTML output, the program makes an intensive use of xsl:key method. They are declared here, for the possibility to be used either by FO or HTML transformation. In plus, this file contains parameter and variables declarations.
sharedNamedTemplates.xslt	All shared templates reused
suppressed.xslt	All elements that ShemaDoc is not managing and that are suppressed in the output.

Messages management

For now, schemadoc is multi-lingual in two languages. In order to be sure, to be able to go to other languages, all the transformation are using the multilingual docbook mechanism.

Messages applies either to the user interface or to the content of generated document themself. In order to achieve the different uses, people calls either <xsl:template name="message"> (UI) or <xsl:template name="outputLabel"> (document generated). Both needs an ID plus up to 4 possible parameters.

In the messages files, no difference is made between these two kind of messages, except that the provided ID uniquely differentiate.

l10n.dtd	DTD for multilingual messages
l10n.xml	Top multilingual message file, colling fr and en modules. Other languages should be added using this mechanism
en.xml	English version
fr.xml	French version
messages.xslt	Management of message selection

XML2HTML conversion explanations

All this program is in the {$schemadoc}/pgm/xml2html directory. Mainly, this program is an adaptation to the docbook standatd conversion.

Work done in the docbok package ({$schemadoc}/pgm/docbook-xsl directory):

• enabling to manage namespaces: all the standard packagehas moved to is own db namaspace
• takes into account xs and sd elements while fragmenting. This is mainly donr in chunk-common.xsl
• updating all titles management for takes into account tables of contents

In plus stylesheet has been set for sd ans xs namespace:

sd2html.xslt	main program, including or importing everything. Also manages specific parameters other than shared ones (shared/localVarsAndKeys.xslt)
dbRedef.xslt	Called from pgm\docbook-xsl\html\chunk-common.xsl, enables to redefine many different features of the docbook stylesheet. It may also add its own features, letting docbook manage its standard. All this is done usin xsl:import ans xsl:apply-import mechanisms.
namedTemplates.xslt	Specific named templates that may be seen as functions for the rest of the program.
xsNameSpaceManagement.xslt	Schema namespace management
sdNameSpaceManagement.xslt	SchemaDoc namespace management
dbNamespaceMissingFormatting.xslt	Docbook namespace management not taken into account in the standard distribution.
schemaDef.xslt	Manages all the formatting of schema information, when output as XML fragment in the reference documentation section.
xsDTD.xslt	Manages all the formatting of DTD information, when output as DTD fragment in the reference documentation section.
index.xslt	Manages all index of objects of the schema within page of objects documented or page of existing;
directAccessAsTOCManagement.xslt	Manages other TOC such as definition, decision and to be done tables.
specificNeeds.xslt	Because sometimes someone may want to tail the schemadoc model to it own needs, this module provides a special hook for being able to manae these objects while transforming. This has been test, here, for managing Adept Epic revision change management.