docbook: is the linuxdoc DTD deprecated for LDP?
Subject:
Re: is the linuxdoc DTD deprecated for LDP?
From:
Peter Jay Salzman ####@####.####
Date:
5 Aug 2002 08:27:11 -0000
Message-Id: <20020805082705.GA6579@dirac.org>
hi alexander and all,
if i understand this correctly, we have a problem.
the last thing i wanted was to stir up controversy. but by the same
token, i feel pretty awful that someone took the time to translate 15
pages of docbook and it's beginning to look like his effort will be
useless.
the translator doesn't even know docbook -- he just translates the
"stuff" that goes between the tags. asking him to learn both docbook
and linuxdoc in order to translate both the words and the markup is just
too much to ask. i would be embarrased to even ask that of him.
it's also not fair to german speaking people who'd rather learn about
debian jigdo in their own language.
i'm a nobody here -- just a writer who has a guide, howto and a
mini-howto under his belt. can someone with clout plead the case that
the standards for tldp should be ... standard?
or is there someway of short circuiting marco and submitting the german
document directly to tldp?
pete
begin Alexander Bartolich ####@####.####
> Tabatha Persad wrote:
> > [...] Ah, well it was worth a try. It would be nice to understand
> > why they only accept LinuxDoc over DocBook, but I suppose
> > someone will have to step forth and explain those reasons.
>
> Is there any 'official' relationship with Marco Budde,
> ####@####.#### the operator of the project?
> Main page is http://www.tu-harburg.de/dlhp/
>
> The general appearance seems to be typical for German
> old-school, though. You should know that German netiquette
> is many times more extreme than it ever was in it's originating
> culture. (BTW: I'm Austrian, and we are not too fond of that
> barrack yard style).
>
> There is a document explaining whereabouts of the project
> (similar to the Author Guide here). I translated interesting
> parts:
>
> # Die HOWTOs sollten inhaltlich korrekt sein. Insbesondere
> # bei ?bersetzungen von LDP HOWTOs sollte unbedingt vorher
> # ?berpr?ft werden, ob die HOWTO es ?berhaupt wert ist,
> # ?bersetzt zu werden. Leider gibt es beim LDP anscheinend
> # keine Qualit?tskontrolle, so da? viele LDP HOWTOs teilweise
> # bis v?llig falsch sind.
>
> Content of HOWTOs should be correct. Before considering
> translation of LDP HOWTOs you should absolutely verify
> that the HOWTO is worth the trouble of translation at all.
> Regrettably there does not seem to be quality control at LDP,
> resulting in a lot of LDP HOWTOs being partially or completely wrong.
>
> Later on it is declared that the project uses sgml-tools 1.0.9.
> (absolutely no comment on other tools). Using version 2.x of
> sgml-tools is not accepted because of incompatibilities and
> bugs. The story continues with the revelation that recent
> compilers fail to build the original sources of sgml-tools 1.0.9,
> so the project provides a patch. But that's not the end:
>
> # Hierbei sollte man jedoch unbedingt beachten, da? die LDP
> # HOWTOs auf einer anderen Formatierungsrichtlinie beruhen.
> # Man kann also nicht einfach die bestehende Formatierung
> # ?bernehmen, sondern mu? diese eventuell an die in diesem
> # Dokument beschriebene anpassen.
>
> Take into account that LDP HOWTOs are based on a different
> formatting guideline. You can't just take over the existing
> format but possibly have to change it to the one described in
> this document. And the only example on that page is
> <!doctype linuxdoc system>
>
> Though this be madness, yet there is method in it.
>
> The document links to the old site name, by the way:
> http://www.linuxdoc.org/docs.html#howto
> So I guess that Marco Budde has no close relationship to
> this list or TLDP.
>
> Can any of the 'politicians' please speak up?
>
> --
> GMX - Die Kommunikationsplattform im Internet.
> http://www.gmx.net
