From: Steve Sheppard Date: Thu, 2 Sep 2010 17:17:25 +0000 (-0400) Subject: add new "docbook" directory to document updates and patches to our X-Git-Url: https://old-git.evergreen-ils.org/?a=commitdiff_plain;h=8bc4a6804e68d7776964e9b02db5f8b3db02b9cd;p=contrib%2FConifer.git add new "docbook" directory to document updates and patches to our DocBook toolchain to adjust rendering in our PDF or HTML files; --- diff --git a/1.6/docbook/README b/1.6/docbook/README new file mode 100644 index 0000000000..4e5252ad55 --- /dev/null +++ b/1.6/docbook/README @@ -0,0 +1,51 @@ +I made a few minor adjustments to my DocBook distribution to experiment with rendering in +the PDF file. These don't change the HTML file created, just the PDF file; + +I currently have DocBook installed on a Fedora-12 system in the directory tree: + "/usr/local/src/docbook-xsl-1.75.2". + +================================================================================ +The changes outlined below were made to the file: + "/usr/local/src/docbook-xsl-1.75.2/fo/param.xsl" +which should appear in all DocBook installations that use the FO rendering engine, +which is part of the DocBook toolchain that we use. + +I provided the modified version of the file "param.xsl", and a list of patch differences +in the file "diff.txt". + +To apply the changes, just backup the original file, then replace it with the modified file. +No other changes to the toolchain are required. + +To see the changes, just re-run "xsltproc" on an .XML file that already contains links or +figures and you should see the updates in the PDF file created. +================================================================================ + + + + +An outline of my changes follows: +--------------------------------- +1. Changes were motivated by my realization that you can't identify s to other chapters + or documents within the PDF file. + Now all links are rendered in blue, underlined italic text for easy identification. + + modify section "xref.properties": + set property "font-style" to italic; + set property "text-decoration" to underline; + set property "background-color" to blue; + +2. Changes were motivated by my desire to draw attention to figures or diagrams. + Now all figures are rendered in small text (75% the size of normal text), and a + background color is added to the figure to differentiate it from the surrounding + document. + + add new section "figure.properties"; + set property "background-color" to grey; + set property "font-size" to 75% + +3. Changes were motivated to see if I could do it :) + Now all sections within an tag are rendered in italic font. + + modify the section "abstract.properties"; + set property "font-style" to italic; + diff --git a/1.6/docbook/diff.txt b/1.6/docbook/diff.txt new file mode 100644 index 0000000000..57d7c8f1d4 --- /dev/null +++ b/1.6/docbook/diff.txt @@ -0,0 +1,54 @@ +7c7 +< $Id: diff.txt,v 1.1 2010/09/02 17:02:33 sheppards Exp sheppards $ +--- +> $Id: diff.txt,v 1.1 2010/09/02 17:02:33 sheppards Exp sheppards $ +18a19,24 +> +> +> italic +> inherit +> +> +936a943,961 +> +> +> +> italic +> inherit +> +> +> +> +> underline +> inherit +> +> +> +> +> #0000ff +> inherit +> +> +937a963,984 +> +> +> +> +> 75% +> inherit +> +> +> +> +> #f9f9f9 +> inherit +> +> +> +> +> black +> inherit +> +> +> +> diff --git a/1.6/docbook/param.xsl b/1.6/docbook/param.xsl new file mode 100644 index 0000000000..0464ec2dd8 --- /dev/null +++ b/1.6/docbook/param.xsl @@ -0,0 +1,988 @@ + + + + + + + + + 0.0in + 0.0in + + + italic + inherit + + + + + + bold + always + always + + + + false + center + +.png + +images/ + + + + 14pt + bold + false + always + + + 1em + 0.8em + 1.2em + 1em + 0.8em + 1.2em + + + 0.8em + 1em + 1.2em + 0.25in + 0.25in + +justify +A + + + + + + + +. + +. + + 0.5in + -0.5in + +http://docbook.sourceforge.net/release/bibliography/bibliography.xml + + +normal + +0.5in +0.5in +0.5em +1em +2em + +serif +10 + + pt + +0.5in +0.5in + + + 0pt + 0pt + 4pc + + +0pt + + +60 + +.svg + +7pt + +30 +images/callouts/ +ZapfDingbats + +10 +10102 + + +no + + + +2 + + +12pt +12pt +12pt +12pt +12pt +12pt + + 0em + 0em + 0.2em + + + + always + + + + false + + + center + start + + + + + + + +0.5pt +24pt +6pt + + + + left + before + + + + +all +none +pt +serif + +maybe +http://docbook.sourceforge.net/release/images/draft.png + + + + ::= + + + + + + + + + + + 1 + 0 + + + + + + + + + + + + + +1 1 1 +14pt + + fixed + 100% + + + + pt + +1 + + + + 75% + normal + normal + + + + + normal + normal + + 0pt + 0pt + + wrap + treat-as-space + + + black + rule + 1in + + + + + 0.5em + 1em + 2em + 0.5em + 1em + 2em + always + + + +figure before +example before +equation before +table before +procedure before +task before + + + bold + + + pt + + false + 0.4em + 0.6em + 0.8em + + +kr + + + + + +/appendix toc,title +article/appendix nop +/article toc,title +book toc,title,figure,table,example,equation +/chapter toc,title +part toc,title +/preface toc,title +reference toc,title +/sect1 toc +/sect2 toc +/sect3 toc +/sect4 toc +/sect5 toc +/section toc +set toc,title + + + + +no + + +0.25in +2in + + 1em + 0.8em + 1.2em + + + + + 1em + 0.8em + 1.2em + always + always + + + + + .25in + + + + + + + + + + + +1 1 1 +14pt + + fixed + 100% + + + + + +true + + + + +basic + + + + + + + + + 0.5em + 1em + 2em + 0.5em + 1em + 2em + + + + bold + + + 0pt + 14.4pt + + bold + always + + + + 0pt + + + 0pt + + + + +no +no + + + + + 1.0em + + + +en + + + + +normal +5 + + +3 + + 0.2em + 1.5em + + + 1em + 0.8em + 1.2em + 1em + 0.8em + 1.2em + + + 1em + 0.8em + 1.2em + + + + + + 90% + start + + + bold + false + start + always + +none +1in +2 + ++ +monospace + + + + + + + start + no-wrap + +0.60em +6in + + 1em + 0.8em + 1.2em + +no + + + + replace + + + + 2em + + + +1.2em + +no + + + + + + + + + + + + + + 210mm + 11in + 8.5in + 2378mm + 1682mm + 1189mm + 841mm + 594mm + 420mm + 297mm + 210mm + 148mm + 105mm + 74mm + 52mm + 37mm + 1414mm + 1000mm + 707mm + 500mm + 353mm + 250mm + 176mm + 125mm + 88mm + 62mm + 44mm + 1297mm + 917mm + 648mm + 458mm + 324mm + 229mm + 162mm + 114mm + 81mm + 57mm + 40mm + 11in + + +0.5in + + + 1.25in + 1in + + + + + 0.75in + 1in + + +0.5in +portrait + + + + + + + + + + + + + 8.5in + 1682mm + 1189mm + 841mm + 594mm + 420mm + 297mm + 210mm + 148mm + 105mm + 74mm + 52mm + 37mm + 26mm + 1000mm + 707mm + 500mm + 353mm + 250mm + 176mm + 125mm + 88mm + 62mm + 44mm + 31mm + 917mm + 648mm + 458mm + 324mm + 229mm + 162mm + 114mm + 81mm + 57mm + 40mm + 28mm + 8.5in + + +USletter +I + + + 0pt + + + + + auto + + + + + + + + + + + + + + +; + + + + + +. +number + + + + + + + + pt + + + + + + pt + + + + + + pt + + + + + + pt + + + + + + pt + + + + + + pt + + + + + + + bold + + always + 0.8em + 1.0em + 1.2em + + + + + + + + + 18pt + bold + 1em + false + always + 0.8em + 1.0em + 1.2em + 0.5em + 0.4em + 0.6em + + + + I + +0.4in +0.4in + + + + + + + + + + + + + + + + + + + + character-by-character + disregard-shifts + + + + + +. +.!?: +sans-serif + +8 +block + + + + + pt + + + + + + pt + + + + + + pt + + + + + + pt + + + + + + pt + + + + + + pt + + + + + + + bold + + always + 0.8em + 1.0em + 1.2em + start + + + + + + + + + + + + + + + + + + + + + #E0E0E0 + + + + solid + 1pt + black + #DDDDDD + 12pt + 12pt + 6pt + 6pt + 0pt + 0pt + + + + bold + false + start + always + +none +1in + + + 75% + + + 75% + +Symbol,ZapfDingbats + +black +solid +0.5pt + + 2pt + 2pt + 2pt + 2pt + +a + + + + + normal + normal + 2pt + + + +black +solid +0.5pt + + auto + + + + retain + collapse + + olinkdb.xml +target.db + + + + +sans-serif + + + -4pc + 0pt + 0pt + + +24 + + + justify + start + + + + + 0.5em + 1em + 2em + 0.5em + 1em + 2em + +8 +2 + + +/ + + + + + + + +24 +, + + +0 + + 0.8em + 1em + 1.2em + 0.8em + 1em + 1.2em + false + no-wrap + false + preserve + preserve + start + + + + writing-mode + + + + + + + + + + true + true + + +: + + + + italic + inherit + + + + + underline + inherit + + + + + #0000ff + inherit + + + + + + + + 75% + inherit + + + + + #f9f9f9 + inherit + + + + + black + inherit + + + + + + + +