DSSSL to PDF and Postscript

1 Where do I find the user customizable variables?
2 How do I set the paper type?
3 How do I get justified output?
4 How do I generate entries in the PDF Document Info?
5 How do I generate bookmarks?
6 How do I show the bookmark entries expanded?
7 How do I control the level of expanded bookmark subtrees?
8 How do I change the link appearance from boxed to coloured?
9 How do I change the link colour?
10 How do I influence hyphenation?
11 How do I generate PDF thumbnails?
12 How do generate two sided output?
13 How do I get two-side mode to work properly?
14 How do I get the title page recto and verso pages to work correctly in two-side mode?
15 How do I get a separate header page for each chapter?

1 Where do I find the user customizable variables?

The default styleheet files contain two files (for HTML and print output) named dbparam.dsl. Locate these files and look carefully over them. A few of the user customizable variables are mentioned below.

2 How do I set the paper type?

Set the following in your customization stylesheet:

(define %paper-type% "A4")

The default stylesheet sets this to "USletter".

3 How do I get justified output?

Set the following in your customization stylesheet:

(define %default-quadding% 'justify)

(the default stylesheet sets this to 'start, which means left-justified).

4 How do I generate entries in the PDF Document Info?

Create a file jadetex.cfg in your working directory which looks like:

\hypersetup{pdftitle={Some Title},
            pdfsubject={Some Subject},
            pdfauthor={Some Author}
           }

You should consult the documentation of hyperref.sty for a complete and more detailled description of the possible configuration options.

5 How do I generate bookmarks?

Perform the following steps (works with at least V1.69 of the DSSSL stylesheets):

  • Use openjade to process your SGML file

  • Use a line like pdfpagemode=UseOutlines in your jadetex.cfg file (See for the general layout of the file jadetex.cfg)

  • If you are writing a <book> include the following lines in your customization layer:

    (declare-characteristic heading-level
      "UNREGISTERED::James Clark//Characteristic::heading-level" 2)
    

    If you are writing an <article> don't use these lines.

6 How do I show the bookmark entries expanded?

Use the following line in your jadetex.cfg file:

bookmarksopen=true

(See for the general layout of the file jadetex.cfg)

7 How do I control the level of expanded bookmark subtrees?

Use the following line in your jadetex.cfg file:

bookmarksopenlevel=level

and choose an appropriate value for level (See for the general layout of the file jadetex.cfg).

8 How do I change the link appearance from boxed to coloured?

Use the following line in your jadetex.cfg file:

colorlinks=true

(See for the general layout of the file jadetex.cfg)

9 How do I change the link colour?

Use the following line in your jadetex.cfg file:

linkcolor=blue

and choose an appropriate value for linkcolor. For this to work you have to set colorlinks=true too (and remember that entries in jadetex.cfg have to be comma separated - not white space separated! See for the general layout of the file jadetex.cfg).

10 How do I influence hyphenation?

The file jadetex.cfg can contain TeX code, so one possible solution is to specify the words you wish to hyphenate in jadetex.cfg in a special way like:

\hyphenation{hyph-enate-me}

(See for the general layout of the file jadetex.cfg).

11 How do I generate PDF thumbnails?

tbd.

12 How do generate two sided output?

Set the following in your customization stylesheet:

(define %two-side% #t)

(this is set already in the default stylesheet files).

13 How do I get two-side mode to work properly?

tbd.

14 How do I get the title page recto and verso pages to work correctly in two-side mode?

tbd.

15 How do I get a separate header page for each chapter?

tbd.