[oXygen-user] How to customize the default DITA topic validation scenario

[Kristen James Eberlein]

Thanks, Radu.

I would not want the topic validation to go looking at links to other 
topics, but it would be good if it found problems with links within the 
topic. I like to train authors to always validate every topic that they 
modify -- and to trust that "all is well" if validation run without errors!

Thanks for adding an internal issue, and for all your hard work in 
supporting oXygen users and delivering such an outstanding product.

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)

On 10/25/2019 2:49 AM, Oxygen XML Editor Support (Radu Coravu) wrote:
> Hi Kristen,
>
> When automatic or manual validation is performed on a DITA topic, we 
> have about 3 validation stages, a stage in which the DTD/schema is 
> used to check for errors, a stage in which a custom Schematron schema 
> is used to check for errors and a stage in which a DITA specific error 
> scanner is used to check for more errors.
> Our DITA specific error scanner for topics only checks for broken 
> table layouts and for references to missing topics but it could be 
> improved to also check for broken references to IDs in the same topic. 
> I will add an internal issue to do this. Hypothetically the error 
> scanner could also be improved to report links to other topics which 
> have missing IDs but this would mean that the validation would not be 
> fast anymore, it would need to also load those referenced topics and 
> look into them. But for IDs located in the same topic it's no problem.
>
> For now maybe you can create a custom Schematron schema to do this 
> extra check:
>
> https://blog.oxygenxml.com/2017/02/sharing-schematron-validation-rules.html 
>
>
> Some time ago we created this experimental Schematron schema:
>
>> OXYGEN_INSTALL_DIR\frameworks\dita\resources\dita-1.2-for-xslt2-links-checker.sch 
>>
>
> which actually looks inside the referenced topics for the IDs. It 
> might also work for references inside the current topic.
>
> Regards,
> Radu
>
> Radu Coravu
> <oXygen/> XML Editor
> http://www.oxygenxml.com
>
> On 10/24/2019 7:41 PM, Kristen James Eberlein wrote:
>> I am cleaning up DITA source for a client.
>>
>> I am finding errors that are flagged by the "DITAmap Completeness 
>> Check" that are not caught by the standard DITA topic validation.
>>
>> In particular, if a topic contains a (broken) cross reference to 
>> another element within the same topic, the topic validation does not 
>> catch that error.
>>
>> Is there a way to set up a custom DITA topic validation that will 
>> catch this sort of error?
>>
>> Best,
>> Kris
>>
>> Kristen James Eberlein
>> Chair, OASIS DITA Technical Committee
>> Principal consultant, Eberlein Consulting
>> www.eberleinconsulting.com
>> +1 919 622-1501; kriseberlein (skype)
>> _______________________________________________
>> oXygen-user mailing list
>> oXygen-user at oxygenxml.com
>> https://www.oxygenxml.com/mailman/listinfo/oxygen-user
> _______________________________________________
> oXygen-user mailing list
> oXygen-user at oxygenxml.com
> https://www.oxygenxml.com/mailman/listinfo/oxygen-user