131 lines
4.6 KiB
HTML
131 lines
4.6 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: docbook for LDP -->
|
|
<!--X-From-R13: Yraqnyy Qynex <xpynexNagyht.bet> -->
|
|
<!--X-Date: Thu, 2 Dec 1999 02:07:18 -0500 (EST) -->
|
|
<!--X-Message-Id: 14406.6809.794267.477993@cmpu.net -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>docbook for LDP</title>
|
|
<link rev="made" href="mailto:kclark@ntlug.org">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[Date Prev][<a href="msg00001.html">Date Next</a>][Thread Prev][<a href="msg00001.html">Thread Next</a>][<a href="maillist.html#00000">Date Index</a>][<a href="threads.html#00000">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>docbook for LDP</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: <A HREF="mailto:ldp-docbook@lists.debian.org">ldp-docbook@lists.debian.org</A></li>
|
|
<li><em>Subject</em>: docbook for LDP</li>
|
|
<li><em>From</em>: Kendall Clark <<A HREF="mailto:kclark@ntlug.org">kclark@ntlug.org</A>></li>
|
|
<li><em>Date</em>: Thu, 2 Dec 1999 01:07:05 -0600 (CST)</li>
|
|
<li><em>Reply-to</em>: <A HREF="mailto:kclark@ntlug.org">kclark@ntlug.org</A></li>
|
|
<li><em>Resent-cc</em>: recipient list not shown: ;</li>
|
|
<li><em>Resent-date</em>: 2 Dec 1999 07:07:16 -0000</li>
|
|
<li><em>Resent-from</em>: <A HREF="mailto:ldp-docbook@lists.debian.org">ldp-docbook@lists.debian.org</A></li>
|
|
<li><em>Resent-message-id</em>: <1e6vOB.A.7aF.jqhR4@murphy></li>
|
|
<li><em>Resent-sender</em>: <A HREF="mailto:ldp-docbook-request@lists.debian.org">ldp-docbook-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>
|
|
Hi all,
|
|
|
|
I tried to start an LDP DocBook Working Group earlier this year, when
|
|
Lars was first taking over LDP leadership, but at about the same time
|
|
I heard threatening noises from my dissertation adviser, so I had to
|
|
drop everything else and produce something for him to look at... Ok,
|
|
about 37,000 words later, I have *some* time to contribute to this
|
|
effort.
|
|
|
|
I've been using DocBook for about 3.5 years, and I spent most of 1998
|
|
leading a large DocBook project for a Fortune 500 client---using all
|
|
free software on Linux. That was fun.
|
|
|
|
What I'd like to see this group produce is a comprehensive[1] LDP
|
|
Author's Guide to DocBook. I'm willing to serve as the editor for this
|
|
document, as well as to author some of it. But if it's going to get
|
|
done expeditiously, it needs to be a group effort.
|
|
|
|
As you all know if you've done much DocBook, it's a complex beast, and
|
|
we need to produce a document that LDP authors can use as the
|
|
definitive reference to using DocBook for authoring LDP material.
|
|
|
|
I think the first thing we should do is come up with a working outline
|
|
for the Author's Guide. I have some ideas about that, but I don't want
|
|
to monopolize the discussion, so I'll let others go first. But,
|
|
ideally, after we've put the issues that need to be addresses into a
|
|
coherent and helpful outline, it's just a matter of filling the sucker
|
|
in. Some of the technical decisions will need to be discussed, perhaps
|
|
at some length; lots of the other decisions are almost strictly
|
|
conventional and just need to reflect the rough consensus of the
|
|
group.
|
|
|
|
As for production, colophon things, the Author's Guide should
|
|
obviously be produced in DocBook for several reasons, not the least of
|
|
which is that it should itself serve as an exemplar of how the LDP is
|
|
going to use DocBook.
|
|
|
|
Anyway, that's my 2 cents.
|
|
|
|
Best,
|
|
|
|
Kendall Clark
|
|
|
|
Footnotes:
|
|
[1] I don't mean "comprehensive" like Norm Walsh's book; i.e., we
|
|
don't need to give full detail for *every* DocBook element, content
|
|
model, entity set, etc. What we do need, however, is a document that
|
|
offers comprehensive coverage on all the issues surrounding the LDP's
|
|
use of DocBook.
|
|
|
|
|
|
--
|
|
To UNSUBSCRIBE, email to ldp-docbook-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-->
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Next by Date:
|
|
<strong><a href="msg00001.html">intro</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg00001.html">intro</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#00000"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#00000"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|