Created
January 16, 2013 13:22
-
-
Save infotexture/4547112 to your computer and use it in GitHub Desktop.
DITA markup for (hidden) indexterms vs. (visible) keywords
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
<?xml version="1.0" encoding="UTF-8"?> | |
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd"> | |
<reference id="ID"> | |
<title id="Module">Module Name</title> | |
<prolog> | |
<metadata> | |
<keywords> | |
<!-- These keywords are included in index but not visible in output --> | |
<indexterm>$KEYWORD1$</indexterm> | |
<indexterm>$KEYWORD2$</indexterm> | |
<indexterm>$KEYWORD3$</indexterm> | |
</keywords> | |
</metadata> | |
</prolog> | |
<refbody> | |
<section> | |
<title>Keywords</title> | |
<!-- These keywords are visible in output but not included in index --> | |
<keyword>$KEYWORD1$</keyword>, <keyword>$KEYWORD2$</keyword>, <keyword>$KEYWORD3$</keyword> | |
</section> | |
</refbody> | |
</reference> |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
For a software reference project, I need to include keyword metadata in topics so that the keywords appear both in an index and in the topic body output.
<indexterm>
elements specified in the prolog metadata are included in the index but not visible in output, whereas<keyword>
elements that appear in the topic body are visible in output but not included in the index.Is there any way to avoid this redundant markup and specify the keywords once so they appear in both the index and in output?