georgebina / fixConrefPush

Sample use of SQF to fix DITA content reference push variations

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

fixConrefPush

Sample use of SQF to fix DITA content reference push variations

Robert Anderson wrote about one of the less beautiful feature of DITA, that is conref push, see DITA's ugliest feature: volume 1.

One of the proposals to make it mode manageable is to use a single element to contain the conref target and the desired push action, before or after, something like:

<li conref="example.dita#example/b" conaction="pushbefore">THIS GOES BEFORE B</li>

This project demonstrates the use of SQF to propose an automatic change of the document to the actual form of expressing the content reference push, for this example that will be

<li conaction="pushbefore">THIS GOES BEFORE B</li>
<li conaction="mark" conref="example.dita#example/b"/>

You can try this either in oXygen XML Editor by cloning this project, or online, using the oXygen XML Web Author, following the link to opens the sample topic.dita file.

From a technology point of view, this project uses Schematron to detect the issues and SQF for providing the automatic conversions.

About

Sample use of SQF to fix DITA content reference push variations

License:Apache License 2.0