DITA and XMetaL Discussion

XMetaL Community Forum DITA and XMetaL Discussion keyword implementation causing problems for webhelp output…

  • kenfesta

    keyword implementation causing problems for webhelp output…

    Participants 1
    Replies 0
    Last Activity 10 years, 5 months ago

    Hi, apologies in advance for this fishing expedition. It's a bit of an odd request, I know, but I've inherited some DITA files from a former employee, and there is a implementation in them that I don't understand.

    The overview is this:

    – There is a generic topic with a set of keywords
    – Sprinkled throughout the topics (several thousand instances) are conrefs to these keywords.

    The explanation for these keywords is that this approach allows you to update these keywords in one central place, and there was a statement to the effect that keywords can be used by content management systems.

    The immediate problem is that since we've upgraded to XMetal 7, the keywords are breaking the index and search features in webhelp (the webhelp compiles fine, and the TOC is still usable).

    Does anyone know if there is a problem with this approach, or is it simply a question of the implementation? Are there other ways to implement common words that you may want to change? Are keywords necessary for CMS implementation? The documentation is heavily indexed…it would strike me that CMS would be able to consume index terms just as easily as keywords…

    Here is a snippet from the source file for the keywords:
    ———— ——— ——— ——— ——— ——— –

    Common keywords

    keyword1< /keyword>

    keyword2< /keyword>

    Here is an example of a keyword/confref back to this file:
    ———— ——— ——— ——— ——— ——— –

    conref=”../common/ keywords/ common_keywords. dita#common_ keywords/ keyword1″ >


  • You must be logged in to reply to this topic.

Lost Your Password?