docbook: Making pretty .html filenames (was: How to create a HOWTO on Red Hat Linux 9?)
Subject:
Re: Making pretty .html filenames (was: How to create a HOWTO
on Red Hat Linux 9?)
From:
"Rodolfo J. Paiz" ####@####.####
Date:
21 Oct 2003 13:28:49 -0000
Message-Id: <6.0.0.22.0.20031021071753.02501dc0@mail.simpaticus.com>
At 02:12 10/21/2003, Tabatha Marshall wrote:
>I can suggest very simple method for correcting the obscure html
>filenames created when you convert your doc.
>
>For each chapter and section, add an id. Syntax:
><chapter id="intro">
> <sect1 id="aboutauthor">
>
>...and so forth. When you process to html, the filenames will be
>intro.html, aboutauthor.html, etc.
Unfortunately this is not happening. Since I started from Stein Gjoen's
(sp?) template, all my sections do have ID's associated with them: "intro"
and "summary" are the first two. I was able to partially fix this with some
advice by Martin A. Brown, who told me to include "-V %use-id-as-filename%"
in the jw command. Now I have "t1.html" (which does not obey the ID of
"intro") and "summary.html" (which does).
I am now using "jw -f docbook -b html -V %use-id-as-identifier% sgml.file"
as a command. Ideally I would like to recreate the behavior of sgml-tools
many moons ago, and end up with either:
Sendmail-SMTP-AUTH-HOWTO-1.html
Sendmail-SMTP-AUTH-HOWTO-2.html
Sendmail-SMTP-AUTH-HOWTO-3.html
which is good since it indicates order, or:
Sendmail-SMTP-AUTH-HOWTO-intro.html
Sendmail-SMTP-AUTH-HOWTO-summary.html
Sendmail-SMTP-AUTH-HOWTO-faq.html
which is good in a different way since it indicates content. I think I
prefer the first, but have not made up my mind yet.
So there are now three questions about pretty HTML names:
1. Why is the ID for intro not being read or used?
2. Is there a way I can prepend "Sendmail-SMTP-AUTH-HOWTO-" to
whatever name jw chooses, and still have it create the links correctly? So
far I've done this by hand, but of course that will quickly become unwieldy.
3. Instead of using the ID tag associated with each section, is it
possible to have jw name the HTML files sequentially as in the first example?
>Hope that helps!
Indeed it does; as you can see, I am making progress.
--
Rodolfo J. Paiz
####@####.####