bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Acronyms in HTML


From: Dumas Patrice
Subject: Re: Acronyms in HTML
Date: Fri, 28 Nov 2003 17:09:57 +0100
User-agent: Mutt/1.4.1i

> That looks ok to me.
> 
>     By the way, I have a couple of books with an ``Acronyms Used in This
>     Book'' section.  It may be nice to give the authors an easy way to
>     create such a section, ie. with a @listofacronyms command.
> 
> I don't think it's worth it, because a real glossary wouldn't just have
> an entry:
> XML   eXtensible Markup language

If I am not wrong it is not a glossary, but really a list of acronyms.

> A good glossary would have more explanation, references, etc.  And all
> that wouldn't work in the context of the @acronym in the text.

It reminds me that I think that it could be nice if there was a command 
which could produce glossary terms. I repeat that it is different from a list
of acronyms. It could be something implemented similarly than what is 
proposed for acronyms: first time the glossary term appears, it could be 
something like:

    A @glossary{Public Good, A public good is a non rival and non 
    excludable good} may be used in the production....

And it could reappear as

    In that case the @glossary{Public Good} is provided by the state...

And there could be a 

    @listofglossaryterms

command to output a special section with glossary terms. In html, each
time a @glossary{term} appears there could be a link to the glossary 
term and definition outputted after @listofglossaryterms.

It could even be possible to generalize such list of definitions by having
a command like 
    @definition{Glossary, Public Good, A public good is a non rival and non   
    excludable good}

And in the end a 
    @listof Glossary
or 
    @listofdefinitions Glossary

There could be for example
   @definition{Bibliography, @cite{My Book}, book edited by me}
   ... described in @definition{Bibliography, @cite{My Book}} ....

   @listof Bibliography

In info a ref could be automatically generated. There could be issues if 
there is an anchor with the same name, but this shouldn't happen.
For example @definition{Bibliography, @cite{My Book}} could be automatically
translated in something with the same rendring than 
@ref{Bibliography @cite{My Book}} and a (virtual) anchor 
@anchor{Bibliography @cite{My Book}} would be generated by 
@listof Bibliography

A @macro could also be used, I made such macros, but makeinfo broke on
it.

Pat




reply via email to

[Prev in Thread] Current Thread [Next in Thread]