190 lines
7.9 KiB
HTML
190 lines
7.9 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: RE: Yet another question -->
|
|
<!--X-From-R13: Zhvf Hvyyn <yviNqhxr.rqh> -->
|
|
<!--X-Date: Tue, 25 Jul 2000 00:33:21 -0400 (EDT) -->
|
|
<!--X-Message-Id: Pine.GSO.4.10.10007250025220.8143-100000@teer13.acpub.duke.edu -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Reference: 025836EFF856D411A6660090272811E61D0501@EMAIL -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>RE: Yet another question</title>
|
|
<link rev="made" href="mailto:liv@duke.edu">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg00169.html">Date Prev</a>][<a href="msg00171.html">Date Next</a>][<a href="msg00168.html">Thread Prev</a>][<a href="msg00175.html">Thread Next</a>][<a href="maillist.html#00170">Date Index</a>][<a href="threads.html#00170">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>: Gregory Leblanc <<A HREF="mailto:GLeblanc@cu-portland.edu">GLeblanc@cu-portland.edu</A>></li>
|
|
<li><em>Subject</em>: RE: Yet another question</li>
|
|
<li><em>From</em>: Luis Villa <<A HREF="mailto:liv@duke.edu">liv@duke.edu</A>></li>
|
|
<li><em>Date</em>: Tue, 25 Jul 2000 00:30:18 -0400 (EDT)</li>
|
|
<li><em>Cc</em>: <A HREF="mailto:ldp-docbook@lists.debian.org">ldp-docbook@lists.debian.org</A>, <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>In-reply-to</em>: <<a href="msg00168.html">025836EFF856D411A6660090272811E61D0501@EMAIL</a>></li>
|
|
<li><em>Resent-date</em>: Tue, 25 Jul 2000 00:33:21 -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>: <i9J5kD.A.PRB.BjRf5@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>
|
|
On Mon, 24 Jul 2000, Gregory Leblanc wrote:
|
|
> > -----Original Message-----
|
|
> > 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.
|
|
|
|
Jorge? Greg? :) I can't promise anything other than massive thanks, but
|
|
that should count for something :)
|
|
|
|
> > 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.
|
|
|
|
I had looked at a couple others, but didn't have the sense to realize that
|
|
(of course) the HOWTO-HOWTO would probably be the best written of the
|
|
bunch. That said, while it does have some cool tags (I understand how the
|
|
revision history works now, I think) it still doesn't display the email up
|
|
top like I'd like to have (and like has always been LDP practice.) Anyone?
|
|
|
|
> > 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.
|
|
|
|
After I wrote that rant, I read even further back in the list archives. I
|
|
hadn't realized it was quite so new. Still... very frustrating.
|
|
|
|
> 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.
|
|
|
|
Heh. I wish :) I've only written one book, but the editor is a Mac guy, so
|
|
you know what that meant for formatting... that's right, Word. Ugh.
|
|
|
|
> > 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.
|
|
|
|
Oh, OK. That's cool. <insert snide Duke joke about UNC people here>
|
|
|
|
Thanks so much for all the help, everyone...
|
|
Luis
|
|
|
|
-----------------------------------------------------------------------
|
|
|
|
"Summertime... and the living is easy...
|
|
fish are jumping and the cotton is high...
|
|
So hush, little baby, baby don't you cry."
|
|
-Ella
|
|
|
|
-----------------------------------------------------------------------
|
|
|
|
|
|
--
|
|
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-->
|
|
<ul><li><strong>References</strong>:
|
|
<ul>
|
|
<li><strong><a name="00168" href="msg00168.html">RE: Yet another question</a></strong>
|
|
<ul><li><em>From:</em> Gregory Leblanc <GLeblanc@cu-portland.edu></li></ul></li>
|
|
</ul></li></ul>
|
|
<!--X-References-End-->
|
|
<!--X-BotPNI-->
|
|
<ul>
|
|
<li>Prev by Date:
|
|
<strong><a href="msg00169.html">RE: thanks, and another couple of questions :)</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg00171.html">RE: thanks, and another couple of questions :)</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg00168.html">RE: Yet another question</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg00175.html">Re: Yet another question</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#00170"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#00170"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|