[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

sgmltools: v1 and v2



Hi.

In <[🔎] E11H9z8-0003O9-00@burrito>,
 at Date: Wed, 18 Aug 1999 13:58:50 -0400,
  on Subject: Re: Sven Rudolph: Re: still looking for someone to adopt sgml-tools? ,
   Adam Di Carlo <adam@onshore.com> writes:

> First, I want to make sure you are clear on the difference between
> SGMLtools v1 and v2.  v1 is a local, non-std DTD (LinuxDoc), which
> uses custom SGMLasp to provide rendering; therefore, it is
> non-standard and custom thru-and-thru.
> 
> v2 of SGMLtools is completely different.  It is based on the DocBook
> DTD, which is maintained by OASIS, and has been around for a while,
> and is very popular for technical documentation.  Moreover, it uses
> DSSSL, which is an ISO standard for doing rendering.  In the future
> this might move to and XML DTD and using XSL instead of DSSSL, but
> that doesn't matter to the author.  See the URLs in
> /usr/doc/docbook-stylesheets/README.Debian for more info.

I know very little about DocBook DTD and DSSSL. I should have learn
about them first of all. Thank you for teaching me about difference
of v1 and v2. I read /usr/doc/docbook-stylesheets/index.html now.
 
> Therefore, with or without SGMLtools, adopting DocBook is a good idea,
> even in SGMLtools went away tomorrow.

hmm, it is future work. May be we (JF people) have to move to do it.
But currently many LDP documents are written using linuxdoc DTD,
and when translating them into Japanese, it is easy to use same dtd.

When we write our original documents, maybe we should try to use
DocBook DTD. Before that, I need the good tutorial ,,,

adam> Moreover, Norm Walsh's DSSSL stylesheets DocBook are i18n and l10n'd.
adam> They already include japaense support.  As the Jade maintainer, and
adam> the sgml-data and docbook-stylesheets maintain, I'd love to work with
adam> you and the upstream maintainers to make sure that any issues are
adam> solved.  It's also important that we have a convenience SGML framework
adam> for translators to use.

Oh, I am very glad to read this :) Currently I don't know how to use jade, 
but I hope that I can use it to create my documents.

adam> > Now I am happy to know that Stephane will be the new maintainer of 
adam> > sgml-tools and I hope that he can merge that JF patch into his coming 
adam> > new package.
adam> 
adam> Yes that would be nice.  Despite what I said above, I think we ought
adam> to provide *some* level of support to SGMLtools v1.

Yes, We need it for our old but useful documents, and for translation of 
the current Linuxdoc DTD'd LDP documents.

Thanks.

-- 
  Taketoshi Sano: <kgh12351@nifty.ne.jp>,<sano@debian.org>


Reply to: