XMetaL Tips and Tricks
-
When displaying a document that contains an image, a limitation of XMetaL is that it cannot simultaneously show both the actual image and a sub-element of the
element, such as an
element. You also cannot insert an element for an image if the image is displayed. To work with
elements within images, click View > Hide Inline Images. This will hide images, but allow you to view, edit, and insert elements in both Normal and Tags On views. DITA users can also use the Insert Image or Figure or Image or Figure Properties dialogs to view, edit, and insert
elements. See the additional notes below. Additional notes on the
element in DITA The DITA 1.1 language reference says, “The alt element provides alternate text for an image. It is equivalent to the alt attribute on the image element; the attribute is deprecated, so the alt element should be used instead. As an element, alt provides direct text entry within an XML editor and is more easily accessed than an attribute for translation.”
Because “alt text” can be stored in either an attribute or an element, XMetaL's dialogs for editing image properties use some special logic to support either choice:
– If the alt attribute does not have a value, anything typed into the Alt Text field goes into the alt element when the user clicks OK (the system creates an alt element if needed).
– If the alt attribute has a value, and there is no alt element, the Alt Text field displays the contents of the alt attribute, and anything in this field is saved to the alt attribute, not the element, when the user clicks OK.
– If the alt attribute has a value, and there is also an alt element, the Alt Text field displays the contents of the alt element, and anything in this field is saved to the alt element when the user clicks OK.The dialogs are designed to encourage use of the
element, while ensuring that people using the alt attribute wouldn’t have their data seem to disappear. Note that XMetaL does not move content from alt attributes to elements, or vice-versa. It appears that this limitation is not DITA-specific, is that correct? For example, in our schema, we have an
element for which we display a placeholder image using 'Display As' = XFT, and the XFT is essentially just a small graphic.
I'm investigating an issue where child elements are not being displayed in this context – is that because of this same limitation?
[XMetaL Authoring Essentials 8]
Thanks Derek – I had read that other thread yesterday as well.
Here's a scenario I'm trying to solve. I currently have the following working:
XFT placeholder image
Where the XFT is embedded and essentially just a graphic to show that an image would be displayed there at rendering time.
In some scenarios, we have a child element that would make the image into a hotlink. e.g.
In all these cases the data we track is in attributes of the tags themselves – not any value data between elements.
Currently, I am unable to display the element in the editor, presumably due to the XFT that we have associated with the
element. I tried defining the XFT as embedded and to be before
element, but it didn't seem to have any impact either on where the XFT was displayed or whether the element would also be displayed. Is what I'm trying to do possible? or perhaps I just didn't quite get it defined and setup correctly.
- You must be logged in to reply to this topic.
