Re: Context manuals

[Hans Hagen <pragma@wxs.nl>]

At 09:15 PM 10/23/2002 +0200, Henning Hraban Ramm wrote:
>Am Mittwoch, 23. Oktober 2002 01:23 schrieb Hans Hagen:
>
>[AUTHOR]
> > >Perhaps <faq author="user"> is better.
> > >I'd use your verbose tags only in a user database.
> > but you want to typeset the names correctly, and also be able to sort them
> > in several ways ...
>
>But I get much redundancy and perhaps inconsistency if I give whole author
>information in every question.
>Therefore I would only give some short name ("login") and collect the whole
>information (forename, surname, email, homepage, quote...) in a separate
>authors/users database.

ah, i didn't get that, sounds ok to me.

>[KEYWORDS]
> > > >    <entry key="xyz">exeizet</entry>
> > >The bundling is ok, but why should the entry use an option?
> > unless you also want to sort 'm, typeset them, etc
> > xml is about reusing information !
>
>Please explain, what the 'key="xyz"' is for?

\TeX should be sorted under tex or tech, so there is a typo as well as 
sorting version

>I would define keywords for searching (web version) and indexing (PDF 
>version)
>-- what does a keyword need an other description?
>e.g.
><keywords>
>         <entry>math</entry>
>         <entry>formula</entry>
></keywords>
>or perhaps
><keywords>
>         <entry lang="en">math</entry>
>         <entry lang="en">formula</entry>
>         <entry lang="de">Mathematik</entry>
>         <entry lang="de">Formel</entry>
></keywords>
>
>(I'd like to make the FAQ multilingual, but I guess it's too much work...)

just go for english

> > of course they can link, just define your element/attribute as such; it's
> > up to you to define that something links:
> > <whatever file="..." location="..."/>
>
>would be
><author file="authors.xml">hans</author>
><editor file="authors.xml">hraban</editor>
>correct?

no, more something:

<include href="authors.xml">

<author label="hans"/>
<author label="hraban"/>

saves keystrokes too - )

Hans
-------------------------------------------------------------------------
                                   Hans Hagen | PRAGMA ADE | pragma@wxs.nl
                       Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
  tel: +31 (0)38 477 53 69 | fax: +31 (0)38 477 53 74 | www.pragma-ade.com
-------------------------------------------------------------------------
                        information: http://www.pragma-ade.com/roadmap.pdf
                     documentation: http://www.pragma-ade.com/showcase.pdf
-------------------------------------------------------------------------