Child DITA map vs. Map group elements (topicset and topicgro
Oxygen general issues.
-
- Posts: 1
- Joined: Tue Apr 08, 2014 6:34 pm
Child DITA map vs. Map group elements (topicset and topicgro
Our Help documentation contains 450+ topics. Our current Help system has Master DITA map with child ditamaps. Each child .ditamap has a child .ditamap of its own and topics or just topics and subtopics. We are planning on adding new topics and customizing help based on user role. We will be having 5-6 versions of Help.
Should I use child ditamaps or topicsets or topicgroups or a combination of map and group elements within the Master DITA map to group topics? When and why should a child map, a topicset and a topicgroup be used?
Are there any limitations regarding number of topics or child ditamaps etc. Could there be any issues when exporting the master DITA map when using child ditamap vs. other group elements? Is topic file path length an issue when applying transformation and creating output?
Once the 5-6 Help master DITA maps have been created, we do not anticipate major changes to the Help layout for at least next 3-4 years.
Thank You
Should I use child ditamaps or topicsets or topicgroups or a combination of map and group elements within the Master DITA map to group topics? When and why should a child map, a topicset and a topicgroup be used?
Are there any limitations regarding number of topics or child ditamaps etc. Could there be any issues when exporting the master DITA map when using child ditamap vs. other group elements? Is topic file path length an issue when applying transformation and creating output?
Once the 5-6 Help master DITA maps have been created, we do not anticipate major changes to the Help layout for at least next 3-4 years.
Thank You
-
- Posts: 9472
- Joined: Fri Jul 09, 2004 5:18 pm
Re: Child DITA map vs. Map group elements (topicset and topi
Hi Angelina,
The Oxygen forum is a more static place where to ask a question of general interested unrelated to the application, regular Oxygen users registered on the forum do not receive notifications when a new topic is added on the forum.
You should consider registering and asking the question on the DITA Users List as it has a large number of users, most of which being technical writers.
For our Oxygen's user manual which is also written in DITA we use the multiple DITA Maps approach.
Indeed you can also use <topicset> and <topicsetref> to group a set of topic refs and then to reference to them.
The <topicgroup> is an element which can group a number of topicrefs and apply a set of common attributes to all:
http://docs.oasis-open.org/dita/v1.2/os ... group.html
Regards,
Radu
The Oxygen forum is a more static place where to ask a question of general interested unrelated to the application, regular Oxygen users registered on the forum do not receive notifications when a new topic is added on the forum.
You should consider registering and asking the question on the DITA Users List as it has a large number of users, most of which being technical writers.
For our Oxygen's user manual which is also written in DITA we use the multiple DITA Maps approach.
Indeed you can also use <topicset> and <topicsetref> to group a set of topic refs and then to reference to them.
The <topicgroup> is an element which can group a number of topicrefs and apply a set of common attributes to all:
http://docs.oasis-open.org/dita/v1.2/os ... group.html
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