Date: Thu, 15 Jun 2000 10:00:44 +0000 From: Nik Clayton <nik@freebsd.org> To: papowell@astart.com Cc: freebsd-doc@freebsd.org Subject: Re: Can a DocBook Wizard Spare A Few Minutes? Message-ID: <20000615100044.A11865@kilt.nothing-going-on.org> In-Reply-To: <200006132056.NAA03484@h4.private>; from papowell@astart.com on Tue, Jun 13, 2000 at 01:56:48PM -0700 References: <200006132056.NAA03484@h4.private>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, Jun 13, 2000 at 01:56:48PM -0700, papowell@astart.com wrote:
> 1. Deeper TOC Listings for HTML Output
>
> Right now the TOC only does two levels of listing. I would
> like to increase the depth. How do I do this?
> NOW WANT
>
> main main
> main.1 main.1
> main.1.1 main.1.1
> main.1.1.1 main.1.1.1
> main.1.1.2 main.1.1.2
> main.2 main.2
> main.2.1 main.2.1
>
> ...
Dunno yet. . .
% cd /usr/local/share/sgml/docbook/dsssl/modular/html
% grep toc * | more
Looks like dbautoc.dsl defines it. Looking in there. . .
;; Returns the depth of auto TOC that should be made at the nd-level
(define (toc-depth nd)
(if (string=? (gi nd) (normalize "book"))
3
1))
Hmm. Looks like instead of just defining a number, there's a function
that returns a variable depth, depending on whether this is a book or
not.
I suppose if you wanted everything to have a TOC depth of 4 you could
just do:
(define (toc-depth nd)
4)
in your .dsl file, otherwise you can be more creative as necessary.
> 2. How Do I Produce an Index? I would like to do this
> for both HTML and PS output, but I would be happy
> with just PS output.
> a) the markup notation in the body
> b) the jade + tex + tools to use
See $PREFIX/share/sgml/docbook/dsssl/modular/doc/indexing.html (where
$PREFIX is normally /usr/local, but might be different if you've configured
things differently.
Actually, take a look at index.html in the same directory, and read through
what's there, as it'll probably help.
> 3. How Do I Produce an Glossary? I would like to do this
> for both HTML and PS output, but I would be happy
> with just PS output.
> a) the markup notation in the body
> b) the jade + tex + tools to use
Isn't this covered in DocBook: The Definitive Guide? It's in the online
version (see http://www.docbook.org/) in Section II: Reference (see the
Glossary, FirstTerm, and GlossTerm element descriptions, and examples).
> 4. The current tex output numbers pages, but does not do it
> correctly.
> Now Should Be
> Title Page (Correct - no number)
> Dedication 2 i
> Preface... 3-... ii-...
>
> Part1 n 1
>
> I KNOW just KNOW that there is a way to do this, and I am going to
> probably hit myself with a dope slap when somebody tells me.
Pass. I think it's supposed to do this. Asking on the DocBook-Apps mailing
list is probably best.
> 5. I have tried to put images into the HTML and TeX / PS format.
> Other people have done it.
> a) What is the magic markup I need
> b) How do I convince the tex stuff to FIND the file containing the
> graphic? I keep thinking that I did this a LOooonnng time ago,
> with a graphic tool, but this was using latex and some macros,
> and it is long gone from my memory and archives.
Go to the web archives of the -doc list, and search for a message from
me with the subject
Including images in the documentation
for how to do this.
N
--
Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95.
Telephone line, $24.95 a month. Software, free. USENET transmission,
hundreds if not thousands of dollars. Thinking before posting, priceless.
Somethings in life you can't buy. For everything else, there's MasterCard.
-- Graham Reed, in the Scary Devil Monastery
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000615100044.A11865>