Try the XML version of this page. If you have problems with it, consult the compatibility page.

Markup Utility

The Markup Utility is a utility for finding and changing words and phrases within some text. You can use it to:

• highlight important terms in your text
• link phrases to other pages
• search and replace words within some text

Instructions

1. Download the markup.xsl stylesheet into the same directory as your stylesheet.

2. Import the markup.xsl stylesheet into your stylesheet:

   <xsl:import href="markup.xsl" />

3. Call the template 'markup' with two parameters: text being the text to be marked up, and phrases being the phrases to be marked up within it:

   <xsl:call-template name="markup">
     <xsl:with-param name="text" select="." />
     <xsl:with-param name="phrases" select="/doc/keywords/keyword" />
   </xsl:call-template>
   

4. Create templates in 'markup' mode that match the keyword nodes and do the marking up. These can use the 'word' parameter to give the actual term that's being marked up:

   <xsl:template match="*" mode="markup">
     <xsl:param name="word" />
     <a href="{@id}.html">
       <xsl:value-of select="$word" />
     </a>
   </xsl:template>
   

There are a few extra options that you can set as parameters for the 'markup' template, namely:

$words-only [= true]

• true: only whole words should be marked up (separated by punctuation)
• false: any matching occurrence should be marked up, whether whole word or not.

$first-only [= false]

• true: only the first occurence of a word in a piece of text should be marked up
• false: all occurrences of a word in a piece of text should be marked up

$match-case [= false]

• true: only occurences where the case matches exactly should be marked up
• false: all occurences of the word should be marked up, regardless of case

More Information