On 09/13/2018 04:57 PM, Vic Steadman wrote:

While I personally prefer to avoid inline links/references in favour of using 
"related information" at the end of each topic, I am bound by what my customers 
want.  And what customers want is often inline references and associated tooltips.

I therefore request an enhancement to process the <shortdesc> element as a 
tooltip when a document set is published to a web format.
It should process the <shortdesc> from individual topics from wherever they are 
referenced (topicref, glossref, keyref etc.).  Any <shortdesc> inserted as part of 
topicmeta in a topicref should override the parent topic description.  (though I cannot 
immediately think of an example of where I might need this.


OK. We'll try to implement the following feature:

------------------------------------------------------------------
Use the <shortdesc> of a <keydef> to generate a "tooltip" when this <keydef> is used to create a link.

Example, the "XDR" keydef:
---
     <keydef format="html" href="http://www.xmlmind.com/docrep/"; keys="XDR"
             scope="external">
       <topicmeta>
         <linktext>XMLmind Document Repository</linktext>

         <shortdesc>XMLmind Document Repository is a <i>web-based</i>
document
         store featuring <i>automatic</i>, <i>transparent</i>,
         <i>versioning</i>. It is a compromise between the simplicity of a
         shared folder and the power of a revision control system (CVS,
         Subversion, etc). This compromise between simplicity and power
aims to
         be well-adapted to the needs of the technical writer.</shortdesc>
       </topicmeta>
     </keydef>
   </topichead>
---

Example, using the "XDR" keydef in <ph> (but also <cite>, <keyword>, <dt>, <term>, <xref>):
---
       <strow>
         <stentry><ph keyref="XDR"/></stentry>
---
------------------------------------------------------------------

in the next version of XMLmind DITA Converter (http://www.xmlmind.com/ditac/), because this obviously makes sense.

We cannot promise to do more.



--
XMLmind XML Editor Support List
xmleditor-support@xmlmind.com
http://www.xmlmind.com/mailman/listinfo/xmleditor-support

Reply via email to