On 07/29/2016 01:19 PM, HEER Michael wrote:
Very new to dita and impressed with its possibilities I just tried to
lay out my first project.
Recommended tutorial: DITA for the Impatient
http://www.xmlmind.com/tutorials/DITA/index.html
I am using a reference document containing
reusable content. I use a dita map to organize my topics. Now I stuck
with a problem I only come across in XMLmind editor but it works without
flaw in ditto-ot 2.3:
Using referenced content (conref) from my reference document works just
fine when reuse the content in another topic.
This sentence is easy to understand as it corresponds to a normal DITA
practice.
But when I use the dita
map, I cannot reference to that reusable content in my reference
document.
This sentence is hard to understand as it does not correspond to a
normal DITA practice.
A DITA map contains topicrefs which point to either topics files or
sub-map files. I don't see how you could have "reusable content" at the
DITA map level.
Of course, it's possible to "conref" from one DITA map to another DITA
map and this is supported by our tools, but generally, DITA authors
prefer to add a topicref pointing to a sub-map. For example, you'll find
this is a DITA map:
<topicref href="my_topic.dita"/>
<topicref href="my_sub_map.ditamap"/>
Also note that there is *no* *way* to "conref" from a DITA topic to a
DITA map as a map and a topic have fundamentally different content
models. For example, in a DITA map, something like:
<topic conref="my_topic.dita#my_topic"/>
is *invalid*.
I just get the message when opening the map in the editor,
that the content cannot be found. I tried several ways and only in the
dita map I cannot make use of a conref content when using the xxe editor.
Sorry but without an example, I don't understand the issue you describe.
But if I double click the reference, the correct document opens up.
Possible explanation: the filename of the topic is OK, but the fragment
(e.g. #my_topic_id) which specifies an ID in this file is not.
I
also noticed, when using the include tool, only in dita maps I am not
able to see the list of the different items with an ID.
May be this is an orthogonal problem.
The Include tool has been designed to reference commonly used XML
*snippets* in DITA topics (e.g. a <ph> containing a product name),
nothing more. See tutorial:
http://www.xmlmind.com/xmleditor/_tutorial/insert_boilerplate/index.html
When editing a DITA map, the Include tool cannot be used to list topic
IDs found in a file containing multiple topics.
When editing a DITA map, the Include tool cannot be used to include (by
conref) in this map a topic found in a file containing multiple topics.
A DITA map should reference only topic filenames (without any fragment
like #my_topic_id). I mean, a single file should not contain multiple
topics. This is bad DITA pratice.
In order to populate a map, the simplest is drag topic files from your
file manager and drop them onto a DITA map opened in XMLmind XML Editor.
(I think it's time for us now to add a tutorial explaining how to create
a DITA map using XMLmind XML Editor.)
However when I use the dita-ot, I have no problem and the content is
properly referenced.
Any idea what might be wrong?
No, not all.
Please be kind enough to send us sample DITA map and topics showing the
issue you describe. I mean, something which is processed without any
problem by the DITA OT, but which causes XMLmind XML Editor to report
errors.
A ".zip" file privately send to mailto:huss...@xmlmind.com would be fine.
--
XMLmind XML Editor Support List
xmleditor-support@xmlmind.com
http://www.xmlmind.com/mailman/listinfo/xmleditor-support
