Hi, I'm thinking about adding a glossary function to MDP. There are several
possibilities to implement such a function. The goal is that glossary words will
display the glossary description of the mouse is moved over the word. I want to
use the <DFN> HTML tag for this.

I'm not sure which version is most pratical for the user:

1. Explicit marking the words with ?gloassary-word?

Result: For all words marked with ? make-doc-pro would make a look up in a text
file and include the definition into the output.

Advantages:
- Esay to implement
- Simple usage
- User can decide where to include glossary output and where not

Disadvantages:
- If you want the glossary term for all the same words, you have to wrap them
all in ? sequence.


2. Explicit marking of words with ?glossary-word? once

Result: Same as 1. but now make-doc-pro would include the glossary definition
for all appearances of the word.

Advantages:
- User only has to mark the word once in a file.

Disadvantages:
- If the glossary text is long, it will be included several times into the HTML
output. (Is there a trick to reference such text-blocks in HTML?)


3. Explicit marking of all words found in glossary

Result: make-doc-pro uses the glossary file and just includes the description
for all words that are found in the glossary.

Advantages:
- No markup needed for the user.
- Can simple be turned on off.

Disadvantages:
- Same as 2.

What do you think? Which version is most useful for you? Do you have any other
ideas how to handle such a functionality? Robert


-- 
To unsubscribe from this list, please send an email to
[EMAIL PROTECTED] with "unsubscribe" in the 
subject, without the quotes.

Reply via email to