Issue with custom DITA specialization not validating in oXygen
Having trouble installing Oxygen? Got a bug to report? Post it all here.
-
alicesphere
- Posts: 1
- Joined: Mon Nov 17, 2025 11:37 am
- Location: https://wheelielife.io/
Issue with custom DITA specialization not validating in oXygen
Post by alicesphere »
Hi everyone,
I’m new to oXygen and to the forum, and I’m hoping someone can point me in the right direction. I’m working on a small project that uses a custom DITA specialization, and while the content validates correctly using command-line tools, it doesn’t validate inside oXygen.
I’ve added the custom DTDs to the Document Type Association and mapped the file patterns correctly. However, when I open a topic or run Validate, oXygen still reports that certain specialized elements are “not allowed in this context.” It feels like it’s still using the default DITA DTDs instead of mine.
Is there a specific location where custom DITA DTDs must be placed for oXygen to pick them up automatically? Do I need to modify the catalog file manually, or should the DITA Open Toolkit integration handle that? And has anyone run into a similar issue with specialized domains not being recognized?
I’m sure I’m missing something small, but after reading the docs I’m still a bit lost. Any guidance would be greatly appreciated.
Thanks, and glad to join the community!
I’m new to oXygen and to the forum, and I’m hoping someone can point me in the right direction. I’m working on a small project that uses a custom DITA specialization, and while the content validates correctly using command-line tools, it doesn’t validate inside oXygen.
I’ve added the custom DTDs to the Document Type Association and mapped the file patterns correctly. However, when I open a topic or run Validate, oXygen still reports that certain specialized elements are “not allowed in this context.” It feels like it’s still using the default DITA DTDs instead of mine.
Is there a specific location where custom DITA DTDs must be placed for oXygen to pick them up automatically? Do I need to modify the catalog file manually, or should the DITA Open Toolkit integration handle that? And has anyone run into a similar issue with specialized domains not being recognized?
I’m sure I’m missing something small, but after reading the docs I’m still a bit lost. Any guidance would be greatly appreciated.
Thanks, and glad to join the community!
-
Radu
- Posts: 9606
- Joined: Fri Jul 09, 2004 5:18 pm
Re: Issue with custom DITA specialization not validating in oXygen
Hi,
In the Oxygen user's guide there are documented two ways to integrate a DITA DTD specialization, either as a DITA OT specialization plugin in the DITA OT used by Oxygen for publishing or by adding an extra XML catalog in Oxygen's global XML catalogs list:
https://www.oxygenxml.com/doc/versions/ ... ation.html
A DTD specialization requires a specific DOCTYPE declaration to be used for all created and edited DITA XML topics. Did you also change the DOCTYPE for all topics opened in Oxygen?
Regards,
Radu
In the Oxygen user's guide there are documented two ways to integrate a DITA DTD specialization, either as a DITA OT specialization plugin in the DITA OT used by Oxygen for publishing or by adding an extra XML catalog in Oxygen's global XML catalogs list:
https://www.oxygenxml.com/doc/versions/ ... ation.html
A DTD specialization requires a specific DOCTYPE declaration to be used for all created and edited DITA XML topics. Did you also change the DOCTYPE for all topics opened in Oxygen?
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Jump to
- Oxygen XML Editor/Author/Developer
- ↳ Feature Request
- ↳ Common Problems
- ↳ DITA (Editing and Publishing DITA Content)
- ↳ Artificial Intelligence (AI Positron Assistant add-on)
- ↳ SDK-API, Frameworks - Document Types
- ↳ DocBook
- ↳ TEI
- ↳ XHTML
- ↳ Other Issues
- Oxygen XML Web Author
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Content Fusion
- ↳ Feature Request
- ↳ Common Problems
- Oxygen JSON Editor
- ↳ Feature Request
- ↳ Common Problems
- Oxygen PDF Chemistry
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Feedback
- ↳ Feature Request
- ↳ Common Problems
- Oxygen XML WebHelp
- ↳ Feature Request
- ↳ Common Problems
- XML
- ↳ General XML Questions
- ↳ XSLT and FOP
- ↳ XML Schemas
- ↳ XQuery
- NVDL
- ↳ General NVDL Issues
- ↳ oNVDL Related Issues
- XML Services Market
- ↳ Offer a Service