157 lines
5.6 KiB
HTML
157 lines
5.6 KiB
HTML
<!-- MHonArc v2.5.0b2 -->
|
|
<!--X-Subject: Building TOCs - can this be in the LDP-Authors-Guide ? -->
|
|
<!--X-From-R13: xrivaNabegunagf.yht.bet.hx (Yriva Fnlybe) -->
|
|
<!--X-Date: Wed, 12 Jul 2000 07:19:32 -0400 (EDT) -->
|
|
<!--X-Message-Id: 200007121203.MAA17052@sweeper.cegelecproj.co.uk -->
|
|
<!--X-Content-Type: text/plain -->
|
|
<!--X-Head-End-->
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
|
|
<html>
|
|
<head>
|
|
<title>Building TOCs - can this be in the LDP-Authors-Guide ?</title>
|
|
<link rev="made" href="mailto:kevin@northants.lug.org.uk">
|
|
</head>
|
|
<body>
|
|
<!--X-Body-Begin-->
|
|
<!--X-User-Header-->
|
|
<!--X-User-Header-End-->
|
|
<!--X-TopPNI-->
|
|
<hr>
|
|
[<a href="msg03221.html">Date Prev</a>][<a href="msg03223.html">Date Next</a>][<a href="msg03245.html">Thread Prev</a>][<a href="msg03223.html">Thread Next</a>][<a href="maillist.html#03222">Date Index</a>][<a href="threads.html#03222">Thread Index</a>]
|
|
<!--X-TopPNI-End-->
|
|
<!--X-MsgBody-->
|
|
<!--X-Subject-Header-Begin-->
|
|
<h1>Building TOCs - can this be in the LDP-Authors-Guide ?</h1>
|
|
<hr>
|
|
<!--X-Subject-Header-End-->
|
|
<!--X-Head-of-Message-->
|
|
<ul>
|
|
<li><em>To</em>: <A HREF="mailto:ldp-discuss@lists.debian.org">ldp-discuss@lists.debian.org</A></li>
|
|
<li><em>Subject</em>: Building TOCs - can this be in the LDP-Authors-Guide ?</li>
|
|
<li><em>From</em>: <A HREF="mailto:kevin@northants.lug.org.uk">kevin@northants.lug.org.uk</A> (Kevin Taylor)</li>
|
|
<li><em>Date</em>: Wed, 12 Jul 2000 12:03:39 GMT</li>
|
|
<li><em>Resent-date</em>: Wed, 12 Jul 2000 07:19:32 -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>: <I7MxfD.A.sKC.nRFb5@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>
|
|
Hi,
|
|
|
|
I have recently posted a comment that I will be
|
|
writing a new mini howto (xdm/xterminals) - I
|
|
know that I could submit it in HTML, but I also
|
|
know how much time volunteers really have (I run
|
|
a LUG) - so I have tried to get a SGML version
|
|
done myself.
|
|
|
|
This is fine, and I now have some SGML sources
|
|
that produce HTML ok.
|
|
|
|
As a new user of DocBook, etc I have the
|
|
following comments on the LDP-Author-Guide, and
|
|
the facilities in general :
|
|
|
|
1. I am very confused about the relationships
|
|
between the different tools. I use sgmltools
|
|
(debian) which is fine, but your examples in the
|
|
LDP-Authors-Guide use jade. Perhaps a quick
|
|
summary of what are the 'backend/real work' tools
|
|
(jade, latex, etc) and what are the front end
|
|
tools (the sgmltools scripts - I assume)
|
|
and how they relate to each other may be
|
|
appropriate in your tools section.
|
|
2. I would recommend a sort of 'flow-chart' like
|
|
diagram illustrating the workflow - ie Front-end
|
|
Lyx/Emacs/vi whatever -> ASCII based SGML source
|
|
-> sgmltools -> backends -> outputs, etc, perhaps
|
|
then with each portion referencing the section in
|
|
the document that talks about that particular bit.
|
|
|
|
3. I echo the comments about a template - I found
|
|
the big-howto-template very useful in general,
|
|
but some of the tags were a little cryptic (but
|
|
that could have just been me :-)
|
|
4. The biggest 'hole' in the documentation, as
|
|
far as I am concerned, is how you actually end up
|
|
with the well-known format of the HMTL howtos
|
|
- ie the fred-howto.html, fred-howto1.html, file
|
|
structure and the table of contents. I have seen
|
|
lots of references to building indeces, but
|
|
cannot find out what I actually need to put in my
|
|
SGML source in order to produce the table of
|
|
contents.
|
|
I think that you use collateindex.pl but I don't
|
|
know what this actually does. A template howto
|
|
that includes a TOC is very important in my
|
|
opinion. It may well be worth actually providing
|
|
a recipe for 'building' the same template howto
|
|
into a HTML source - ie something that a brand
|
|
new user (like me) can blindly follow initially,
|
|
and then start to work out what the stages
|
|
mean later on.
|
|
|
|
Many thanks for this document - I got me writing
|
|
SGML very quickly. I just need a bit of help
|
|
with the TOC and I am there !
|
|
|
|
|
|
Thanks,
|
|
Kevin Taylor,
|
|
Northants LUG.
|
|
|
|
|
|
|
|
--
|
|
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="03223" href="msg03223.html">Re: Building TOCs - can this be in the LDP-Authors-Guide ?</a></strong>
|
|
<ul><li><em>From:</em> Stein Gjoen <sgjoen@mail.nyx.net></li></ul></li>
|
|
<li><strong><a name="03234" href="msg03234.html">Re: Building TOCs - can this be in the LDP-Authors-Guide ?</a></strong>
|
|
<ul><li><em>From:</em> Hal Burgiss <hburgiss@bellsouth.net></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="msg03221.html">Re: COMDEX Toronto</a></strong>
|
|
</li>
|
|
<li>Next by Date:
|
|
<strong><a href="msg03223.html">Re: Building TOCs - can this be in the LDP-Authors-Guide ?</a></strong>
|
|
</li>
|
|
<li>Previous by thread:
|
|
<strong><a href="msg03245.html">Re: Commercial Environment Linux Howto</a></strong>
|
|
</li>
|
|
<li>Next by thread:
|
|
<strong><a href="msg03223.html">Re: Building TOCs - can this be in the LDP-Authors-Guide ?</a></strong>
|
|
</li>
|
|
<li>Index(es):
|
|
<ul>
|
|
<li><a href="maillist.html#03222"><strong>Date</strong></a></li>
|
|
<li><a href="threads.html#03222"><strong>Thread</strong></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<!--X-BotPNI-End-->
|
|
<!--X-User-Footer-->
|
|
<!--X-User-Footer-End-->
|
|
</body>
|
|
</html>
|