docbook: is the linuxdoc DTD deprecated for LDP?
Subject:
Re: is the linuxdoc DTD deprecated for LDP?
From:
Peter Jay Salzman ####@####.####
Date:
3 Aug 2002 17:54:33 -0000
Message-Id: <20020803175429.GA26760@dirac.org>
Hi Tabatha,
I should've been more upfront with you. :-)
I'm the author of the Debian Jigdo mini-HOWTO, and someone translated
the mini-HOWTO to German, which I submitted to the German HOWTO
coordinator.
The submission was flatly rejected for two reasons:
1. It uses "oe" instead of the German umlat (easily fixed).
2. It uses SGML/Docbook rather than the Linuxdoc DTD. Apparently,
German submissions are ONLY allowed in Linuxdoc. Not Docbook.
And not easily fixed.
The translator's job would be much easier if he could just take my
future revisions, cut and paste the changes I've made and do the
translation. Requiring him translate the markup language seems to be a
big waste of his time. Especially since Docbook is one of the accepted
markup languages for LDP.
I was going to make the case why the German coordinator should drop the
requirement of Linuxdoc. I thought I remembered reading somewhere that
Docbook and XML are favored over Linuxdoc, and was going to use that
fact to help bolster my case why he should accept the Debian Jigdo
mini-HOWTO's German translation, after all the "oe"'s were changed to
umlats.
My girlfriend can do the umlat thing quickly, since she's fluent in
German. But translating the markup language is a hardship for everyone
involved, and seems unreasonable.
What do you think? I can use some advice here.
Thanks, Tabatha!
Pete
begin Tabatha Persad ####@####.####
> On Sat, 2002-08-03 at 12:35, Peter Jay Salzman wrote:
> > Months ago, I roamed the LDP site, reading about how to submit documents
> > to the LDP.
> >
> > I *thought* I remember reading that the Linuxdoc DTD has been deprecated
> > in favor of SGML/docbook and XML.
> >
> > I tried finding a reference to this in the LDP Author Guide and the LDP
> > website. Couldn't find it.
>
> In section 2.5 of the Author's guide it mentions that when an author
> submits their document, a member of the LDP will translate the text to
> DocBook markup and that from there on the markup would be in DocBook.
> But please read on.
>
> > Am I simply not remembering this correctly, or is docbook and XML really
> > favored over LinuxDoc?
> >
> > References would be appreciated if I'm remembering correctly.
>
> If you were to have this discussion in the discuss mailing list, you would
> probably find out that there are lots of folks still using Linuxdoc markup
> and there are still a great deal of documents that don't require the
> complexity of DocBook.
>
> Ideally I think the LDP would like to see the latest markup used for
> documentation, particularly XML since it's so platform friendly.
>
> Do you need help with DocBook at all? Let me know if I can be of
> assistance!
>
> --
> Tabatha Persad
> Web: www.merlinmonroe.com
> Linux Documentation Project Editor (http://www.tldp.org)
> Gnu Writing Movement Contributor (http://gwm.gnu.org)
> Linux Counter Area Manager US:wa (http://counter.li.org)
>
--
Please don't put my email address in your Outlook addressbook.
GPG Fingerprint: B9F1 6CF3 47C4 7CD8 D33E 70A9 A3B9 1945 67EA 951D
