0c7948e20123db6104d64f61c3e73839cbb7571a
[privoxy.git] / doc / source / ldp.dsl
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 "/usr/share/sgml/docbook/dsssl-stylesheets/html/docbook.dsl" CDATA dsssl>\r
6 ]]>\r
7 <!ENTITY % print "INCLUDE">\r
8 <![%print;[\r
9 <!ENTITY docbook.dsl SYSTEM "/usr/share/sgml/docbook/dsssl-stylesheets/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 ;;\r
30 ;; shamelessly stolen from the wine project.\r
31 ;;\r
32 ;; see http://docbook.sourceforge.net/projects/dsssl/doc/print.html\r
33 ;;\r
34 \r
35 \r
36 ;; I was hoping that this would take out the many blank pages in the\r
37 ;; PDF file, but it doesn't, it just slides the page numbers over.  \r
38 ;; (define %two-side% #f)\r
39 \r
40 (define %generate-article-titlepage% #t)\r
41 \r
42 ;;;;Titlepage Not Separate\r
43 ;;(define (chunk-skip-first-element-list)\r
44 ;;  (list (normalize "sect1")\r
45 ;;      (normalize "section")))\r
46 \r
47 ;;Titlepage Separate?\r
48 ;(define (chunk-skip-first-element-list) \r
49 ;  '())\r
50 \r
51 (define (list-element-list)\r
52   ;; fixes bug in Table of Contents generation\r
53   '())\r
54 \r
55 (define %generate-article-toc% \r
56   ;; Should a Table of Contents be produced for Articles?\r
57   ;; If true, a Table of Contents will be generated for each 'Article'.\r
58   #t)\r
59 \r
60 (define (toc-depth nd)\r
61   2)\r
62 \r
63 (define %shade-verbatim%\r
64   #t)\r
65 \r
66 ;; This seems to have no affect\r
67 (define %generate-article-titlepage-on-separate-page% #f)\r
68 \r
69 (define %body-start-indent%\r
70   ;; Default indent of body text\r
71   2pi)\r
72 \r
73 (define %para-indent-firstpara%\r
74   ;; First line start-indent for the first paragraph\r
75   0pt)\r
76 \r
77 (define %para-indent%\r
78   ;; First line start-indent for paragraphs (other than the first)\r
79   0pt)\r
80 \r
81 (define %block-start-indent%\r
82   ;; Extra start-indent for block-elements\r
83   2pt)\r
84 \r
85 ;;Define distance between paragraphs\r
86 (define %para-sep% \r
87  (/ %bf-size% 2.0))\r
88 \r
89 ;;Define distance between block elements (figures, tables, etc.).\r
90 (define %block-sep% \r
91  (* %para-sep% 1.0))\r
92 ;; (* %para-sep% 2.0))\r
93 \r
94 (define %hyphenation%\r
95   ;; Allow automatic hyphenation?\r
96   #t)\r
97 \r
98 (define %left-margin% 5pi)\r
99 (define %right-margin% 5pi)\r
100 (define %top-margin% 5pi)\r
101 (define %bottom-margin% 5pi)\r
102 \r
103 (define %footer-margin% 2pi)\r
104 (define %header-margin% 2pi)\r
105 \r
106 (define %line-spacing-factor% 1.3)\r
107   ;; Factor used to calculate leading\r
108   ;; The leading is calculated by multiplying the current font size by the \r
109   ;; '%line-spacing-factor%'. For example, if the font size is 10pt and\r
110   ;; the '%line-spacing-factor%' is 1.1, then the text will be\r
111   ;; printed "10-on-11".\r
112 \r
113 (define %head-before-factor% \r
114   ;; Factor used to calculate space above a title\r
115   ;; The space before a title is calculated by multiplying the font size\r
116   ;; used in the title by the '%head-before-factor%'.\r
117 ;;  0.75)\r
118   0.5)\r
119 \r
120 (define %head-after-factor% \r
121   ;; Factor used to calculate space below a title\r
122   ;; The space after a title is calculated by multiplying the font size used\r
123   ;; in the title by the '%head-after-factor%'.\r
124   0.5)\r
125 \r
126 (define %input-whitespace-treatment% 'collapse)\r
127 \r
128 (define ($generate-article-lot-list$)\r
129   ;; Which Lists of Titles should be produced for Articles?\r
130   (list ))\r
131 \r
132 ;;(define tex-backend \r
133 ;;  ;; Are we using the TeX backend?\r
134 ;;  ;; This parameter exists so that '-V tex-backend' can be used on the\r
135 ;;  ;; command line to explicitly select the TeX backend.\r
136 ;;  #t)\r
137 \r
138 </style-specification-body>\r
139 </style-specification>\r
140 \r
141 \r
142 <!--\r
143 ;; ===================================================\r
144 ;; customize the html stylesheet; borrowed from Cygnus\r
145 ;; at http://sourceware.cygnus.com/ (cygnus-both.dsl)\r
146 ;; ===================================================\r
147 -->\r
148 \r
149 <style-specification id="html" use="docbook">\r
150 <style-specification-body> \r
151 \r
152 ;; this is necessary because right now jadetex does not understand\r
153 ;; symbolic entities, whereas things work well with numeric entities.\r
154 (declare-characteristic preserve-sdata?\r
155   "UNREGISTERED::James Clark//Characteristic::preserve-sdata?"\r
156   #f)\r
157 \r
158 ;; put the legal notice in a separate file\r
159 (define %generate-legalnotice-link%\r
160   #t)\r
161 \r
162 ;; use graphics in admonitions, and have their path be "stylesheet-images"\r
163 ;; NO: they do not yet look very good\r
164 (define %admon-graphics-path%\r
165   "./stylesheet-images/")\r
166 \r
167 (define %admon-graphics%\r
168   #f)\r
169 \r
170 (define %funcsynopsis-decoration%\r
171   ;; make funcsynopsis look pretty\r
172   #t)\r
173 \r
174 (define %html-ext%\r
175   ".html")\r
176 \r
177 (define %generate-article-toc% \r
178   ;; Should a Table of Contents be produced for Articles?\r
179   ;; If true, a Table of Contents will be generated for each 'Article'.\r
180   #t)\r
181 \r
182 (define %root-filename%\r
183   ;; The filename of the root HTML document (e.g, "index").\r
184   "index")\r
185 \r
186 (define %generate-part-toc%\r
187   #t)\r
188 \r
189 (define %shade-verbatim%\r
190   #t)\r
191 \r
192 (define %use-id-as-filename%\r
193   ;; Use ID attributes as name for component HTML files?\r
194   #t)\r
195 \r
196 (define %graphic-default-extension% \r
197   "gif")\r
198 \r
199 (define %section-autolabel% #t)\r
200   ;; For enumerated sections (1.1, 1.1.1, 1.2, etc.)\r
201   \r
202 ;; HB changed TOC depth to 3 levels.\r
203 (define (toc-depth nd)\r
204   3)\r
205 \r
206 ;; HB added 03/20/02, see dbparam.dsl ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\r
207 \r
208 (define %body-attr% \r
209   ;; REFENTRY body-attr\r
210   ;; PURP What attributes should be hung off of BODY?\r
211   ;; DESC\r
212   ;; A list of the the BODY attributes that should be generated.\r
213   ;; The format is a list of lists, each interior list contains the\r
214   ;; name and value of a BODY attribute.\r
215   ;; /DESC\r
216   ;; AUTHOR N/A\r
217   ;; /REFENTRY\r
218   (list\r
219    (list "BGCOLOR" "#EEEEEE")\r
220    (list "TEXT" "#000000")\r
221    (list "LINK" "#0000FF")\r
222    (list "VLINK" "#840084")\r
223    (list "ALINK" "#0000FF")))\r
224 \r
225 (define %stylesheet%\r
226   ;; REFENTRY stylesheet\r
227   ;; PURP Name of the stylesheet to use\r
228   ;; DESC\r
229   ;; The name of the stylesheet to place in the HTML LINK TAG, or '#f' to\r
230   ;; suppress the stylesheet LINK.\r
231   ;; /DESC\r
232   ;; AUTHOR N/A\r
233   ;; /REFENTRY\r
234   "../p_doc.css")\r
235 \r
236 (define %stylesheet-type%\r
237   ;; REFENTRY stylesheet-type\r
238   ;; PURP The type of the stylesheet to use\r
239   ;; DESC\r
240   ;; The type of the stylesheet to place in the HTML LINK TAG.\r
241   ;; /DESC\r
242   ;; AUTHOR N/A\r
243   ;; /REFENTRY\r
244   "text/css")\r
245 \r
246 (define %css-liststyle-alist%\r
247   ;; REFENTRY css-liststyle-alist\r
248   ;; PURP Map DocBook OVERRIDE and MARK attributes to CSS\r
249   ;; DESC\r
250   ;; If '%css-decoration%' is turned on then the list-style-type property of\r
251   ;; list items will be set to reflect the list item style selected in the\r
252   ;; DocBook instance.  This associative list maps the style type names used\r
253   ;; in your instance to the appropriate CSS names.  If no mapping exists,\r
254   ;; the name from the instance will be used.\r
255   ;; /DESC\r
256   ;; AUTHOR N/A\r
257   ;; /REFENTRY\r
258   '(("bullet" "disc")\r
259     ("box" "square")))\r
260 \r
261 (define %css-decoration%\r
262   ;; REFENTRY css-decoration\r
263   ;; PURP Enable CSS decoration of elements\r
264   ;; DESC\r
265   ;; If '%css-decoration%' is turned on then HTML elements produced by the\r
266   ;; stylesheet may be decorated with STYLE attributes.  For example, the\r
267   ;; LI tags produced for list items may include a fragment of CSS in the\r
268   ;; STYLE attribute which sets the CSS property "list-style-type".\r
269   ;; /DESC\r
270   ;; AUTHOR N/A\r
271   ;; /REFENTRY\r
272   #t)\r
273 \r
274 \r
275 </style-specification-body>\r
276 </style-specification>\r
277 \r
278 <external-specification id="docbook" document="docbook.dsl">\r
279 \r
280 </style-sheet>\r