Re: fallback attribute

On 2/23/21 8:12 AM, Grundtvig Nielsen, Niels Peter wrote:
> 
> obviously enough, keyrefs are not resolved when I convert a single topic 
> to an output format; and XML Mind helpfully alerts to me to this with 
> the message
> 
> file:/T:/17_yumi/ownerManual/yuo_048.dita:49:55: cannot resolve 
> keyref="productName" and there is no "href" fallback attribute
> 
> But I am then left wondering what a fallback attribute might be, and how 
> to use one. I may soon be required to output quite a lot of topics to 
> xhtml for a test, and it will be inconvenient to have gaps every time 
> the product name should appear :-}
> 
> Thanks in advance for any advice on this.
> 

--> The sensible fallback value for a keydef like this one:
---
<keydef href="screenshots/consoleMode.png" keys="consoleMode"/>
---

is of course adding attribute href="screenshots/consoleMode.png" to your 
<image> in addition to keyref="consoleMode", for example:

---
     <fig>
       <image href="screenshots/consoleMode.png" keyref="consoleMode"/>
     </fig>
---

The magic of the keyref is to make the fig/image point to a file other 
than "screenshots/consoleMode.png" provided that you redefine key 
"consoleMode" in a different DITA map.



--> There is no sensible fallback value for a keydef like this other one:
---
     <keydef keys="productName" navtitle="Name of the product.">
       <topicmeta>
         <keywords>
           <keyword>Fancy Gizmo</keyword>
         </keywords>
       </topicmeta>
     </keydef>
---

If you want to get rid of the warning, the only way is to first open a 
DITAMAP (a mockup one or a real one) referencing the topic you want to 
convert and defining the key, and then open the topic, for example to 
convert it.

This should work fine thanks to the *automatic* master document 
mechanism to XXE:

- See tutorial "Working with master documents", 
http://www.xmlmind.com/xmleditor/_tutorial/master_doc/index.html

- See "Use as Master Document", 
http://www.xmlmind.com/xmleditor/_distrib/doc/help/toolsMenu.html



--
XMLmind XML Editor Support List
[email protected]
http://www.xmlmind.com/mailman/listinfo/xmleditor-support