old-www/pub/Linux/docs/ldp-archived/mail_archives/ldp-discuss/msg02260.html

163 lines
6.6 KiB
HTML

<!-- MHonArc v2.5.0b2 -->
<!--X-Subject: Re: if SGML is so great... -->
<!--X-From-R13: "Uert Trethfba" <tsretNubbc.gvzbavhz.ftv.pbz> -->
<!--X-Date: Thu, 4 May 2000 11:43:13 &#45;0400 (EDT) -->
<!--X-Message-Id: 10005041141.ZM9971@hoop.timonium.sgi.com -->
<!--X-Content-Type: text/plain -->
<!--X-Reference: A5F46F4ED18FD211ABEE00105AC6CF077F805B@email.cu&#45;portland.edu -->
<!--X-Reference: GLeblanc@cu&#45;portland.edu -->
<!--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:gferg@hoop.timonium.sgi.com">
</head>
<body>
<!--X-Body-Begin-->
<!--X-User-Header-->
<!--X-User-Header-End-->
<!--X-TopPNI-->
<hr>
[<a href="msg02259.html">Date Prev</a>][<a href="msg02261.html">Date Next</a>][<a href="msg02258.html">Thread Prev</a>][<a href="msg02261.html">Thread Next</a>][<a href="maillist.html#02260">Date Index</a>][<a href="threads.html#02260">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>: Gregory Leblanc &lt;<A HREF="mailto:GLeblanc@cu-portland.edu">GLeblanc@cu-portland.edu</A>&gt;, &quot;'Stein Gjoen'&quot; &lt;<A HREF="mailto:sgjoen@mail.nyx.net">sgjoen@mail.nyx.net</A>&gt;, <A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A></li>
<li><em>Subject</em>: Re: if SGML is so great...</li>
<li><em>From</em>: &quot;Greg Ferguson&quot; &lt;<A HREF="mailto:gferg@hoop.timonium.sgi.com">gferg@hoop.timonium.sgi.com</A>&gt;</li>
<li><em>Date</em>: Thu, 4 May 2000 11:41:59 -0400</li>
<li><em>Cc</em>: <A HREF="mailto:ldp-discuss@lists.linuxdoc.org">ldp-discuss@lists.linuxdoc.org</A></li>
<li><em>In-reply-to</em>: Gregory Leblanc &lt;GLeblanc@cu-portland.edu&gt; &quot;RE: if SGML is so great...&quot; (May 4, 8:17am)</li>
<li><em>References</em>: &lt;<a href="msg02258.html">A5F46F4ED18FD211ABEE00105AC6CF077F805B@email.cu-portland.edu</a>&gt;</li>
<li><em>Resent-date</em>: Thu, 4 May 2000 11:43:13 -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>: &lt;hX2BAD.A.wqH.FqZE5@murphy&gt;</li>
<li><em>Resent-sender</em>: <A HREF="mailto:ldp-discuss-request@lists.debian.org">ldp-discuss-request@lists.debian.org</A></li>
</ul>
<!--X-Head-of-Message-End-->
<!--X-Head-Body-Sep-Begin-->
<hr>
<!--X-Head-Body-Sep-End-->
<!--X-Body-of-Message-->
<pre>
On May 4, 8:17am, Gregory Leblanc wrote:
&gt; Subject: RE: if SGML is so great...
&gt; &gt;
&gt; &gt; &gt; There is also a tag-quick-reference table that Norm (Walsh,
&gt; &gt; author of
&gt; &gt; &gt; DocBook: TDG) and Leonard Muellner put together...
&gt; &gt; &gt;
&gt; &gt; &gt; DocBook V3.1 Quick Reference
&gt; &gt; &gt; <A HREF="http://www.nwalsh.com/docbook/defguide/qr/quickref.htm">http://www.nwalsh.com/docbook/defguide/qr/quickref.htm</A>
&gt; &gt; &gt;
&gt; &gt; &gt; lists &lt;tag&gt; and &lt;brief description&gt; only; but quite handy for
&gt; &gt; &gt; quick look-ups.
&gt; &gt;
&gt; &gt; I have the feeling this is DocBook DTD as opposed to the
&gt; &gt; LinuxDoc DTD, am I right? If so I'd like a similar reference
&gt; &gt; guide for the LinuxDoc DTD. Last night I took a long hard look
&gt; &gt; in the docs for SGMLTools and did not find what I needed there.
&gt;
&gt; Yep, that's DocBook. I think that the only such reference for the
&gt; LinuxDocDTD is the DTD itself. If you're using an RPM based
&gt; distribution, then 'rpm -ql sgmltools' will give you a listing
&gt; where you can probably find the DTD itself.
Mark covers some of this in the HOWTO-HOWTO : &quot;Getting Started with
LinuxDoc&quot;, but it's not exactly what you are looking for.
We could/should put something like this together and put it in
the HOWTO-HOWTO...quick ref tag guide for LinuxDoc and DocBook.
&gt; &gt; Finally there is no &lt;manpage&gt; like tag in the mapping nor in the
&gt; &gt; above mentioned references. A HOWTO reference tag would also be
&gt; &gt; nice.
&gt;
&gt; I think &lt;refentry&gt; is the DocBook tag, but I'm not 100% sure on that;
&gt; I'm fairly confident that LinuxDoc doesn't have anything useful for
&gt; man pages.
Correct on both accounts.
&gt; As for the HOWTO reference tag, what do you mean? Godoy and I have
&gt; talked about getting a special document type for the LDP called
&gt; HOWTO, but I'm not sure if he made any progress on that. I'm not
&gt; sure if you're looking for something different in it's markup
&gt; capabilities, or just in name.
&gt;
&gt; Greg
NO! I'm strongly opposed to extending the vanilla DocBook DTD!!
Please let's stick to the standard. &lt;article&gt; should work just fine
for any and all HOWTOs; if not, then go with &lt;book&gt; as your
top-level container element. DocBook is such a rich, full-featured
DTD, I can't really see us needing anything beyond what it already
offers (at this point anyway).
Certainly extend the DSSSL stylesheets, if so desired, to give a
&quot;LDP-look&quot; to the derived HTML/print outputs -- but for processing
purposes, document exchange, author convenience, and many other
reasons -- let's stick with the stock DocBook DTD.
r,
--
Greg Ferguson - s/w engr / mtlhd | gferg@sgi.com
SGI Tech Pubs - <A HREF="http://techpubs.sgi.com">http://techpubs.sgi.com</A> |
Linux Doc Project - <A HREF="http://www.linuxdoc.org">http://www.linuxdoc.org</A> |
--
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of &quot;unsubscribe&quot;. 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 &lt;GLeblanc@cu-portland.edu&gt;</li></ul></li>
</ul></li></ul>
<!--X-References-End-->
<!--X-BotPNI-->
<ul>
<li>Prev by Date:
<strong><a href="msg02259.html">Re: If SGML is so great...</a></strong>
</li>
<li>Next by Date:
<strong><a href="msg02261.html">Re: if SGML is so great...</a></strong>
</li>
<li>Previous by thread:
<strong><a href="msg02258.html">RE: if SGML is so great...</a></strong>
</li>
<li>Next by thread:
<strong><a href="msg02261.html">Re: if SGML is so great...</a></strong>
</li>
<li>Index(es):
<ul>
<li><a href="maillist.html#02260"><strong>Date</strong></a></li>
<li><a href="threads.html#02260"><strong>Thread</strong></a></li>
</ul>
</li>
</ul>
<!--X-BotPNI-End-->
<!--X-User-Footer-->
<!--X-User-Footer-End-->
</body>
</html>