166 lines
6.6 KiB
HTML
166 lines
6.6 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: RE: Yet another question -->
|
|
<!--X-From-R13: Uertbel Zroynap <UZroynapNph-cbegynaq.rqh> -->
|
|
<!--X-Date: Tue, 25 Jul 2000 00:14:33 -0400 (EDT) -->
|
|
<!--X-Message-Id: 025836EFF856D411A6660090272811E61D0501@EMAIL -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>RE: Yet another question</title>
|
|
<link rev="made" href="mailto:GLeblanc@cu-portland.edu">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg00167.html">Date Prev</a>][<a href="msg00169.html">Date Next</a>][<a href="msg00171.html">Thread Prev</a>][<a href="msg00170.html">Thread Next</a>][<a href="maillist.html#00168">Date Index</a>][<a href="threads.html#00168">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>RE: Yet another question</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: "'Luis Villa'" <<A HREF="mailto:liv@duke.edu">liv@duke.edu</A>>, <A HREF="mailto:ldp-docbook@lists.debian.org">ldp-docbook@lists.debian.org</A></li>
|
|
<li><em>Subject</em>: RE: Yet another question</li>
|
|
<li><em>From</em>: Gregory Leblanc <<A HREF="mailto:GLeblanc@cu-portland.edu">GLeblanc@cu-portland.edu</A>></li>
|
|
<li><em>Date</em>: Mon, 24 Jul 2000 21:15:15 -0700</li>
|
|
<li><em>Cc</em>: <A HREF="mailto:ldp-docbook@lists.linuxdoc.org">ldp-docbook@lists.linuxdoc.org</A>, "Paul Jones (E-mail)" <<A HREF="mailto:pjones@metalab.unc.edu">pjones@metalab.unc.edu</A>></li>
|
|
<li><em>Resent-date</em>: Tue, 25 Jul 2000 00:14:33 -0400 (EDT)</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>: <MTPEq.A.0gH.YRRf5@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>
|
|
> -----Original Message-----
|
|
> From: Luis Villa [<A HREF="mailto:liv@duke.edu">mailto:liv@duke.edu</A>]
|
|
> Sent: Monday, July 24, 2000 8:51 PM
|
|
> To: ldp-docbook@lists.debian.org
|
|
> Cc: ldp-docbook@lists.linuxdoc.org
|
|
> Subject: Yet another question
|
|
>
|
|
> So, I found the section on ldp.dsl in the HOWTO. This isn't
|
|
> the format I'm
|
|
> used to (or prefer) but it is getting closer. I have a couple
|
|
> of questions
|
|
> about it:
|
|
>
|
|
> 1) Is there any way to force section 1 to be on a separate
|
|
> page from the
|
|
> table of contents? That combination makes the first page huge for me.
|
|
|
|
Yes, there is. Unfortunately, I don't know what it is, and I hate the look
|
|
of DSSSL so I haven't dug into it very much. Perhaps Jorge Godoy or Greg
|
|
Ferguson can tell you how to do that. I'd prefer it to be that way as well
|
|
as it makes for a nicer document.
|
|
|
|
> 2) What is the canonical way to include your email in the
|
|
> information at
|
|
> the top of the index page? I've tried a few variations on
|
|
> <AuthorBlurb>
|
|
> and <Affiliation> with no success. Since that is what several
|
|
> LDP authors
|
|
> use (at least in the versions available on the web site), it
|
|
> looks like
|
|
> the LDP does not yet use DocBook to actually generate their
|
|
> documents (at
|
|
> least, they don't use DocBook in any way that I've made sense
|
|
> of.) So- any
|
|
> better suggestions?
|
|
|
|
The easiest way is to snag it from a well written SGML document, the
|
|
HOWTO-HOWTO would be a good once, since Mark looks to be really getting
|
|
pretty good with DocBook. Getting the DocBook source will let you look at
|
|
some of the other nice markup that DocBook provides that LinuxDoc does not.
|
|
|
|
|
|
> 3) Why is <Rant> not a DocBook tag? Seriously... I had always assumed
|
|
> (when I heard that the LDP was switching from LinuxDoc to
|
|
> DocBook) that
|
|
> that went that DocBook had a well developed set of tools to work with,
|
|
> just like LinuxDoc. These kinds of tools are what give CLIs a
|
|
> bad name- I
|
|
> don't see the advantage to switching to them if no one can
|
|
> get anything
|
|
> done with them. Of all things, writing docs should be
|
|
> straightforward and
|
|
> not require technical wizardry. Jeez. </Rant>
|
|
|
|
Well, the tools are progressing a lot, they're actually hundreds of times
|
|
better than when I started into this (isn't that comforting?) and I expect
|
|
them to be almost good by the time that September rolls around. I don't
|
|
have the processing tools installed at all on the machines where I write
|
|
documentation, I just write them, and email it off to the publishers. If
|
|
they don't like how it looks, that's their problem, not mine.
|
|
|
|
> Anyway, thanks again for your time- please cc: me to answers. I looked
|
|
> into signing up, but the idea of getting 4 cron job messages
|
|
> every hour is
|
|
> unappealing.
|
|
|
|
Paul! It's broke again. :-( Those CRON messages only show up in the
|
|
archiver, and it's because something is wrong with MhonArc on Metalab. Or
|
|
at least I assume that's it, since almost everybody on the Mailman list
|
|
swears by it as an archiver. Anyway, sign up for the list, these are the
|
|
kinds of messages we get, and it's pretty low traffic.
|
|
Grego
|
|
|
|
|
|
--
|
|
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>
|
|
<ul><li><strong>Follow-Ups</strong>:
|
|
<ul>
|
|
<li><strong><a name="00170" href="msg00170.html">RE: Yet another question</a></strong>
|
|
<ul><li><em>From:</em> Luis Villa <liv@duke.edu></li></ul></li>
|
|
<li><strong><a name="00183" href="msg00183.html">Re: Yet another question</a></strong>
|
|
<ul><li><em>From:</em> Jorge Godoy <godoy@conectiva.com></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-Follow-Ups-End-->
|
|
<!--X-References-->
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg00167.html">RE: Hi! (And some questions, of course)</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg00169.html">RE: thanks, and another couple of questions :)</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg00171.html">RE: thanks, and another couple of questions :)</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg00170.html">RE: Yet another question</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#00168"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#00168"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|