Using XSL from the DITA Open Toolkit
For style development teams that have already customized the HTML or PDF output through the DITA Open Toolkit, this investment in XSL styles can be carried over into Content Delivery.
About this task
The HTML and PDF XSL styles in Content Delivery are based upon those provided by the DITA Open Toolkit. Therefore, by loading the DITA Open Toolkit styles into a skin, you can get a foundation on which to complete your styling work. This task details the changes you will need to make to your DITA Open Toolkit styles in order for them to function within the Content Delivery XSL environment. In addition, you may need to make additional changes to allow special structures like linking and images, which Content Delivery has customized, to continue to function properly.
Content Delivery makes specific modifications to the DITA Open Toolkit styles via higher priority templates in the ContentDelivery_home/db/LiveContent/ui/skins/base/xsl/DITA/html.xsl file. As examples, special templates are provided to handle the following special structures:
- Cross references (
xref) to use custom JavaScript to resolve and handle links internal to a document, external to a document, or between documents. Cross references within image map objects (imagemap) receive similar handling. - Links to images (
@hrefattributes onimageelements) to use Content Delivery-specific linking as opposed to standard DITA Open Toolkit links. Images that use a@scaleattribute also receive special processing. - Multimedia objects (
object) are processed to output JavaScript snippets which will generate multimedia tagging on the web browser. See Displaying Multimedia for additional details.