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