Automated Vocabulary

Section: Some MMCC-specific features
...Subsection: Automated Vocabulary

The automated vocabulary system makes use of HtX's library system to create document specific vocabulary lists drawn from a master vocabulary list (called a lib file). Here is what you do:

  1. include in the preamble a command like:
    \lib[ffffff]{demovcbl}{Vocabulary}
    

    demovcbl.lib is the file containing your vocabulary definitions. The file has the form:

    \lstart
    
    
    \lentry[title]{keyword}
    
    definition
    
    \lentry[title]{keyword}
    
    definition
    
    ...
    
    \lend
    
    

    title represents the term being definied. keyword is used to connect to the term from the text. It should be a single, lowercase word. If title is omitted, it is the same as keyword. Note: the final vocabulary list will be sorted by keyword.

    Here is a link to the lib file used for this demo.

  2. In your text you can annotate certain words using \vref. For example:
    All good \vref[wproc]{Word Processing} systems are \vref{WYSIWYG}.
    

    The result is:

    All good Word Processing systems are WYSIWYG .

    Again, if the keyword is omitted, it is the same as the printed test.

  3. Include the command \vocab near the end of your document, just before any references. This will create the vocabulary section in the contents.

Note: the simple \begin{vocab}..\end{vocab} construction has also been retained.

Here are some more examples:

There are often 2 types of checkers in a word processing system: the spelling checker checks spelling; the grammar checker checks grammar. Many systems also have capacity for headers and footers . Some do word wrap and justification . Font sizes are in point s or PICA units.

Note the -- this reference does not have a corresponding entry in the lib file. Better put one in!!


rms@cs.oberlin.edu