148 lines
5.9 KiB
HTML
148 lines
5.9 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
||
<!--X-Subject: Re: DocBook Assistance -->
|
||
<!--X-From-R13: Oaql Aenz <naqlbNbervyyl.pbz> -->
|
||
<!--X-Date: Fri, 17 Dec 1999 15:49:19 -0500 (EST) -->
|
||
<!--X-Message-Id: 199912172047.PAA12931@ruby.ora.com -->
|
||
<!--X-Content-Type: text/plain -->
|
||
<!--X-Reference: Pine.LNX.4.10.9911302134060.10970-100000@wallybox.cei.net -->
|
||
<!--X-Head-End-->
|
||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
||
<html>
|
||
<head>
|
||
<title>Re: DocBook Assistance</title>
|
||
<link rev="made" href="mailto:andyo@oreilly.com">
|
||
</head>
|
||
<body>
|
||
<!--X-Body-Begin-->
|
||
<!--X-User-Header-->
|
||
<!--X-User-Header-End-->
|
||
<!--X-TopPNI-->
|
||
<hr>
|
||
[<a href="msg00912.html">Date Prev</a>][<a href="msg00914.html">Date Next</a>][<a href="msg00817.html">Thread Prev</a>][<a href="msg00914.html">Thread Next</a>][<a href="maillist.html#00913">Date Index</a>][<a href="threads.html#00913">Thread Index</a>]
|
||
<!--X-TopPNI-End-->
|
||
<!--X-MsgBody-->
|
||
<!--X-Subject-Header-Begin-->
|
||
<h1>Re: DocBook Assistance</h1>
|
||
<hr>
|
||
<!--X-Subject-Header-End-->
|
||
<!--X-Head-of-Message-->
|
||
<ul>
|
||
<li><em>To</em>: ldp-discuss <<A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A>></li>
|
||
<li><em>Subject</em>: Re: DocBook Assistance</li>
|
||
<li><em>From</em>: Andy Oram <<A HREF="mailto:andyo@oreilly.com">andyo@oreilly.com</A>></li>
|
||
<li><em>Date</em>: Fri, 17 Dec 1999 15:50:40 -0500</li>
|
||
<li><em>In-reply-to</em>: <<a href="msg00803.html">Pine.LNX.4.10.9911302134060.10970-100000@wallybox.cei.net</a>></li>
|
||
<li><em>Resent-cc</em>: recipient list not shown: ;</li>
|
||
<li><em>Resent-date</em>: 17 Dec 1999 20:48:19 -0000</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>: <LdMtWD.A.e-B.SGqW4@murphy></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>
|
||
Excusez-moi, il faut retourner <20> Anglais pour un moment...
|
||
|
||
I've worked with DocBook for a few years at O'Reilly and would like people
|
||
struggling with it to know that we're willing to help here. Like all the rest
|
||
of you, we're strapped for time, but we also want to see DocBook accepted, so
|
||
there's an incentive to act as consultants. I've suffered enough with DocBook
|
||
that it would give my life some meaning to spare others that same suffering.
|
||
|
||
(On a more positive note, DocBook becomes natural and easy to use after you
|
||
learn the dozen or so tags you really need.)
|
||
|
||
Lenny, in particular, told me he would put in some time for you; you can
|
||
let me
|
||
know where he might be helpful.
|
||
|
||
Personally, I don't have the stamina to help with a guide, but I give moral
|
||
support to anybody who does. If I wanted to help in that area, I should have
|
||
been a reviewer of Norm and Lenny's book. But I had no time to get involved in
|
||
that effort (in fact, I haven't read very much of the book). If some people on
|
||
this list find it lacking, go ahead and give the subject another try.
|
||
|
||
Here's what I can do personally: I've told Tim that I could contribute tips to
|
||
a FAQ based on errors I've seen in my authors' formatting. Sample tips
|
||
(shortened a bit) would be "Always use <para> tags inside <entry> and
|
||
<listitem> tags" and "Don't bother to use a string like Chapter or Section
|
||
when
|
||
you specify an <xref> tag."
|
||
|
||
Also, anyone who wants a model can look at the SGML version (the basis for our
|
||
published version) of the NAG. That book is being updated as I write. There
|
||
are
|
||
some oddities left over from the first edition that are not part of standard
|
||
DocBook, but the author will strip them out.
|
||
|
||
We are also in the process here of producing a DocBook version of Using Samba,
|
||
which I hope will be ready for public eyes next week.
|
||
|
||
I joined this list a couple weeks ago, got overwhelmed for a while with the
|
||
volume of mail, and just have a moment to post now.
|
||
|
||
----------------------------------------------------------------------
|
||
Andy Oram O'Reilly & Associates, Inc. email: andyo@oreilly.com
|
||
Editor 90 Sherman Street phone: (617) 499-7479
|
||
Cambridge, MA 02140-3233 fax: (617) 661-1116
|
||
USA
|
||
<<A HREF="http://www.oreilly.com/~andyo">http://www.oreilly.com/~andyo</A>><A HREF="http://www.oreilly.com/~andyo/">http://www.oreilly.com/~andyo/</A>
|
||
Stories at Web site: The Bug in the Seven Modules, Code the Obscure
|
||
----------------------------------------------------------------------
|
||
|
||
|
||
|
||
--
|
||
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>
|
||
<ul><li><strong>Follow-Ups</strong>:
|
||
<ul>
|
||
<li><strong><a name="00914" href="msg00914.html">Re: DocBook Assistance</a></strong>
|
||
<ul><li><em>From:</em> Guylhem Aznar <guylhem@oeil.qc.ca></li></ul></li>
|
||
</ul></li></ul>
|
||
<!--X-Follow-Ups-End-->
|
||
<!--X-References-->
|
||
<ul><li><strong>References</strong>:
|
||
<ul>
|
||
<li><strong><a name="00803" href="msg00803.html">DocBook Assistance</a></strong>
|
||
<ul><li><em>From:</em> Tim <tjbynum@wallybox.cei.net></li></ul></li>
|
||
</ul></li></ul>
|
||
<!--X-References-End-->
|
||
<!--X-BotPNI-->
|
||
<ul>
|
||
<li>Prev by Date:
|
||
<strong><a href="msg00912.html">Re: [conseil] DGPL [rms@gnu.org: Doc license]</a></strong>
|
||
</li>
|
||
<li>Next by Date:
|
||
<strong><a href="msg00914.html">Re: DocBook Assistance</a></strong>
|
||
</li>
|
||
<li>Previous by thread:
|
||
<strong><a href="msg00817.html">Re: DocBook Assistance</a></strong>
|
||
</li>
|
||
<li>Next by thread:
|
||
<strong><a href="msg00914.html">Re: DocBook Assistance</a></strong>
|
||
</li>
|
||
<li>Index(es):
|
||
<ul>
|
||
<li><a href="maillist.html#00913"><strong>Date</strong></a></li>
|
||
<li><a href="threads.html#00913"><strong>Thread</strong></a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
|
||
<!--X-BotPNI-End-->
|
||
<!--X-User-Footer-->
|
||
<!--X-User-Footer-End-->
|
||
</body>
|
||
</html>
|