discuss: a year work and work in progress


Previous by date: 19 May 2009 08:28:49 +0100 Re: a year work and work in progress, Svetoslav Chukov
Next by date: 19 May 2009 08:28:49 +0100 Re: GFDL and GPL on the wiki, jdd
Previous in thread: 19 May 2009 08:28:49 +0100 Re: a year work and work in progress, Svetoslav Chukov
Next in thread: 19 May 2009 08:28:49 +0100 Re: a year work and work in progress, jdd for http://tldp.org

Subject: Re: a year work and work in progress
From: jdd ####@####.####
Date: 19 May 2009 08:28:49 +0100
Message-Id: <gutmq8$55c$1@ger.gmane.org>

Rick Moen a écrit :

> Well, in the _ideal_ case, we should have as upstream source format

yes

> But there was a cost:  People had to edit Docbook/Linuxdoc markup (and
> then run scripts to generate things like HTML).  I personally never
> found that a problem.

I think going to docook was an error. I never had problems with
linuxdoc, but docbook is awfull on a simple text editor and, at that
time, no friendly xml editor was available. Now simply use Kate :-).

For simple edition (fix an URL, for example), it may be simpler to use
docbook than wiki.

But IMHO, the main problem with xml and sgml as well was the backends.
 I don't want to submit a document prior to have seen it in rendered
form, and I always had problems to setup a rendering toolchain on my
computer. Even today, I can't run the ldp tool chain on my own
computer, only on my ibiblio account, an not anybody can do that :-).

> making available wiki editing of primary documents solves some of LDP's
> key "people problems".

Well... obviously the old system was not appealing :-). With the wiki,
we try to make new people to come, keeping the old working system for
anybody wanting it.

> 
> I'm not surprised that the export script (that you described) is poorly
> maintained:  The whole notion of Docbook as an _export_ format is a bit
> perverse.

Why? I don'think docbook was ever seen to be edited in vi. Given this,
MoinMoin is not a good xml editor :-(.

> Plucker is a popular compressed document format (and open source
> application) for PalmOS and WindowsME PDAs.

Popular? I have a windows mobile device and never heard about plucker
(out of LDP) - not a good reading device anyway. I will do a closer look.

> wiki markup) as primary document formats:  Gradually, everything but
> HTML and plaintext gets discarded as being (1) difficult and (2)
> perceived to no longer matter. 

It was originally stated that docbook made necessary a structured
document. I was surprised to see nearly any wiki page can be converted
to docbook, even with bad layout. Html is pretty bad in this respect.

Problem with the wiki is than it's an online system, not good for
lowbandwith.

jdd


Previous by date: 19 May 2009 08:28:49 +0100 Re: a year work and work in progress, Svetoslav Chukov
Next by date: 19 May 2009 08:28:49 +0100 Re: GFDL and GPL on the wiki, jdd
Previous in thread: 19 May 2009 08:28:49 +0100 Re: a year work and work in progress, Svetoslav Chukov
Next in thread: 19 May 2009 08:28:49 +0100 Re: a year work and work in progress, jdd for http://tldp.org


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