DITA: Index entries
There are various approaches for adding indexes, but here's a typical way to add index entries.
prolog | metadata | keywords element of a topic, add index terms The
prolog element comes just after the
(which follows the title). Here's a
When you want to create a "see" entry for an index, code it like this:
The result of the index-see element is the following:
If you want to include a page number with the see also reference, write it like this:
The output will look like this:
Keep in mind that index entries added to the
prolog section will include page
numbers pointing to the location of the
prolog. Since most topics are short,
this isn't a problem. Also, since the online help is usually the main deliverable, it's also
not a problem. However, you can also add index entries in the middle of your topics. (But
apparently this causes some problems, especially with translation.)
Also, some PDF renderers don't include page numbers to index entries. At any rate, since PDF isn't usually the main deliverable, this is not a concern with index terms.
About Tom Johnson
I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.
If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.