Add content to migrating bib records - mostly from wiki.
[working/Evergreen.git] / 1.6 / docbook / README
1 I made a few minor adjustments to my DocBook distribution to experiment with rendering in
2 the PDF file. These don't change the HTML file created, just the PDF file;
3
4 I currently have DocBook installed on a Fedora-12 system in the directory tree:
5         "/usr/local/src/docbook-xsl-1.75.2".
6
7 ================================================================================
8 The changes outlined below were made to the file:
9         "/usr/local/src/docbook-xsl-1.75.2/fo/param.xsl"
10 which should appear in all DocBook installations that use the FO rendering engine,
11 which is part of the DocBook toolchain that we use.
12
13 I provided the modified version of the file "param.xsl", and a list of patch differences
14 in the file "diff.txt".
15
16 To apply the changes, just backup the original file, then replace it with the modified file.
17 No other changes to the toolchain are required.
18
19 To see the changes, just re-run "xsltproc" on an .XML file that already contains links or
20 figures and you should see the updates in the PDF file created.
21 ================================================================================
22
23
24
25
26 An outline of my changes follows:
27 ---------------------------------
28 1. Changes were motivated by my realization that you can't identify <link>s to other chapters
29    or documents within the PDF file.
30    Now all links are rendered in blue, underlined italic text for easy identification.
31
32    modify section "xref.properties":
33         set property "font-style" to italic;
34         set property "text-decoration" to underline;
35         set property "background-color" to blue;
36
37 2. Changes were motivated by my desire to draw attention to figures or diagrams.
38    Now all figures are rendered in small text (75% the size of normal text), and a
39    background color is added to the figure to differentiate it from the surrounding
40    document.
41
42    add new section "figure.properties";
43         set property "background-color" to grey;
44         set property "font-size" to 75%
45
46 3. Changes were motivated to see if I could do it :)
47    Now all sections within an <abstract/> tag are rendered in italic font.
48
49    modify the section "abstract.properties";
50         set property "font-style" to italic;
51