discuss: TLDP DocBook pages need work - Start there!


Previous by date: 25 Nov 2003 16:24:01 -0000 Re: more wiki (was Re: the good the bad and the ugly), doug jensen
Next by date: 25 Nov 2003 16:24:01 -0000 Some quick technical reviews of old HOWTO's, David Horton
Previous in thread: 25 Nov 2003 16:24:01 -0000 Re: TLDP DocBook pages need work - Start there!, Rodolfo J. Paiz
Next in thread: 25 Nov 2003 16:24:01 -0000 Re: TLDP DocBook pages need work - Start there!, David Lawyer

Subject: Re: TLDP DocBook pages need work - Start there!
From: jdd ####@####.####
Date: 25 Nov 2003 16:24:01 -0000
Message-Id: <3FC38219.9090704@dodin.net>

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:

* inclusion of images (figures)
* inclusion of tables

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.

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



Previous by date: 25 Nov 2003 16:24:01 -0000 Re: more wiki (was Re: the good the bad and the ugly), doug jensen
Next by date: 25 Nov 2003 16:24:01 -0000 Some quick technical reviews of old HOWTO's, David Horton
Previous in thread: 25 Nov 2003 16:24:01 -0000 Re: TLDP DocBook pages need work - Start there!, Rodolfo J. Paiz
Next in thread: 25 Nov 2003 16:24:01 -0000 Re: TLDP DocBook pages need work - Start there!, David Lawyer


  ©The Linux Documentation Project, 2014. Listserver maintained by dr Serge Victor on ibiblio.org servers. See current spam statz.