keywords within keywords
Posted: Thu Dec 05, 2013 12:17 am
I am trying to redevelop our technical documentation out of Word and into DITA. But I just ran into a brick wall - a tall one at that.
Like most technical documentation, our's is riddled with acronyms - acronyms that change on the boss' whim. So my document title might be: "CMES-BCA FN110: NCM Search Window" today, but "CMES Function110: EPM Search" tomorrow.
Well the whole thing is the title of a document, and I'd like it to be a keyword so it can be inserted into a title element. But "CMES-BCA" is a keyword, as is "FN110", as is "NCM", as is "Search Window". Ideally I would like to string them all together in my keyword DITA map under the keyword "doctitle", but that won't fly. I can't do
and since I am using templates for the main topics, I don't want to have to customize the template for each document. (We are expecting to have to do 640+ of this one type of document.)
I have the document project structured with chapter templates in one location, system level keywords in another, and document level keywords and concepts in a third. But my document specific keywords file is filled with acronyms that should be and are system level keywords which are located in the system keywords DITAMAP. Reuse and content insertion does me no good if I still have to go through the document level XML and manually find and replace these values. The whole reason for going to DITA in the first place is to NOT have to do that.
Of course I can insert keywords into concept file elements. But I cannot insert concept elements into titles or the middle of paragraphs. Sometimes you just need a keyword.
I have been looking all over for a way to do this but cannot find what I am looking for. I cannot be the first to run into this problem. What is the industry standard for this kind of thing?
Thanks in advance for your help.
Like most technical documentation, our's is riddled with acronyms - acronyms that change on the boss' whim. So my document title might be: "CMES-BCA FN110: NCM Search Window" today, but "CMES Function110: EPM Search" tomorrow.
Well the whole thing is the title of a document, and I'd like it to be a keyword so it can be inserted into a title element. But "CMES-BCA" is a keyword, as is "FN110", as is "NCM", as is "Search Window". Ideally I would like to string them all together in my keyword DITA map under the keyword "doctitle", but that won't fly. I can't do
Code: Select all
<keydef keys="doctitle">
<topicmeta>
<keywords>
<keyword>text <keyword keyref="otherkw" /> more text <keyword keyref="anotherkw" /></keyword>
<keywords>
</topicmeta>
</keydef>
I have the document project structured with chapter templates in one location, system level keywords in another, and document level keywords and concepts in a third. But my document specific keywords file is filled with acronyms that should be and are system level keywords which are located in the system keywords DITAMAP. Reuse and content insertion does me no good if I still have to go through the document level XML and manually find and replace these values. The whole reason for going to DITA in the first place is to NOT have to do that.
Of course I can insert keywords into concept file elements. But I cannot insert concept elements into titles or the middle of paragraphs. Sometimes you just need a keyword.
I have been looking all over for a way to do this but cannot find what I am looking for. I cannot be the first to run into this problem. What is the industry standard for this kind of thing?
Thanks in advance for your help.