| 1 |
<?xml version="1.0"?> |
| 2 |
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format" font-family="Times Roman" font-size="10pt" text-align="justify"> |
| 3 |
<fo:layout-master-set> |
| 4 |
<fo:simple-page-master master-name="blank" page-width="8.5in" page-height="11in" margin-top="1in" margin-bottom="1in" margin-left="10pc" margin-right="1in"> |
| 5 |
<fo:region-body margin-bottom="24pt" margin-top="24pt"/> |
| 6 |
<fo:region-before region-name="xsl-region-before-blank" extent="12pt"/> |
| 7 |
<fo:region-after region-name="xsl-region-after-blank" extent="12pt"/> |
| 8 |
</fo:simple-page-master> |
| 9 |
<fo:simple-page-master master-name="simple1" page-width="8.5in" page-height="11in" margin-top="1in" margin-bottom="1in" margin-left="10pc" margin-right="1in"> |
| 10 |
<fo:region-body margin-bottom="24pt" margin-top="24pt"/> |
| 11 |
<fo:region-before extent="12pt"/> |
| 12 |
<fo:region-after extent="12pt"/> |
| 13 |
</fo:simple-page-master> |
| 14 |
<fo:simple-page-master master-name="left1" page-width="8.5in" page-height="11in" margin-top="1in" margin-bottom="1in" margin-left="10pc" margin-right="1in"> |
| 15 |
<fo:region-body margin-bottom="24pt" margin-top="24pt"/> |
| 16 |
<fo:region-before region-name="xsl-region-before-left" extent="12pt"/> |
| 17 |
<fo:region-after region-name="xsl-region-after-left" extent="12pt"/> |
| 18 |
</fo:simple-page-master> |
| 19 |
<fo:simple-page-master master-name="right1" page-width="8.5in" page-height="11in" margin-top="1in" margin-bottom="1in" margin-left="1in" margin-right="10pc"> |
| 20 |
<fo:region-body margin-bottom="24pt" margin-top="24pt"/> |
| 21 |
<fo:region-before region-name="xsl-region-before-right" extent="12pt"/> |
| 22 |
<fo:region-after region-name="xsl-region-after-right" extent="12pt"/> |
| 23 |
</fo:simple-page-master> |
| 24 |
<fo:simple-page-master master-name="first1" page-width="8.5in" page-height="11in" margin-top="1in" margin-bottom="1in" margin-left="1in" margin-right="1in"> |
| 25 |
<fo:region-body margin-bottom="24pt" margin-top="24pt"/> |
| 26 |
<fo:region-before region-name="xsl-region-before-first" extent="12pt"/> |
| 27 |
<fo:region-after region-name="xsl-region-after-first" extent="12pt"/> |
| 28 |
</fo:simple-page-master> |
| 29 |
<fo:simple-page-master master-name="simple2" page-width="8.5in" page-height="11in" margin-top="1in" margin-bottom="1in" margin-left="10pc" margin-right="1in"> |
| 30 |
<fo:region-body column-count="1" margin-bottom="24pt" margin-top="24pt"/> |
| 31 |
<fo:region-before extent="12pt"/> |
| 32 |
<fo:region-after extent="12pt"/> |
| 33 |
</fo:simple-page-master> |
| 34 |
<fo:simple-page-master master-name="left2" page-width="8.5in" page-height="11in" margin-top="1in" margin-bottom="1in" margin-left="10pc" margin-right="1in"> |
| 35 |
<fo:region-body column-count="1" margin-bottom="24pt" margin-top="24pt"/> |
| 36 |
<fo:region-before region-name="xsl-region-before-left" extent="12pt"/> |
| 37 |
<fo:region-after region-name="xsl-region-after-left" extent="12pt"/> |
| 38 |
</fo:simple-page-master> |
| 39 |
<fo:simple-page-master master-name="right2" page-width="8.5in" page-height="11in" margin-top="1in" margin-bottom="1in" margin-left="1in" margin-right="10pc"> |
| 40 |
<fo:region-body column-count="1" margin-bottom="24pt" margin-top="24pt"/> |
| 41 |
<fo:region-before region-name="xsl-region-before-right" extent="12pt"/> |
| 42 |
<fo:region-after region-name="xsl-region-after-right" extent="12pt"/> |
| 43 |
</fo:simple-page-master> |
| 44 |
<fo:simple-page-master master-name="first2" page-width="8.5in" page-height="11in" margin-top="1in" margin-bottom="1in" margin-left="1in" margin-right="1in"> |
| 45 |
<fo:region-body column-count="1" margin-bottom="24pt" margin-top="24pt"/> |
| 46 |
<fo:region-before region-name="xsl-region-before-first" extent="12pt"/> |
| 47 |
<fo:region-after region-name="xsl-region-after-first" extent="12pt"/> |
| 48 |
</fo:simple-page-master> |
| 49 |
<fo:page-sequence-master master-name="titlepage1"> |
| 50 |
<fo:repeatable-page-master-alternatives> |
| 51 |
<fo:conditional-page-master-reference master-name="first1"/> |
| 52 |
</fo:repeatable-page-master-alternatives> |
| 53 |
</fo:page-sequence-master> |
| 54 |
<fo:page-sequence-master master-name="oneside1"> |
| 55 |
<fo:repeatable-page-master-alternatives> |
| 56 |
<fo:conditional-page-master-reference master-name="simple1"/> |
| 57 |
</fo:repeatable-page-master-alternatives> |
| 58 |
</fo:page-sequence-master> |
| 59 |
<fo:page-sequence-master master-name="twoside1"> |
| 60 |
<fo:repeatable-page-master-alternatives> |
| 61 |
<fo:conditional-page-master-reference master-name="blank" blank-or-not-blank="blank"/> |
| 62 |
<fo:conditional-page-master-reference master-name="right1" odd-or-even="odd"/> |
| 63 |
<fo:conditional-page-master-reference master-name="left1" odd-or-even="even"/> |
| 64 |
</fo:repeatable-page-master-alternatives> |
| 65 |
</fo:page-sequence-master> |
| 66 |
<fo:page-sequence-master master-name="titlepage2"> |
| 67 |
<fo:repeatable-page-master-alternatives> |
| 68 |
<fo:conditional-page-master-reference master-name="first2"/> |
| 69 |
</fo:repeatable-page-master-alternatives> |
| 70 |
</fo:page-sequence-master> |
| 71 |
<fo:page-sequence-master master-name="oneside2"> |
| 72 |
<fo:repeatable-page-master-alternatives> |
| 73 |
<fo:conditional-page-master-reference master-name="simple2"/> |
| 74 |
</fo:repeatable-page-master-alternatives> |
| 75 |
</fo:page-sequence-master> |
| 76 |
<fo:page-sequence-master master-name="twoside2"> |
| 77 |
<fo:repeatable-page-master-alternatives> |
| 78 |
<fo:conditional-page-master-reference master-name="blank" blank-or-not-blank="blank"/> |
| 79 |
<fo:conditional-page-master-reference master-name="right2" odd-or-even="odd"/> |
| 80 |
<fo:conditional-page-master-reference master-name="left2" odd-or-even="even"/> |
| 81 |
</fo:repeatable-page-master-alternatives> |
| 82 |
</fo:page-sequence-master> |
| 83 |
</fo:layout-master-set> |
| 84 |
<fo:page-sequence id="id2602136" hyphenate="true" master-name="titlepage1" language="en"> |
| 85 |
<fo:flow flow-name="xsl-region-body"> |
| 86 |
<fo:block> |
| 87 |
<fo:block font-family="Helvetica" font-weight="bold" font-size="24.8832pt" text-align="center" space-before="18.6624pt"> |
| 88 |
<fo:block keep-with-next.within-column="always" hyphenate="false">DocBook V4.0 Example Document</fo:block> |
| 89 |
</fo:block> |
| 90 |
<fo:block font-family="Helvetica" font-weight="bold" font-size="17.28pt" text-align="center" space-before="10.8pt" keep-with-next="always">Norman Walsh</fo:block> |
| 91 |
<fo:block break-after="page"/> |
| 92 |
<fo:block font-size="14.4pt" font-weight="bold" font-family="Helvetica"> |
| 93 |
<fo:block>DocBook V4.0 Example Document</fo:block> |
| 94 |
</fo:block> |
| 95 |
<fo:block font-size="10pt"> |
| 96 |
<fo:block>by Norman Walsh</fo:block> |
| 97 |
</fo:block> |
| 98 |
<fo:block font-size="10pt"> |
| 99 |
<fo:block> |
| 100 |
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">This document demonstrates the new tags in DocBook V4.0.</fo:block> |
| 101 |
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">The focus of this document is to present examples of new elements, |
| 102 |
minor changes such as the addition of new attribute values are not |
| 103 |
included.</fo:block> |
| 104 |
</fo:block> |
| 105 |
</fo:block> |
| 106 |
<fo:block break-after="page"/> |
| 107 |
</fo:block> |
| 108 |
</fo:flow> |
| 109 |
</fo:page-sequence> |
| 110 |
<fo:page-sequence hyphenate="true" format="i" master-name="titlepage1" language="en"> |
| 111 |
<fo:flow flow-name="xsl-region-body"> |
| 112 |
<fo:block space-before.minimum="0.5em" space-before.optimum="1em" space-before.maximum="2em" space-after.minimum="0.5em" space-after.optimum="1em" space-after.maximum="2em"> |
| 113 |
<fo:block> |
| 114 |
<fo:block space-after="1em" margin-left="-4pc" font-size="17.28pt" font-weight="bold" font-family="Helvetica">Table of Contents</fo:block> |
| 115 |
</fo:block> |
| 116 |
<fo:block text-align-last="justify" end-indent="2pc" last-line-end-indent="-2pc"> |
| 117 |
<fo:inline keep-with-next.within-line="always">1 Block-level Markup</fo:inline> |
| 118 |
<fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="id2901240"><fo:page-number-citation ref-id="id2901240"/></fo:basic-link></fo:inline> |
| 119 |
</fo:block> |
| 120 |
<fo:block text-align-last="justify" end-indent="2pc" last-line-end-indent="-2pc"> |
| 121 |
<fo:inline keep-with-next.within-line="always">2 Inline markup</fo:inline> |
| 122 |
<fo:inline keep-together.within-line="always"> <fo:leader leader-pattern="dots" keep-with-next.within-line="always"/> <fo:basic-link internal-destination="id2781886"><fo:page-number-citation ref-id="id2781886"/></fo:basic-link></fo:inline> |
| 123 |
</fo:block> |
| 124 |
</fo:block> |
| 125 |
</fo:flow> |
| 126 |
</fo:page-sequence> |
| 127 |
<fo:page-sequence id="id2901240" hyphenate="true" master-name="oneside1" language="en" initial-page-number="1"> |
| 128 |
<fo:static-content flow-name="xsl-region-before"> |
| 129 |
<fo:block text-align="center"> |
| 130 |
<fo:block font-size="10pt">Chapter 1. Block-level Markup</fo:block> |
| 131 |
</fo:block> |
| 132 |
</fo:static-content> |
| 133 |
<fo:static-content flow-name="xsl-region-after"> |
| 134 |
<fo:block text-align="center" font-size="10pt"> |
| 135 |
<fo:page-number/> |
| 136 |
</fo:block> |
| 137 |
</fo:static-content> |
| 138 |
<fo:flow flow-name="xsl-region-body"> |
| 139 |
<fo:block> |
| 140 |
<fo:block margin-left="-4pc" font-size="17.28pt" font-weight="bold" font-family="Helvetica"> |
| 141 |
<fo:block keep-with-next.within-column="always" hyphenate="false">Chapter 1. Block-level Markup</fo:block> |
| 142 |
</fo:block> |
| 143 |
</fo:block> |
| 144 |
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">There's a new simple-alternative for <fo:inline font-family="Courier">msgentry</fo:inline>: |
| 145 |
<fo:inline font-family="Courier">simplemsgentry</fo:inline>.</fo:block> |
| 146 |
<fo:block color="red"><simplemsgentry><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">The text of a message</fo:block><fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">An explanation of the message.</fo:block></fo:block></simplemsgentry></fo:block> |
| 147 |
<fo:block color="red"><simplemsgentry><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">The text of a message</fo:block><fo:block><fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">An explanation of the message.</fo:block></fo:block></simplemsgentry></fo:block> |
| 148 |
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Longer descriptions are possible in a <fo:inline font-family="Courier">revhistory</fo:inline>: |
| 149 |
</fo:block> |
| 150 |
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
| 151 |
<fo:block color="red"><revhistory><fo:block color="red"><revision><fo:block color="red"><revnumber>2</revnumber></fo:block><fo:block color="red"><date>today</date></fo:block><fo:block color="red"><authorinitials>nwalsh</authorinitials></fo:block><fo:block color="red"><revdescription> |
| 152 |
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Here are a few paragraphs of description:</fo:block> |
| 153 |
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Did some stuff.</fo:block> |
| 154 |
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Did some other stuff.</fo:block> |
| 155 |
</revdescription></fo:block></revision></fo:block><fo:block color="red"><revision><fo:block color="red"><revnumber>1</revnumber></fo:block><fo:block color="red"><date>yesterday</date></fo:block><fo:block color="red"><authorinitials>nwalsh</authorinitials></fo:block><fo:block color="red"><revdescription> |
| 156 |
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Here are a few paragraphs of description:</fo:block> |
| 157 |
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Did some stuff.</fo:block> |
| 158 |
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Did some other stuff.</fo:block> |
| 159 |
</revdescription></fo:block></revision></fo:block></revhistory></fo:block> |
| 160 |
</fo:block> |
| 161 |
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Ordered and itemized lists can have titles:</fo:block> |
| 162 |
<fo:block font-size="12pt" font-weight="bold">Itemized List</fo:block> |
| 163 |
<fo:list-block id="id2781606" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em"> |
| 164 |
<fo:list-item id="id2781616" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
| 165 |
<fo:list-item-label end-indent="label-end()"> |
| 166 |
<fo:block>•</fo:block> |
| 167 |
</fo:list-item-label> |
| 168 |
<fo:list-item-body start-indent="body-start()"> |
| 169 |
<fo:block>First thing</fo:block> |
| 170 |
</fo:list-item-body> |
| 171 |
</fo:list-item> |
| 172 |
<fo:list-item id="id2781627" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
| 173 |
<fo:list-item-label end-indent="label-end()"> |
| 174 |
<fo:block>•</fo:block> |
| 175 |
</fo:list-item-label> |
| 176 |
<fo:list-item-body start-indent="body-start()"> |
| 177 |
<fo:block>Second thing</fo:block> |
| 178 |
</fo:list-item-body> |
| 179 |
</fo:list-item> |
| 180 |
<fo:list-item id="id2781638" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
| 181 |
<fo:list-item-label end-indent="label-end()"> |
| 182 |
<fo:block>•</fo:block> |
| 183 |
</fo:list-item-label> |
| 184 |
<fo:list-item-body start-indent="body-start()"> |
| 185 |
<fo:block>Third thing</fo:block> |
| 186 |
</fo:list-item-body> |
| 187 |
</fo:list-item> |
| 188 |
</fo:list-block> |
| 189 |
<fo:block font-size="12pt" font-weight="bold">Ordered List</fo:block> |
| 190 |
<fo:list-block id="id2781650" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em" provisional-distance-between-starts="1.5em" provisional-label-separation="0.2em"> |
| 191 |
<fo:list-item id="id2781661" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
| 192 |
<fo:list-item-label end-indent="label-end()"> |
| 193 |
<fo:block>•</fo:block> |
| 194 |
</fo:list-item-label> |
| 195 |
<fo:list-item-body start-indent="body-start()"> |
| 196 |
<fo:block>First thing</fo:block> |
| 197 |
</fo:list-item-body> |
| 198 |
</fo:list-item> |
| 199 |
<fo:list-item id="id2781672" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
| 200 |
<fo:list-item-label end-indent="label-end()"> |
| 201 |
<fo:block>•</fo:block> |
| 202 |
</fo:list-item-label> |
| 203 |
<fo:list-item-body start-indent="body-start()"> |
| 204 |
<fo:block>Second thing</fo:block> |
| 205 |
</fo:list-item-body> |
| 206 |
</fo:list-item> |
| 207 |
<fo:list-item id="id2781682" space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em"> |
| 208 |
<fo:list-item-label end-indent="label-end()"> |
| 209 |
<fo:block>•</fo:block> |
| 210 |
</fo:list-item-label> |
| 211 |
<fo:list-item-body start-indent="body-start()"> |
| 212 |
<fo:block>Third thing</fo:block> |
| 213 |
</fo:list-item-body> |
| 214 |
</fo:list-item> |
| 215 |
</fo:list-block> |
| 216 |
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Linespecific environments can indicate line numbering:</fo:block> |
| 217 |
<fo:block wrap-option="no-wrap" text-align="start" white-space-collapse="false" linefeed-treatment="preserve" font-family="Courier" font-size="9pt" space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em"> |
| 218 |
<!ENTITY % linespecific.attrib |
| 219 |
"format NOTATION |
| 220 |
(linespecific) 'linespecific' |
| 221 |
linenumbering (numbered|unnumbered) #IMPLIED"> |
| 222 |
</fo:block> |
| 223 |
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">Added <fo:inline font-family="Courier">classsynopsis</fo:inline> for documenting |
| 224 |
object-oriented programming language classes. Here's one example:</fo:block> |
| 225 |
<fo:block color="red"><classsynopsis><fo:block color="red"><ooclass><fo:block color="red"><modifier>public</modifier></fo:block><fo:inline font-family="Courier">TextFileWriter</fo:inline></ooclass></fo:block><fo:block color="red"><ooclass><fo:inline font-family="Courier">HandlerBase</fo:inline></ooclass></fo:block><fo:block color="red"><fieldsynopsis><fo:block color="red"><modifier>private</modifier></fo:block>Writer<fo:inline font-family="Courier">writer</fo:inline></fieldsynopsis></fo:block><fo:block color="red"><fieldsynopsis><fo:block color="red"><modifier>public</modifier></fo:block>String<fo:inline font-family="Courier">writerName</fo:inline><fo:block color="red"><initializer>"MyWriter"</initializer></fo:block></fieldsynopsis></fo:block><fo:block color="red"><methodsynopsis><fo:block color="red"><modifier>static</modifier></fo:block><fo:block color="red"><modifier>public</modifier></fo:block>();<fo:inline font-family="Courier">write</fo:inline><fo:block color="red"><methodparam>ResultTreeFragment<fo:inline font-style="italic" font-family="Courier">frag</fo:inline></methodparam></fo:block><fo:block color="red"><methodparam>String<fo:inline font-style="italic" font-family="Courier">file</fo:inline></methodparam></fo:block><fo:inline font-family="Courier">SAXException</fo:inline></methodsynopsis></fo:block></classsynopsis></fo:block> |
| 226 |
</fo:flow> |
| 227 |
</fo:page-sequence> |
| 228 |
<fo:page-sequence id="id2781886" hyphenate="true" master-name="oneside1" language="en"> |
| 229 |
<fo:static-content flow-name="xsl-region-before"> |
| 230 |
<fo:block text-align="center"> |
| 231 |
<fo:block font-size="10pt">Chapter 2. Inline markup</fo:block> |
| 232 |
</fo:block> |
| 233 |
</fo:static-content> |
| 234 |
<fo:static-content flow-name="xsl-region-after"> |
| 235 |
<fo:block text-align="center" font-size="10pt"> |
| 236 |
<fo:page-number/> |
| 237 |
</fo:block> |
| 238 |
</fo:static-content> |
| 239 |
<fo:flow flow-name="xsl-region-body"> |
| 240 |
<fo:block> |
| 241 |
<fo:block margin-left="-4pc" font-size="17.28pt" font-weight="bold" font-family="Helvetica"> |
| 242 |
<fo:block keep-with-next.within-column="always" hyphenate="false">Chapter 2. Inline markup</fo:block> |
| 243 |
</fo:block> |
| 244 |
</fo:block> |
| 245 |
<fo:block space-before.optimum="1em" space-before.minimum="0.8em" space-before.maximum="1.2em">The <fo:inline font-family="Courier">sgmltag</fo:inline> element has new |
| 246 |
<fo:inline font-family="Courier">class</fo:inline> attribute values: |
| 247 |
<fo:inline font-family="Courier">xmlpi</fo:inline> and |
| 248 |
<fo:inline font-family="Courier">emptytag</fo:inline>. These produce |
| 249 |
<fo:inline font-family="Courier"><?processing instructions?></fo:inline> |
| 250 |
and <fo:inline font-family="Courier"><empty-tag/></fo:inline> markup |
| 251 |
suitable for XML. |
| 252 |
</fo:block> |
| 253 |
</fo:flow> |
| 254 |
</fo:page-sequence> |
| 255 |
</fo:root> |