discuss: Contents Question (HTML output)


Previous by date: 13 Jan 2001 14:31:48 -0000 (Fwd) Including the LDP in electronic format on a book companion CD-ROM, Greg Ferguson
Next by date: 13 Jan 2001 14:31:48 -0000 Game-Server-HOWTO, Anders J-U
Previous in thread: 13 Jan 2001 14:31:48 -0000 Re: Contents Question (HTML output), Dan York
Next in thread:

Subject: Re: Contents Question (HTML output)
From: Taketoshi Sano ####@####.####
Date: 13 Jan 2001 14:31:48 -0000
Message-Id: <y5ad7dsz5p2.fsf@kgh12351.nifty.ne.jp>

Hi.

  on Thu, 11 Jan 2001 15:10:48 -0600,
 "Ryan Gallagher" ####@####.#### wrote:

> 1. Introduction
> 	1.1 Copyright
> 	1.2 Feedback
> 	1.3 New versions of this Document
> 2. Setting up WWW client software (Antiquated)
> 	2.1 Overview
> 3. Lynx
> 	3.1 Where to get

If you use linuxdoc-tools version 0.6.0 or later, then
you can use option "-T" (or --toc) for html backend.
Just try to use  "linuxdoc -B html -T 2 <some-linuxdoc-sgml-source>"

Option "-T 0" produces no TOC, "-T 1" single level TOC, 
and "-T 2" makes 2 level TOC.  Although I have hope to get
more multi-level TOC, it doesn't come to real yet. So max is 2.

BTW, you can get single html output with 2 level TOC using
 "linuxdoc -B html -s 0 -T 2 <some-linuxdoc-sgml-source>"
 (so sgml21html is not necessary now).

Version 0.9.0 or later has updated manual page about linuxdoc command
and these options are explained at html backend section.

> Also... within documents it links chapters names back to the toc.
> 
> 1. (Introduction) --> href'ed back to main documents toc entry for 1.

Option "-T 2" enables this.

> -=-=-=-=-=-=
> 
> Separate Question:
> 
> Has anyone done any altering of the Linuxdoc DTD or process for their own
> purposes to produce cleaner "more valid" HTML?  Stuff like not closing <p>
> tags (and excessive unneeded <p> tags) can cause problems for my use of the
> documents post conversion.  Any pointers?

Check $LibDir/dist/linuxdoc-tools/html/mapping file. This is a kind of
"stylesheet" for linuxdoc-tools (as same as its mother, sgml-tools v1).

Hmm, It does not define the closing p element tag (</p>), as there:

<p>                     "<P>"
</p>                    ""                      +

maybe change this into

<p>                     "<P>"
</p>                    "</P>"                      +

would work.

Regards.
-- 
  Taketoshi Sano: ####@####.####

Previous by date: 13 Jan 2001 14:31:48 -0000 (Fwd) Including the LDP in electronic format on a book companion CD-ROM, Greg Ferguson
Next by date: 13 Jan 2001 14:31:48 -0000 Game-Server-HOWTO, Anders J-U
Previous in thread: 13 Jan 2001 14:31:48 -0000 Re: Contents Question (HTML output), Dan York
Next in thread:


  ©The Linux Documentation Project, 2014. Listserver maintained by dr Serge Victor on ibiblio.org servers. See current spam statz.