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
|
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE chapter SYSTEM "chapter.dtd">
<chapter>
<header>
<copyright>
<year>2007</year><year>2016</year>
<holder>Ericsson AB. All Rights Reserved.</holder>
</copyright>
<legalnotice>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
</legalnotice>
<title>Fascicules DTDs</title>
<prepared></prepared>
<docno></docno>
<date></date>
<rev></rev>
<file>fasc_dtds.xml</file>
</header>
<section>
<title>The fascicules DTD</title>
<p>The <c>fascicules</c> DTD is a special kind of DTD which can be
used to specify the different parts of the documentation, and
which one of those should be shown as default.</p>
<p>Example:</p>
<pre><![CDATA[
<?xml version="1.0" encoding="latin1" ?>
<!DOCTYPE fascicules SYSTEM "fascicules.dtd">
<fascicules>
<fascicule file="part" href="part_frame.html" entry="no">
User's Guide
</fascicule>
<fascicule file="ref_man" href="ref_man_frame.html" entry="yes">
Reference Manual
</fascicule>
<fascicule file="part_notes" href="part_notes_frame.html" entry="no">
Release Notes
</fascicule>
</fascicules>
]]></pre>
<p>In the example, it is specified that the documentation for this
application consists of three parts: User's Guide, where
the "cover page" (with the two frames) is located in
<c>part_frame.html</c>, Reference Manual with the cover page
<c>ref_man_frame.html</c> and Release Notes with the cover page
<c>part_notes_frame.html</c>.</p>
<p>As a result, at the top of the left frame in the generated HTML
documentation, there will be corresponding links to User's Guide,
Reference Manual and Release Notes.</p>
<p>The attribute <c>entry="yes"</c> specifies that it is
the Reference Manual which should be shown as default. This means
that when generating the HTML files, <c>application_frame.html</c>
will be copied to <c>index.html</c>.</p>
<note>
<p>DocBuilder assumes that the XML file written according to
the <c>fascicules</c> DTD is called <c>fascicules.xml</c>.</p>
</note>
<p>This file is optional. If it does not exist, there are no links
to other parts of the documentation (as they are not known) in
the left frame, and no <c>index.html</c> is created.</p>
</section>
<section>
<marker id="fasciculesTAG"></marker>
<title><fascicules></title>
<p>Top level tag for the <c>fascicules</c> DTD.</p>
<p>Contains one or more
<seealso marker="#fasciculeTAG"><fascicule></seealso>.</p>
</section>
<section>
<marker id="fasciculeTAG"></marker>
<title><fascicule></title>
<p>Specifies properties for one "part" of the documentation for an
application.</p>
<p>Contains plain text, the name of this part.</p>
<p>The <c>file</c> attribute should specify the file name for
the corresponding <c>part</c> or <c>application</c>, without
the <c>.xml</c> extension.</p>
<p>The <c>href</c> attribute should specify the file name for
the corresponding HTML cover page file, without the <c>.html</c>
extension.</p>
<p>The optional <c>entry="yes"|"no"</c> attribute specifies if
the HTML cover page should be copied to <c>index.html</c> or
not. Default is <c>"no"</c>.</p>
</section>
</chapter>
|
