This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
HTML Help DSSSL customization
- To: docbook-apps at lists dot oasis-open dot org
- Subject: DOCBOOK-APPS: HTML Help DSSSL customization
- From: "Bradford, Denis" <denisb at rational dot com>
- Date: Thu, 12 Jul 2001 14:47:51 -0400
My first customization driver for htmlhelp.dsl worked: My app (Epic) calls
myhtmlhelp.dsl (appended below), which somehow references htmlhelp.dsl, and
includes my customizations to chunk-element-list.
However, when I add the following customization (which modifies dbl1en.dsl)
to the driver, jade tells me it can't resolve the §ion; variable:
(define (en-sectioning-xref-string gi-or-name)
(if %section-autolabel%
"&Section; %n"
;; "the §ion; called %t")) ;; original
"%t")) ;; modified
I must misunderstand something about the driver works - how come the first
customization works while the second doesn't? Here's my driver file:
<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
<!ENTITY htmlhelp.dsl SYSTEM "htmlhelp.dsl" CDATA DSSSL>
]>
<!--
**************************************************************************
This is the driver file for CMBU customizations to the htmlhelp.dsl and
related modules.
It should be copied to the same directory where the user's htmlhelp.dsl
lives
(for example, C:\Program Files\Epic\epic\dsssl\axdocbook).
**************************************************************************
-->
<!-- *********************** Maintenance
**************************************
07-05-01 Created - denisb
Modify chunk-element-list to eliminate chunking at section
level - denisb
07-06-01 Modified common/dbl1en.dsl: fix autogen for xrefs to formal
figures, tables, etc.
Changes should go here, but variables like &chapter don't
resolve.
So leaving them in dbl1en.dsl where they work, for now.
**************************************************************************
-->
<style-sheet>
<style-specification use="htmlhelp">
<style-specification-body>
;; your (re)definitions go here
;; The following block customizes dbchunk.dsl to keep sections from
chunking.
(define (chunk-element-list)
(list (normalize "preface")
(normalize "chapter")
(normalize "appendix")
(normalize "article")
(normalize "glossary")
(normalize "bibliography")
(normalize "index")
(normalize "colophon")
(normalize "setindex")
(normalize "reference")
(normalize "refentry")
(normalize "part")
(normalize "sect1")
; (normalize "section") ;; omitted for help - denisb
(normalize "book") ;; just in case nothing else matches...
(normalize "set") ;; sets are definitely chunks...
))
;; Add block here to display generated text for formal elements using
appropriate format for help
</style-specification-body>
</style-specification>
<external-specification id="htmlhelp" document="htmlhelp.dsl">
</style-sheet>
___________________________
Denis Bradford
Rational Software, 20 Maguire Road, Lexington, MA 02421
denisb@rational.com
(781)676-7560