Re: [oXygen-user] How to customize the default DITA topic validation scenario
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 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@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user ___ oXygen-user mailing list oXygen-user@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user ___ oXygen-user mailing list oXygen-user@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user
Re: [oXygen-user] How to customize the default DITA topic validation scenario
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 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@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user ___ oXygen-user mailing list oXygen-user@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user
[oXygen-user] How to customize the default DITA topic validation scenario
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@oxygenxml.com https://www.oxygenxml.com/mailman/listinfo/oxygen-user
