discuss: TLDP DocBook pages need work - Start there!
Subject:
Re: TLDP DocBook pages need work - Start there!
From:
David Lawyer ####@####.####
Date:
25 Nov 2003 22:37:01 -0000
Message-Id: <20031125215946.GD504@lafn.org>
On Tue, Nov 25, 2003 at 05:23:53PM +0100, jdd wrote:
> preliminary:
>
> you all, friends, could you _remove_ the multiple addresses?? (4 return
> addresses on this mail!) before sending? thanks. return to the list is
> enough
>
>
> Rodolfo J. Paiz wrote:
>
> >On Sun, Nov 23, 2003 at 01:51:16PM -0500, John R. Daily wrote:
> > > What is the functional difference between LinuxDoc and a
> > > comparable subset of DocBook tags[1] with a well-defined toolchain?
> >
> >That question has not been answered. Personally, I like DocBook as being
> >more flexible and more scalable (things that come along with the
>
> this discussion is a long story. I can answer part of it because I was
> involved.
>
> long ago, I become a writer for the ldp and learned linuxdoc. I even
> wrote a small guide to sgml (for my own use). It took me an afternoon to
> do so.
>
> LyX was pretty well able to cope with linuxdoc so there was a handy
> alternative to vi, but linuxdoc is so simple vi was not really a probl?m
> (in fact it's only a problem in french 'cause of accented characters)
>
> it was pretty difficult then to set up the _backends_ (sgml2xx),but it
> was manageable, and the result as well html as printed was very pretty.
>
> two things where difficult with linuxdoc:
were
>
> * inclusion of images (figures)
Here's how you're supposed to do it in linuxdoc:
<figure>
<img src="logo.png">
<caption>The Penguin Logo of the Linux</caption>
</figure>
> * inclusion of tables
There's a way to do this too in linuxdoc, but I don't use it.
> however, on small docs, given the necessity of keeping a full text
> version possible, we could live with.
>
> the only benefit from docbook is so the possibility of including the two
> lacking elements.
In linuxdoc these elements may not be rendered too well in text format.
But since I haven't used them yet, I don't really know. Perhaps one
shouldn't use images at all since they can't exist in the text format.
For tables in linuxdoc, I just use typewriter fonts with a verbatim
(<verb>) tag. It's a lot simpler than creating a table that will
translate into an html table. Such verbatim tables of course appear in
html under the <pre> tag but are not as fancy.
> but the drawback is very hard writing - I never could put my hand on a
> usefull docbook writer (and I tried many). given that most HOWTO authors
> use docbook once a year... prett hard for a learning curve.
>
> jdd
>
> --
> http://www.dodin.net
> Me contacter avant d'envoyer une pi?ce jointe, merci.
> Une chanteuse sur Toulouse?
> http://valerie.dodin.net
>
>
>
> ______________________
> http://lists.tldp.org/
>
>
David Lawyer