Relationship tables in a nested map with glossary entries do not show up in output
Post here questions and problems related to editing and publishing DITA content.
Relationship tables in a nested map with glossary entries do not show up in output
Hi! I'm a beginner and this is really the first issue I've had.
I have a map with glossary entries and a relationship table linking relevant terms together. In output (pdf or webhelp), those related links work fine.
When I nest that map inside another map, the links do not show up in output with the exact same transformation scenarios. The top-level map and some of the other nested maps also have relationship tables, and they work fine.
I've experimented with every possible structure I can think of, but the only way I can get those related links to show up is to output just the glossary by itself. Any attempt to link to it in a map (with topicref) fails. Clearly I'm missing something, but what?
I have a map with glossary entries and a relationship table linking relevant terms together. In output (pdf or webhelp), those related links work fine.
When I nest that map inside another map, the links do not show up in output with the exact same transformation scenarios. The top-level map and some of the other nested maps also have relationship tables, and they work fine.
I've experimented with every possible structure I can think of, but the only way I can get those related links to show up is to output just the glossary by itself. Any attempt to link to it in a map (with topicref) fails. Clearly I'm missing something, but what?
Re: Relationship tables in a nested map with glossary entries do not show up in output
Hi,
Does the "Validate and check for completness" action from the DITA Maps Manager view report any problem on the published map?
Do you use advanced DITA features like key scopes or branch filtering?
Maybe you can experiment with creating a small DITA sample project (2-3 maps, a couple of topics) which exhibits the problem. After this you can either attach it to a reply on this blog post or send it via email (support@oxygenxml.com).
Regards,
Radu
Does the "Validate and check for completness" action from the DITA Maps Manager view report any problem on the published map?
Do you use advanced DITA features like key scopes or branch filtering?
Maybe you can experiment with creating a small DITA sample project (2-3 maps, a couple of topics) which exhibits the problem. After this you can either attach it to a reply on this blog post or send it via email (support@oxygenxml.com).
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Re: Relationship tables in a nested map with glossary entries do not show up in output
Hi,
There was indeed a ditaval file in the map, and I was sure I had already tried removing it. Still, I tried again, and that resolved the issue. The conditions merely excluded some paragraphs, but moving it to the top level map did not hide the related links again. Is it then that the ditaval file must always be in the top-level map? While I was figuring this out I did test it with some sample files. I attached them in case it's not a feature; it does seem a little illogical since there were no validation issues and everything else so far has seemed very intuitive. Then again, it's my first time using branch filtering, so maybe I'm just doing it wrong!
Thanks for your help!
There was indeed a ditaval file in the map, and I was sure I had already tried removing it. Still, I tried again, and that resolved the issue. The conditions merely excluded some paragraphs, but moving it to the top level map did not hide the related links again. Is it then that the ditaval file must always be in the top-level map? While I was figuring this out I did test it with some sample files. I attached them in case it's not a feature; it does seem a little illogical since there were no validation issues and everything else so far has seemed very intuitive. Then again, it's my first time using branch filtering, so maybe I'm just doing it wrong!
Thanks for your help!
- Testing.zip
- (1.85 KiB) Downloaded 8 times
Re: Relationship tables in a nested map with glossary entries do not show up in output
Hi,
Once you start using a ditavalref file you will have to assign keys to resources inside the branch and to refer to them using keyrefs because the branch filtering might change the original topic names.
https://www.oxygenxml.com/dita/1.3/spec ... names.html
Regards,
Radu
Once you start using a ditavalref file you will have to assign keys to resources inside the branch and to refer to them using keyrefs because the branch filtering might change the original topic names.
https://www.oxygenxml.com/dita/1.3/spec ... names.html
So for example this should work:In general, the best way to reference a topic that will be modified based on branch filtering is to use a key rather than a URI.
Code: Select all
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">
<map>
<title>Nested map</title>
<ditavalref href="testing.ditaval"/>
<topicref href="testing_term_1.dita" keys="t1"/>
<topicref href="testing_term_2.dita" keys="t2"/>
<reltable>
<relrow>
<relcell>
<topicref keyref="t1"/>
</relcell>
<relcell>
<topicref keyref="t2"/>
</relcell>
</relrow>
</reltable>
</map>
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Re: Relationship tables in a nested map with glossary entries do not show up in output
Oh, I see! I still struggle to understand keys, but this helps. Thank you for taking the time to explain it with a sample, I appreciate it.
Re: Relationship tables in a nested map with glossary entries do not show up in output
Hi! Returning to this because I'm still not sure what is going wrong. If I use that exact example you gave, the references do work, but there is still a warning for both keyrefs: "Cannot find definition for key "t2". Keys are gathered from: null." It's just a warning, and it works, but obviously I'd prefer a lovely green validation.
I had this issue in my real map with only a couple of keyrefs that had some conditional values and have been researching that all morning, but I don't know what changed because now it's all of them, which made come back to your sample.
I had this issue in my real map with only a couple of keyrefs that had some conditional values and have been researching that all morning, but I don't know what changed because now it's all of them, which made come back to your sample.
Re: Relationship tables in a nested map with glossary entries do not show up in output
Hi,
Can you give me a screenshot of Oxygen when this error is displayed?
In the Oxygen DITA Maps Manager view you should always open the main DITA Map which is edited/published. Oxygen gathers keys used for validation and editing from the context root map in the DITA Maps manager view.
Regards,
Radu
Can you give me a screenshot of Oxygen when this error is displayed?
In the Oxygen DITA Maps Manager view you should always open the main DITA Map which is edited/published. Oxygen gathers keys used for validation and editing from the context root map in the DITA Maps manager view.
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Re: Relationship tables in a nested map with glossary entries do not show up in output
Oh I see! I've been mostly just looking at my project manager so far. As soon as I opened the maps manager the error changed to say that there is no map open and now everything is beautiful and green. Thank you again for a quick explanation for a lost newbie!
Re: Relationship tables in a nested map with glossary entries do not show up in output
Hi,
We have a bunch of past webinars linked here, maybe going through them will also help:
https://blog.oxygenxml.com/topics/learn ... wyk_5fj_2v
Regards,
Radu
We have a bunch of past webinars linked here, maybe going through them will also help:
https://blog.oxygenxml.com/topics/learn ... wyk_5fj_2v
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
<oXygen/> XML Editor
http://www.oxygenxml.com
Return to “DITA (Editing and Publishing DITA Content)”
Jump to
- Oxygen XML Editor/Author/Developer
- ↳ Feature Request
- ↳ Common Problems
- ↳ DITA (Editing and Publishing DITA Content)
- ↳ 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 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