blob: 88b1a49ada31debdbe40431686fab1e1fc68fad6 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
<!DOCTYPE HTML PUBLIC "http://www.w3.org/TR/REC-html40/loose.dtd" "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>DocBook V4.0 Example Document</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.29">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="book" id="id2670694">
<div class="titlepage">
<div><h1 class="title">
<a name="id2670694"></a>DocBook V4.0 Example Document</h1></div>
<div><h3 class="author">Norman Walsh</h3></div>
<div><div class="abstract">
<p>
<a name="id2781060"></a>
<b>Abstract</b>
</p>
<p>This document demonstrates the new tags in DocBook V4.0.</p>
<p>The focus of this document is to present examples of new elements,
minor changes such as the addition of new attribute values are not
included.</p>
</div></div>
<hr>
</div>
<div class="toc">
<p><b>Table of Contents</b></p>
<dl>
<dt>1. <a href="#id2781088">Block-level Markup</a>
</dt>
<dt>2. <a href="#id2691142">Inline markup</a>
</dt>
</dl>
</div>
<div id="id2781088" class="chapter">
<div class="titlepage"><div><h2 class="title">
<a name="id2781088"></a>Chapter 1. Block-level Markup</h2></div></div>
<p>There's a new simple-alternative for <tt>msgentry</tt>:
<tt>simplemsgentry</tt>.</p>
<div class="simplemsgentry">
<a name="id2781129"></a>
<p>The text of a message</p>
<div class="msgexplan">
<a name="id2780176"></a>
<p>An explanation of the message.</p>
</div>
</div>
<div class="simplemsgentry">
<a name="id2806834"></a>
<p>The text of a message</p>
<div class="msgexplan">
<a name="id2806850"></a>
<p>An explanation of the message.</p>
</div>
</div>
<p>Longer descriptions are possible in a <tt>revhistory</tt>:
</p>
<p>
<div class="revhistory"><table border="0" width="100%" summary="Revision history">
<tr><th align="left" valign="top" colspan="3"><b>Revision History</b></th></tr>
<tr>
<td align="left">Revision 2</td>
<td align="left">today</td>
<td align="left">nwalsh</td>
</tr>
<tr>
<td align="left">Revision 1</td>
<td align="left">yesterday</td>
<td align="left">nwalsh</td>
</tr>
</table></div>
</p>
<p>Ordered and itemized lists can have titles:</p>
<div class="itemizedlist">
<p><b>Itemized List</b></p>
<ul>
<li><p>
<a name="id2690702"></a>First thing</p></li>
<li><p>
<a name="id2690712"></a>Second thing</p></li>
<li><p>
<a name="id2690723"></a>Third thing</p></li>
</ul>
</div>
<div class="itemizedlist">
<p><b>Ordered List</b></p>
<ul>
<li><p>
<a name="id2690747"></a>First thing</p></li>
<li><p>
<a name="id2690757"></a>Second thing</p></li>
<li><p>
<a name="id2690768"></a>Third thing</p></li>
</ul>
</div>
<p>Linespecific environments can indicate line numbering:</p>
<pre class="programlisting">
<!ENTITY % linespecific.attrib
"format NOTATION
(linespecific) 'linespecific'
linenumbering (numbered|unnumbered) #IMPLIED">
</pre>
<p>Added <tt>classsynopsis</tt> for documenting
object-oriented programming language classes. Here's one example:</p>
<pre class="classsynopsis"> <span class="ooclass">
<span class="modifier">public </span>
<span class="classname">TextFileWriter</span>
</span> extends <span class="ooclass"><span class="classname">HandlerBase</span></span> {
<div class="fieldsynopsis"> <span class="modifier">private </span>
<span class="type">Writer </span>
<span class="varname">writer </span>;</div>
<div class="fieldsynopsis"> <span class="modifier">public </span>
<span class="type">String </span>
<span class="varname">writerName </span>
<span class="initializer">= "MyWriter"</span>;</div>
<div class="methodsynopsis"> <span class="modifier">static </span>
<span class="modifier">public </span>
<span class="void">void </span>
<span class="methodname">write</span>(<span class="methodparam">
<span class="type">ResultTreeFragment </span>
<span class="parameter">frag</span>
</span>,
<span class="methodparam">
<span class="type">String </span>
<span class="parameter">file</span>
</span>)
throws <span class="exceptionname">SAXException</span>;</div>}</pre>
</div>
<div id="id2691142" class="chapter">
<div class="titlepage"><div><h2 class="title">
<a name="id2691142"></a>Chapter 2. Inline markup</h2></div></div>
<p>The <tt>sgmltag</tt> element has new
class attribute values:
<tt>xmlpi</tt> and
<tt>emptytag</tt>. These produce
<tt><?processing instructions?></tt>
and <tt><empty-tag/></tt> markup
suitable for XML.
</p>
</div>
</div></body>
</html>
|
