Hi Robert for glossary: if you mark only for html, that would be visible only there. the benefit of make-doc dialect is, it is readble as text too. so how about this:
dialect?: something special nearly the same as the usual. text?: you can't use smart hovering.. html?: text which knows there is a mouse. make-doc?: a quick way to write good looking. for general words there is an include-option. -volker Am Mittwoch, 5. Juni 2002 14:55 schrieb Robert M. Muench: > 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.
