198 lines
8.5 KiB
HTML
198 lines
8.5 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Re: if SGML is so great... -->
|
|
<!--X-From-R13: Fnxrgbfuv Enab <xtu12351Navsgl.ar.wc> -->
|
|
<!--X-Date: Sun, 7 May 2000 11:14:47 -0400 (EDT) -->
|
|
<!--X-Message-Id: y5a3dnvjjah.fsf@kgh12351.nifty.ne.jp -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: A5F46F4ED18FD211ABEE00105AC6CF077F805B@email.cu-portland.edu -->
|
|
<!--X-Reference: 3911C742.3AA77FD7@mail.nyx.net -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Re: if SGML is so great...</title>
|
|
<link rev="made" href="mailto:kgh12351@nifty.ne.jp">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg02311.html">Date Prev</a>][<a href="msg02313.html">Date Next</a>][<a href="msg02261.html">Thread Prev</a>][<a href="msg02264.html">Thread Next</a>][<a href="maillist.html#02312">Date Index</a>][<a href="threads.html#02312">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Re: if SGML is so great...</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: Stein Gjoen <<A HREF="mailto:sgjoen@mail.nyx.net">sgjoen@mail.nyx.net</A>></li>
|
|
<li><em>Subject</em>: Re: if SGML is so great...</li>
|
|
<li><em>From</em>: Taketoshi Sano <<A HREF="mailto:kgh12351@nifty.ne.jp">kgh12351@nifty.ne.jp</A>></li>
|
|
<li><em>Date</em>: 07 May 2000 09:28:06 +0900</li>
|
|
<li><em>Cc</em>: Gregory Leblanc <<A HREF="mailto:GLeblanc@cu-portland.edu">GLeblanc@cu-portland.edu</A>>, <A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A></li>
|
|
<li><em>In-reply-to</em>: <<a href="msg02261.html">3911C742.3AA77FD7@mail.nyx.net</a>>(Stein Gjoen's message of "Thu, 04 May 2000 20:53:54 +0200")</li>
|
|
<li><em>References</em>: <<a href="msg02258.html">A5F46F4ED18FD211ABEE00105AC6CF077F805B@email.cu-portland.edu</a>> <<a href="msg02261.html">3911C742.3AA77FD7@mail.nyx.net</a>></li>
|
|
<li><em>Resent-date</em>: Sun, 7 May 2000 11:14:47 -0400 (EDT)</li>
|
|
<li><em>Resent-from</em>: <A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A></li>
|
|
<li><em>Resent-message-id</em>: <_UgQkC.A.LUC.UhYF5@murphy></li>
|
|
<li><em>Resent-sender</em>: <A HREF="mailto:ldp-discuss-request@lists.debian.org">ldp-discuss-request@lists.debian.org</A></li>
|
|
<li><em>User-agent</em>: T-gnus/6.13.3 (based on Pterodactyl Gnus v0.98) EMIKO/1.13.9 (Euglena tripteris) FLIM/1.13.2 (Kasanui) APEL/10.2 Emacs/20.5 (i386-debian-linux-gnu) MULE/4.0 (HANANOEN)</li>
|
|
</ul>
|
|
<!--X-Head-of-Message-End-->
|
|
<!--X-Head-Body-Sep-Begin-->
|
|
<hr>
|
|
<!--X-Head-Body-Sep-End-->
|
|
<!--X-Body-of-Message-->
|
|
<pre>
|
|
Hello. Sorry to be late in discussion.
|
|
|
|
In article <<a href="msg02261.html">3911C742.3AA77FD7@mail.nyx.net</a>>,
|
|
at Thu, 04 May 2000 20:53:54 +0200,
|
|
Stein Gjoen <sgjoen@mail.nyx.net> writes:
|
|
|
|
> > > > > > More importantly, where can I look to find out myself where
|
|
> > > > > > the tags are described without wading through masses of
|
|
> > > > > > incomprehensible datafiles?
|
|
|
|
> > > These details should go into a doc for authors, perhaps the
|
|
> > > HOWTO-HOWTO. I do not have continuous access to the Internet
|
|
> > > to look up these things so an on-disk reference would be
|
|
> > > handy. From what I hear from others I am not alone in this
|
|
> > > situation.
|
|
|
|
> > > I have the feeling this is DocBook DTD as opposed to the
|
|
> > > LinuxDoc DTD, am I right? If so I'd like a similar reference
|
|
> > > guide for the LinuxDoc DTD. Last night I took a long hard look
|
|
> > > in the docs for SGMLTools and did not find what I needed there.
|
|
|
|
> > Yep, that's DocBook. I think that the only such reference for the
|
|
> > LinuxDocDTD is the DTD itself. If you're using an RPM based distribution,
|
|
> > then 'rpm -ql sgmltools' will give you a listing where you can probably find
|
|
> > the DTD itself.
|
|
>
|
|
> I use LinuxDoc from a DEB package. I used find and grep to locate
|
|
> the files but that is not optimum.
|
|
|
|
Please check files under /usr/doc/sgml-tools/
|
|
You will find example.sgml.gz, an example of linuxdoc dtd sgml file,
|
|
written by Matt Welsh, 28 March 1994.
|
|
And there is the SGML-Tools User's Guide, sgml file is guide.sgml.gz,
|
|
and the various converted files are: guide.dvi.gz, guide.lyx.gz, guide.ps.gz,
|
|
guide.txt.gz, html/guide*.html
|
|
|
|
> Also online docs are not anoption when I write and that is the
|
|
> situation for many others too. I need useful docs on my disk.
|
|
|
|
> My large reply crashed here so I'll rewrite it later. In summary
|
|
> I feel we need more tags for our specific needs. SGML is
|
|
> scalable and extensible, right?
|
|
|
|
I think that LinuxDoc DTD is a small and easy-to-learn thumbnail
|
|
of SGML. It has been used for years, but gradually give the place
|
|
to DocBook DTD. LinuxDoc DTD has limited power in SGML area, but
|
|
the conversion is faster. DocBook DTD has full power in SGML, so
|
|
it can be extended by using the custom stylesheet to add the more
|
|
tags.
|
|
|
|
Stephane Bortzmeyer wrote in his The Debian SGML/XML HOWTO
|
|
(<A HREF="http://www.debian.org/~bortz/SGML-HOWTO/">http://www.debian.org/~bortz/SGML-HOWTO/</A>) that
|
|
|
|
| Customizing the Modular DocBook Stylesheets
|
|
|
|
|
| If you write a custom element or if you want to change the default rendering of
|
|
| an element or if you simply want to customize the output a bit (such as
|
|
| changing the default font), you'll have to define a custom stylesheet. This
|
|
| does not imply retyping everything. DSSSL allows one stylesheet to "use"
|
|
| another. The stylesheet inherits all of the properties of the stylesheet that
|
|
| it is using, but local definitions take precedence over imported ones. An
|
|
| example of a custom stylesheet is:
|
|
|
|
(snip)
|
|
|
|
| Your style instructions (here the changing of the font to Palatino) have to be
|
|
| written in DSSSL, whose syntax and many semantics come from the programming
|
|
| language Scheme, which is itself a Lisp dialect. You do not need to learn
|
|
| Scheme, the documentation of the Modular Stylesheets (the link will work only
|
|
| if you installed the package "docbook-stylesheets-doc") contains examples for
|
|
| most purposes.
|
|
|
|
|
| Since there are actually two stylesheets, one for printing and one for HTML,
|
|
| the above custom stylesheet works only for the first one. For the second, here
|
|
| is an exemple:
|
|
|
|
(snip)
|
|
|
|
| In both cases, you'll have to tell Jade to use your stylesheets, here
|
|
| myprint.dsl:
|
|
| jade -t tex -V tex-backend \
|
|
| -d myprint.dsl \
|
|
| /usr/lib/sgml/declaration/xml.dcl myfile.db
|
|
|
|
|
|
|
(snip)
|
|
|
|
| Customizing the DocBook DTD
|
|
|
|
|
| DocBook is intended to be customizable. There are many ways to do that[3],
|
|
| but be careful: customization may lead to problems when exchanging documents
|
|
| with others. See Customizer's Guide for the DocBook DTD (the link will work
|
|
| only if you installed the package "docbook-doc").
|
|
|
|
|
| If you add new elements, you'll probably have to create a custom stylesheet as
|
|
| well.
|
|
|
|
--
|
|
Taketoshi Sano: <sano@debian.org>,<sano@debian.or.jp>,<kgh12351@nifty.ne.jp>
|
|
|
|
|
|
--
|
|
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
|
|
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
|
|
|
|
</pre>
|
|
|
|
<!--X-Body-of-Message-End-->
|
|
<!--X-MsgBody-End-->
|
|
<!--X-Follow-Ups-->
|
|
<hr>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<ul><li><strong>References</strong>:
|
|
<ul>
|
|
<li><strong><a name="02258" href="msg02258.html">RE: if SGML is so great...</a></strong>
|
|
<ul><li><em>From:</em> Gregory Leblanc <GLeblanc@cu-portland.edu></li></ul></li>
|
|
<li><strong><a name="02261" href="msg02261.html">Re: if SGML is so great...</a></strong>
|
|
<ul><li><em>From:</em> Stein Gjoen <sgjoen@mail.nyx.net></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg02311.html">conditional expression in LinuxDoc (Re: if SGML is so great...)</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg02313.html">Re: if SGML is so great...</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg02261.html">Re: if SGML is so great...</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg02264.html">RE: if SGML is so great...</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#02312"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#02312"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|