<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<p>Hi Frank,</p>
<p><br>
</p>
<p>So:</p>
<p><br>
</p>
<p>
<blockquote type="cite"> Good to know that the Type and Format
attributes are neither required nor good practice. <i>...</i></blockquote>
There is a problem which may occur if you are using the @type
attribute on and off inconsistently.</p>
<p>So let's say you have a DITA Map which uses it a lot like:</p>
<p><br>
</p>
<p>
<blockquote type="cite"> <topicref href="topics/task.dita"
type="task"/><br>
</blockquote>
and then you decide not to use it anymore on topicrefs, so you
might end up with something like this:</p>
<p><br>
</p>
<p>
<blockquote type="cite"> <topicref href="topics/task.dita"
type="task"><br>
<topicref href="topics/concept.dita"/><br>
</topicref><br>
</blockquote>
So the reference to "concept.dita" no longer has @type set on it,
but the parent task.dita has type set on it. And the DITA
specification states that in such cases the @type attribute value
cascades to the child element. So when publishing the DITA Map
content is interpreted as:</p>
<p><br>
</p>
<p>
<blockquote type="cite"> <topicref href="topics/task.dita"
type="task"><br>
<topicref href="topics/concept.dita" type="task"/><br>
</topicref></blockquote>
which will trigger a publishing warning.</p>
<p>Oxygen's "Validate and check for completeness" action from the
"DITA maps manager" view should report such problems.</p>
<p>But in general, once you decide not to use @type in the DITA map,
you should actively remove the attribute from the DITA Map
otherwise you end up with @type attribute values cascading on to
topicrefs which no longer have the @type attribute set.<br>
</p>
<p><br>
<blockquote type="cite">
<p>I right-clicked in the Editor window and selected <i>"</i>Insert
> Insert New DITA Resource", then I selected a custom
framework template.</p>
</blockquote>
Thanks, I added your details to the already opened issue.</p>
<p><br>
</p>
<p>Regards,</p>
<p>Radu</p>
<pre class="moz-signature" cols="72">Radu Coravu
Oxygen XML Editor</pre>
<p></p>
<p><br>
</p>
<div class="moz-cite-prefix">On 1/9/23 17:02, Frank Dissinger wrote:<br>
</div>
<blockquote type="cite"
cite="mid:f75c8946-f033-eaa7-dcfb-8cb87a049d12@cgs-oris.com">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<p>Hi Radu,</p>
<p><br>
</p>
<p>Thank you for this clarification. Good to know that the Type
and Format attributes are neither required nor good practice.
This makes life easier.</p>
<blockquote>
<p><i>I tested and indeed, if in the DITA Maps Manager I insert
a reference to an existing topic file, the attributes are
automatically added, but if I use for example the contextual
action "Append child->New" to create a topic and insert a
reference to it, then indeed the attributes are not set on
the topicref. Is this close to how you are doing things on
your side?</i></p>
</blockquote>
<p>I right-clicked in the Editor window and selected <i>"</i>Insert
> Insert New DITA Resource", then I selected a custom
framework template.</p>
<p><i><br>
</i></p>
<p>Regards,</p>
<p>Frank<i><br>
<br>
</i></p>
<div class="moz-cite-prefix">
<hr width="100%" size="2">Am 04.01.2023 um 06:57 schrieb Oxygen
XML Editor Support (Radu Coravu):<br>
</div>
<blockquote type="cite"
cite="mid:0e8b99ab-b383-d3cc-701f-558a53d6d340@oxygenxml.com">
<meta http-equiv="Content-Type" content="text/html;
charset=UTF-8">
<p>Hi Frank,</p>
<p><br>
</p>
<p>Please see some remarks below:</p>
<p><br>
</p>
<p> </p>
<blockquote type="cite">
<p>I understand that the "type" and "format" attributes are
required or at least a good practice for "topicref"
elements.<br>
</p>
</blockquote>
They are not required and they are not a best practice either.
<p>From what I've experienced along these years, most end users
who want these attributes to be added automatically are
usually the ones migrating from Framemaker or using both
Oxygen and Framemaker on the same set of DITA files.</p>
<p>My general best practice for these attributes would be:</p>
<p><br>
</p>
<p>1) For the "type" attribute, never set it on any link or
topicref as the publishing engine will infer it from the
target.</p>
<p>2) For the "format" attribute, Oxygen by default sets it on
references to DITA Maps and non-DITA topics, but when
referencing DITA topics, the @format attribute is not set
automatically as it's default value when not set is "dita".<br>
</p>
<p><br>
</p>
<blockquote type="cite">
<p> </p>
<p><br>
</p>
<p>When I insert a new dita resource into a ditamap (i.e. a
new topic or map which I create and insert in one go),
oXygen should add these attributes automatically. I have set
the options under "Options > Preferences > DITA >
Maps" accordingly.</p>
<p><br>
</p>
However, only "format" attributes are set, "type" attributes
are not set although I have checked both options.</blockquote>
Checking those "Format" and "Type" checkboxes in the "Options
> Preferences > DITA > Maps" preferences page should
work...
<p>I tested and indeed, if in the DITA Maps Manager I insert a
reference to an existing topic file, the attributes are
automatically added, but if I use for example the contextual
action "Append child->New" to create a topic and insert a
reference to it, then indeed the attributes are not set on the
topicref. Is this close to how you are doing things on your
side?</p>
<p>I added an internal issue to look into fixing this problem on
our side, adding the issue ID below for future reference:</p>
<p><br>
</p>
<p> EXM-52131 DITA Maps Manager creating new topic does not
automatically add type and format attributes to topicref</p>
<p><br>
</p>
<p>Hope this helps.<br>
</p>
<p><br>
</p>
<p>Regards,</p>
<p>Radu</p>
<pre class="moz-signature" cols="72">Radu Coravu
Oxygen XML Editor</pre>
<p><br>
</p>
<div class="moz-cite-prefix">On 1/3/23 21:08, Frank Dissinger
wrote:<br>
</div>
<blockquote type="cite"
cite="mid:ee737cce-b629-956d-4fa6-b462a18b1b60@cgs-oris.com">
<meta http-equiv="Content-Type" content="text/html;
charset=UTF-8">
<p>Hi list,</p>
<p><br>
</p>
<p>I understand that the "type" and "format" attributes are
required or at least a good practice for "topicref"
elements.<br>
</p>
<p><br>
</p>
<p>When I insert a new dita resource into a ditamap (i.e. a
new topic or map which I create and insert in one go),
oXygen should add these attributes automatically. I have set
the options under "Options > Preferences > DITA >
Maps" accordingly.</p>
<p><br>
</p>
<p>However, only "format" attributes are set, "type"
attributes are not set although I have checked both options.<br>
</p>
<p><br>
</p>
<p>Is this a bug or am I missing something?</p>
<p><br>
</p>
<p>I use oXygen V25.<br>
</p>
<p><br>
</p>
<p>Regards,</p>
<p><br>
</p>
Frank</blockquote>
</blockquote>
-- <br>
<div class="moz-signature">
<meta http-equiv="content-type" content="text/html;
charset=UTF-8">
<title></title>
<div class="moz-signature">
<style>div.signature {font-family: Verdana, sans-serif; font-size: 10pt; color: #7F8C8D; padding-top: 0.4em;}div.name {padding-bottom: 0.8em; padding-top: 0.8em}div.contact {padding-bottom: 0.8em;}p {margin: 0;}span.separator {border-top-style: dotted; border-top-width: 2px; padding-top: 0.6em;}a {color: inherit}</style>
<div class="signature">
<div class="name">
<p><strong>Frank Dissinger</strong></p>
<p>Documentation Manager</p>
<p>....................................................................</p>
</div>
<div class="contact">
<p><strong>CGS Publishing Technologies International GmbH</strong></p>
<p><strong>Email </strong><a
href="mailto:frank.dissinger@cgs-oris.com"
target="_blank" class="moz-txt-link-freetext"
moz-do-not-send="true">frank.dissinger@cgs-oris.com</a>
| <strong>Web</strong> <a
href="http://www.cgs-oris.com/" target="_blank"
moz-do-not-send="true">www.cgs-oris.com</a></p>
<p><strong>Address</strong> Kettelerstr. 24 | D-63512
Hainburg | Germany</p>
<p><strong>Phone</strong> +49 6182 9626-27 | <strong>Fax</strong>
+49 6182 9626-99</p>
<p><strong>Commercial register</strong> Offenbach, HRB no.
21495</p>
<p><strong>Managing directors</strong> Bernd Rückert,
Christoph Thommessen</p>
<p><br>
</p>
<a href="https://www.cgs-oris.com/signatur"
moz-do-not-send="true"><img
alt="https://www.cgs-oris.com/Signatur.png"
longdesc="https://www.cgs-oris.com/signatur"
src="https://www.cgs-oris.com/Signatur.png"
moz-do-not-send="true" width="394" height="200"></a> </div>
</div>
</div>
</div>
<br>
<fieldset class="moz-mime-attachment-header"></fieldset>
<pre class="moz-quote-pre" wrap="">_______________________________________________
oXygen-user mailing list
<a class="moz-txt-link-abbreviated" href="mailto:oXygen-user@oxygenxml.com">oXygen-user@oxygenxml.com</a>
<a class="moz-txt-link-freetext" href="https://www.oxygenxml.com/mailman/listinfo/oxygen-user">https://www.oxygenxml.com/mailman/listinfo/oxygen-user</a>
</pre>
</blockquote>
<pre class="moz-signature" cols="72">
</pre>
</body>
</html>