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

RE: if SGML is so great...



Finally, back to the real work.  :-)

> -----Original Message-----
> From: Stein Gjoen []
> Sent: Thursday, May 04, 2000 12:20 AM
> To: ldp-discuss@lists.debian.org
> Cc: ldp-discuss@lists.linuxdoc.org
> Subject: Re: if SGML is so great...
> 
> Greg Ferguson wrote:
> > 
> > On May 3,  9:39am, Gregory Leblanc wrote:
> 
> > > > Jorge Godoy wrote:
> 
> > > > > Stein Gjoen <sgjoen@mail.nyx.net> writes:
> 
> > > > > > To add near term benefits I would like a few new(?) tags
> > > > > >  - a command tag with chapter number for Linux commands
> > > > > >   such as "df(1)"
> > > > > >  - a keyword tag for global keywords that will be used
> > > > > >   in for instance metatags in HTML files
> > > > >
> > > > > We already have it. It's the <keywordset> tag.
> > > > > Use like this:
> > > > >
> > > > > <keywordset>
> > > > >     <keyword>metadata</keyword>
> > > > >     <keyword>more data</keyword>
> > > > > </keywordset>
> > > >
> > > > Interesting. How is it rendered, or is it at all?
> > > >
> > > > More importantly, where can I look to find out myself where
> > > > the tags are described without wading through masses of
> > > > incomprehensible datafiles?
> > >
> > > http://www.docbook.org/  The last part of DocBook: TDG is a
> > > comprehensive listing of all of the DocBook tags, with 
> descriptions,
> > > examples, and some incomprehensible datafile stuff, which 
> I usually
> > > ignore.  I've considered buying the book, but it's FAR more useful
> > > online than it would be a a desk reference for me.
> > >       Greg
> 
> These details should go into a doc for authors, perhaps the
> HOWTO-HOWTO. I do not have continuous access to the Internet
> to look up these things so an on-disk reference would be
> handy. From what I hear from others I am not alone in this
> situation.
> 
> > There is also a tag-quick-reference table that Norm (Walsh, 
> author of
> > DocBook: TDG) and Leonard Muellner put together...
> > 
> >         DocBook V3.1 Quick Reference
> >         http://www.nwalsh.com/docbook/defguide/qr/quickref.htm
> > 
> > lists <tag> and <brief description> only; but quite handy for
> > quick look-ups.
> 
> I have the feeling this is DocBook DTD as opposed to the
> LinuxDoc DTD, am I right? If so I'd like a similar reference
> guide for the LinuxDoc DTD. Last night I took a long hard look
> in the docs for SGMLTools and did not find what I needed there.

Yep, that's DocBook.  I think that the only such reference for the
LinuxDocDTD is the DTD itself.  If you're using an RPM based distribution,
then 'rpm -ql sgmltools' will give you a listing where you can probably find
the DTD itself.  

> Finally there is no <manpage> like tag in the mapping nor in the
> above mentioned references. A HOWTO reference tag would also be
> nice.

I think <refentry> is the DocBook tag, but I'm not 100% sure on that; I'm
fairly confident that LinuxDoc doesn't have anything useful for man pages.
As for the HOWTO reference tag, what do you mean?  Godoy and I have talked
about getting a special document type for the LDP called HOWTO, but I'm not
sure if he made any progress on that.  I'm not sure if you're looking for
something different in it's markup capabilities, or just in name.
        Greg


--  
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org