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