-Make TOC on titlepage without first section, and without kludge.
[privoxy.git] / doc / source / ldp.dsl.in
1 <!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [\r
2 <!ENTITY % html "IGNORE">\r
3 <![%html;[\r
4 <!ENTITY % print "IGNORE">\r
5 <!ENTITY docbook.dsl SYSTEM "@DKPREFIX@/html/docbook.dsl" CDATA dsssl>\r
6 ]]>\r
7 <!ENTITY % print "INCLUDE">\r
8 <![%print;[\r
9 <!ENTITY docbook.dsl SYSTEM "@DKPREFIX@/print/docbook.dsl" CDATA dsssl>\r
10 ]]>\r
11 ]>\r
12 \r
13 <!--\r
14 \r
15 ;; borrowed from the LDP stylesheet, with modifications, HB.\r
16 ;; Added support for css 03/20/02, and other mods.\r
17 \r
18 -->\r
19 \r
20 <style-sheet>\r
21 \r
22 <style-specification id="print" use="docbook">\r
23 <style-specification-body> \r
24 \r
25 ;; ==============================\r
26 ;; customize the print stylesheet\r
27 ;; ==============================\r
28 ;;\r
29 ;; see http://docbook.sourceforge.net/projects/dsssl/doc/print.html\r
30 ;;\r
31 \r
32 (define %generate-part-toc-on-titlepage%\r
33   ;; Should the Part TOC appear on the Part title page?\r
34   #f)\r
35 \r
36 (define %generate-article-toc-on-titlepage%\r
37   ;; Should the Article TOC appear on the Article title page?\r
38   #f)\r
39 \r
40 (define %indent-screen-lines%\r
41   ;; Indent lines in a 'Screen'?\r
42   #t)\r
43 \r
44 (define %callout-fancy-bug% \r
45   ;; Use fancy callout bugs?\r
46   #t)\r
47 \r
48 (define %chap-app-running-heads% \r
49   ;; Generate running headers and footers on chapter-level elements?\r
50   #t)\r
51 \r
52 (define %chap-app-running-head-autolabel% \r
53   ;; Put chapter labels in running heads?\r
54   #t)\r
55 \r
56 ;; this is necessary because right now jadetex does not understand\r
57 ;; symbolic entities, whereas things work well with numeric entities.\r
58 (declare-characteristic preserve-sdata?\r
59   "UNREGISTERED::James Clark//Characteristic::preserve-sdata?"\r
60   #f)\r
61 \r
62 ;; put the legal notice in a separate file\r
63 (define %generate-legalnotice-link%\r
64   #t)\r
65 \r
66 ;; use graphics in admonitions, and have their path be "stylesheet-images"\r
67 ;; NO: they do not yet look very good\r
68 (define %admon-graphics-path%\r
69   "./stylesheet-images/")\r
70 \r
71 (define %admon-graphics%\r
72   #f)\r
73 \r
74 (define %funcsynopsis-decoration%\r
75   ;; make funcsynopsis look pretty\r
76   #t)\r
77 \r
78 (define %generate-article-toc% \r
79   ;; Should a Table of Contents be produced for Articles?\r
80   ;; If true, a Table of Contents will be generated for each 'Article'.\r
81   #t)\r
82 \r
83 (define %generate-part-toc%\r
84   #t)\r
85 \r
86 ;;(define %shade-verbatim%\r
87 ;;  #t)\r
88 \r
89 (define %section-autolabel% #t)\r
90   ;; For enumerated sections (1.1, 1.1.1, 1.2, etc.)\r
91   \r
92 ;; HB changed TOC depth to 3 levels.\r
93 (define (toc-depth nd)\r
94   3)\r
95 \r
96 ;; HB added 03/20/02, see dbparam.dsl ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\r
97 \r
98 (define %body-attr% \r
99   ;; REFENTRY body-attr\r
100   ;; PURP What attributes should be hung off of BODY?\r
101   ;; DESC\r
102   ;; A list of the the BODY attributes that should be generated.\r
103   ;; The format is a list of lists, each interior list contains the\r
104   ;; name and value of a BODY attribute.\r
105   ;; /DESC\r
106   ;; AUTHOR N/A\r
107   ;; /REFENTRY\r
108   (list\r
109    (list "BGCOLOR" "#EEEEEE")\r
110    (list "TEXT" "#000000")\r
111    (list "LINK" "#0000FF")\r
112    (list "VLINK" "#840084")\r
113    (list "ALINK" "#0000FF")))\r
114 \r
115 (define %stylesheet%\r
116   ;; REFENTRY stylesheet\r
117   ;; PURP Name of the stylesheet to use\r
118   ;; DESC\r
119   ;; The name of the stylesheet to place in the HTML LINK TAG, or '#f' to\r
120   ;; suppress the stylesheet LINK.\r
121   ;; /DESC\r
122   ;; AUTHOR N/A\r
123   ;; /REFENTRY\r
124   "../p_doc.css")\r
125 \r
126 (define %stylesheet-type%\r
127   ;; REFENTRY stylesheet-type\r
128   ;; PURP The type of the stylesheet to use\r
129   ;; DESC\r
130   ;; The type of the stylesheet to place in the HTML LINK TAG.\r
131   ;; /DESC\r
132   ;; AUTHOR N/A\r
133   ;; /REFENTRY\r
134   "text/css")\r
135 \r
136 (define %css-liststyle-alist%\r
137   ;; REFENTRY css-liststyle-alist\r
138   ;; PURP Map DocBook OVERRIDE and MARK attributes to CSS\r
139   ;; DESC\r
140   ;; If '%css-decoration%' is turned on then the list-style-type property of\r
141   ;; list items will be set to reflect the list item style selected in the\r
142   ;; DocBook instance.  This associative list maps the style type names used\r
143   ;; in your instance to the appropriate CSS names.  If no mapping exists,\r
144   ;; the name from the instance will be used.\r
145   ;; /DESC\r
146   ;; AUTHOR N/A\r
147   ;; /REFENTRY\r
148   '(("bullet" "disc")\r
149     ("box" "square")))\r
150 \r
151 (define %css-decoration%\r
152   ;; REFENTRY css-decoration\r
153   ;; PURP Enable CSS decoration of elements\r
154   ;; DESC\r
155   ;; If '%css-decoration%' is turned on then HTML elements produced by the\r
156   ;; stylesheet may be decorated with STYLE attributes.  For example, the\r
157   ;; LI tags produced for list items may include a fragment of CSS in the\r
158   ;; STYLE attribute which sets the CSS property "list-style-type".\r
159   ;; /DESC\r
160   ;; AUTHOR N/A\r
161   ;; /REFENTRY\r
162   #t)\r
163 \r
164 ;; swa1\r
165 \r
166 ;; This seems to have no affect\r
167 (define %generate-article-titlepage-on-separate-page% #t)\r
168 \r
169 (define %body-start-indent%\r
170   ;; Default indent of body text\r
171   2pi)\r
172 \r
173 (define %para-indent-firstpara%\r
174   ;; First line start-indent for the first paragraph\r
175   0pt)\r
176 \r
177 ;; swa2\r
178 \r
179 (define %para-indent%\r
180   ;; First line start-indent for paragraphs (other than the first)\r
181   0pt)\r
182 \r
183 (define %block-start-indent%\r
184   ;; Extra start-indent for block-elements\r
185   2pt)\r
186 \r
187 ;;Define distance between paragraphs\r
188 (define %para-sep% \r
189  (/ %bf-size% 2.0))\r
190 \r
191 ;; with swa2 no effects\r
192 \r
193 ;; swa3\r
194 \r
195 ;;Define distance between block elements (figures, tables, etc.).\r
196 (define %block-sep% \r
197  (* %para-sep% 1.0))\r
198 ;; (* %para-sep% 2.0))\r
199 \r
200 (define %hyphenation%\r
201   ;; Allow automatic hyphenation?\r
202   #t)\r
203 \r
204 (define %left-margin% 5pi)\r
205 (define %right-margin% 5pi)\r
206 (define %top-margin% 5pi)\r
207 (define %bottom-margin% 5pi)\r
208 (define %footer-margin% 2pi)\r
209 (define %header-margin% 2pi)\r
210 \r
211 (define %line-spacing-factor% 1.3)\r
212   ;; Factor used to calculate leading\r
213   ;; The leading is calculated by multiplying the current font size by the \r
214   ;; '%line-spacing-factor%'. For example, if the font size is 10pt and\r
215   ;; the '%line-spacing-factor%' is 1.1, then the text will be\r
216   ;; printed "10-on-11".\r
217 \r
218 (define %head-before-factor% \r
219   ;; Factor used to calculate space above a title\r
220   ;; The space before a title is calculated by multiplying the font size\r
221   ;; used in the title by the '%head-before-factor%'.\r
222 ;;  0.75)\r
223   0.5)\r
224 \r
225 (define %head-after-factor% \r
226   ;; Factor used to calculate space below a title\r
227   ;; The space after a title is calculated by multiplying the font size used\r
228   ;; in the title by the '%head-after-factor%'.\r
229   0.5)\r
230 \r
231 (define %input-whitespace-treatment% 'collapse)\r
232 \r
233 (define ($generate-article-lot-list$)\r
234   ;; Which Lists of Titles should be produced for Articles?\r
235   (list ))\r
236 \r
237 \r
238 </style-specification-body>\r
239 </style-specification>\r
240 \r
241 \r
242 <!--\r
243 ;; ===================================================\r
244 ;; customize the html stylesheet; borrowed from Cygnus\r
245 ;; at http://sourceware.cygnus.com/ (cygnus-both.dsl)\r
246 ;; ===================================================\r
247 -->\r
248 \r
249 <style-specification id="html" use="docbook">\r
250 <style-specification-body> \r
251 \r
252 ;; this is necessary because right now jadetex does not understand\r
253 ;; symbolic entities, whereas things work well with numeric entities.\r
254 (declare-characteristic preserve-sdata?\r
255   "UNREGISTERED::James Clark//Characteristic::preserve-sdata?"\r
256   #f)\r
257 \r
258 ;; put the legal notice in a separate file\r
259 (define %generate-legalnotice-link%\r
260   #t)\r
261 \r
262 ;; use graphics in admonitions, and have their path be "stylesheet-images"\r
263 ;; NO: they do not yet look very good\r
264 (define %admon-graphics-path%\r
265   "./stylesheet-images/")\r
266 \r
267 (define %admon-graphics%\r
268   #f)\r
269 \r
270 (define %funcsynopsis-decoration%\r
271   ;; make funcsynopsis look pretty\r
272   #t)\r
273 \r
274 (define %html-ext%\r
275   ".html")\r
276 \r
277 (define %generate-article-toc% \r
278   ;; Should a Table of Contents be produced for Articles?\r
279   ;; If true, a Table of Contents will be generated for each 'Article'.\r
280   #t)\r
281 \r
282 ;; HB added next three statements 05/03/02.\r
283 ;;Do you want a separate page for the title?\r
284 (define %generate-article-titlepage-on-separate-page%\r
285  #t)\r
286 \r
287 ;;Do you want the article toc on the titlepage or separate?\r
288 (define %generate-article-toc-on-titlepage%\r
289  #t)\r
290 \r
291 ;;Titlepage Separate?\r
292 ;; This is the one that makes TOC only on first page!! hal.\r
293 (define (chunk-skip-first-element-list)\r
294  '())\r
295 \r
296 (define %root-filename%\r
297   ;; The filename of the root HTML document (e.g, "index").\r
298   "index")\r
299 \r
300 (define %generate-part-toc%\r
301   #t)\r
302 \r
303 (define %shade-verbatim%\r
304   #t)\r
305 \r
306 (define %use-id-as-filename%\r
307   ;; Use ID attributes as name for component HTML files?\r
308   #t)\r
309 \r
310 (define %graphic-default-extension% \r
311   "gif")\r
312 \r
313 (define %section-autolabel% #t)\r
314   ;; For enumerated sections (1.1, 1.1.1, 1.2, etc.)\r
315   \r
316 ;; HB changed TOC depth to 3 levels.\r
317 (define (toc-depth nd)\r
318   3)\r
319 \r
320 ;; HB added 03/20/02, see dbparam.dsl ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\r
321 \r
322 (define %body-attr% \r
323   ;; REFENTRY body-attr\r
324   ;; PURP What attributes should be hung off of BODY?\r
325   ;; DESC\r
326   ;; A list of the the BODY attributes that should be generated.\r
327   ;; The format is a list of lists, each interior list contains the\r
328   ;; name and value of a BODY attribute.\r
329   ;; /DESC\r
330   ;; AUTHOR N/A\r
331   ;; /REFENTRY\r
332   (list\r
333    (list "BGCOLOR" "#EEEEEE")\r
334    (list "TEXT" "#000000")\r
335    (list "LINK" "#0000FF")\r
336    (list "VLINK" "#840084")\r
337    (list "ALINK" "#0000FF")))\r
338 \r
339 (define %stylesheet%\r
340   ;; REFENTRY stylesheet\r
341   ;; PURP Name of the stylesheet to use\r
342   ;; DESC\r
343   ;; The name of the stylesheet to place in the HTML LINK TAG, or '#f' to\r
344   ;; suppress the stylesheet LINK.\r
345   ;; /DESC\r
346   ;; AUTHOR N/A\r
347   ;; /REFENTRY\r
348   "../p_doc.css")\r
349 \r
350 (define %stylesheet-type%\r
351   ;; REFENTRY stylesheet-type\r
352   ;; PURP The type of the stylesheet to use\r
353   ;; DESC\r
354   ;; The type of the stylesheet to place in the HTML LINK TAG.\r
355   ;; /DESC\r
356   ;; AUTHOR N/A\r
357   ;; /REFENTRY\r
358   "text/css")\r
359 \r
360 (define %css-liststyle-alist%\r
361   ;; REFENTRY css-liststyle-alist\r
362   ;; PURP Map DocBook OVERRIDE and MARK attributes to CSS\r
363   ;; DESC\r
364   ;; If '%css-decoration%' is turned on then the list-style-type property of\r
365   ;; list items will be set to reflect the list item style selected in the\r
366   ;; DocBook instance.  This associative list maps the style type names used\r
367   ;; in your instance to the appropriate CSS names.  If no mapping exists,\r
368   ;; the name from the instance will be used.\r
369   ;; /DESC\r
370   ;; AUTHOR N/A\r
371   ;; /REFENTRY\r
372   '(("bullet" "disc")\r
373     ("box" "square")))\r
374 \r
375 (define %css-decoration%\r
376   ;; REFENTRY css-decoration\r
377   ;; PURP Enable CSS decoration of elements\r
378   ;; DESC\r
379   ;; If '%css-decoration%' is turned on then HTML elements produced by the\r
380   ;; stylesheet may be decorated with STYLE attributes.  For example, the\r
381   ;; LI tags produced for list items may include a fragment of CSS in the\r
382   ;; STYLE attribute which sets the CSS property "list-style-type".\r
383   ;; /DESC\r
384   ;; AUTHOR N/A\r
385   ;; /REFENTRY\r
386   #t)\r
387 \r
388 \r
389 </style-specification-body>\r
390 </style-specification>\r
391 \r
392 <external-specification id="docbook" document="docbook.dsl">\r
393 \r
394 </style-sheet>\r