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
142
143
144
145
146
147
|
<page xmlns="http://projectmallard.org/1.0/"
type="topic"
id="mal_info_credit">
<info>
<link type="guide" xref="mal_info#elements"/>
<revision version="0.1" date="2009-09-08" status="review"/>
<credit type="author">
<name>Shaun McCance</name>
<email>shaunm@gnome.org</email>
<years>2008</years>
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" />
<desc>Give credit where credit is due.</desc>
</info>
<title>Credits</title>
<synopsis><code mime="application/relax-ng-compact-syntax">
mal_info_credit = element credit {
attribute type { xsd:NMTOKENS } ?,
attribute * - (mal:* | local:*) { text } *,
(
<link xref="mal_info_name">mal_info_name</link> &
<link xref="mal_info_email">mal_info_email</link> ? &
<link xref="mal_info_years">mal_info_years</link> ? &
<link xref="mal_external">mal_external</link> *
)
}
</code></synopsis>
<p>Use the <code>credit</code> element to record who has contributed to the page
or section. You can optionally use the <code>type</code> attribute to specify
what types of contribution the person has made. The <code>credit</code> element
also specifies copyright holders when used with the
<code xref="mal_info_years">years</code> element.</p>
<!-- BEGIN notes -->
<section id="notes">
<title>Notes</title>
<list>
<item><p>The <code>credit</code> element contains a
<code xref="mal_info_name">name</code> element,
an optional <code xref="mal_info_email">>email</code> element,
and an optional <code xref="mal_info_years">years</code> element. The
<code>credit</code> element can also contain elements from external
namespaces. The order of the child elements does not matter.</p></item>
<item><p>The <code>credit</code> element can occur in any
<code xref="mal_info">info</code> element.</p></item>
<item>
<p>The optional <code>type</code> attribute can be used to specify
what type of contribution the person has made. The <code>type</code>
attribute contains a space-separated list of credit types. The following
values are recommended:</p>
<table rules="rows">
<tr>
<td><p><code>"author"</code></p></td>
<td><p>somebody responsible for writing content</p></td>
</tr>
<tr>
<td><p><code>"editor"</code></p></td>
<td><p>somebody who has provided reviews or editorial corrections</p></td>
</tr>
<tr>
<td><p><code>"copyright"</code></p></td>
<td><p>a person or entity which holds copyright on the work</p></td>
</tr>
<tr>
<td><p><code>"maintainer"</code></p></td>
<td><p>the person or entity currently responsible for the work</p></td>
</tr>
<tr>
<td><p><code>"collaborator"</code></p></td>
<td><p>somebody who has provided extensive rough information</p></td>
</tr>
<tr>
<td><p><code>"translator"</code></p></td>
<td><p>somebody who has translated the work into another language</p></td>
</tr>
<tr>
<td><p><code>"publisher"</code></p></td>
<td><p>a person or entity who distributes formatted copies</p></td>
</tr>
</table>
</item>
<item><p>The <code>credit</code> element can have attributes from external
namespaces. See <link xref="mal_external"/> for more information
on external-namespace attributes.</p></item>
</list>
</section>
<!-- END notes -->
<!-- BEGIN processing -->
<section id="processing">
<title>Processing Expectations</title>
<p>There are no specific processing expectations for the <code>credit</code>
element. As an informational element, it is not necessarily displayed. Some
tools, however, may choose to display credits at the bottom of a page, on a
separate information page, or in a dialog.</p>
<p>When processing the children of a <code>credit</code> element, tools
should select the child elements they understand and ignore all other child
content.</p>
</section>
<!-- END processing -->
<!-- BEGIN comparison -->
<section id="comparison">
<title>Comparison to Other Formats</title>
<p>The <code>credit</code> element serves the purpose of the
<code href="http://www.docbook.org/tdg/en/html/author.html">author</code>,
<code href="http://www.docbook.org/tdg/en/html/collab.html">collab</code>,
<code href="http://www.docbook.org/tdg/en/html/corpauthor.html">corpauthor</code>,
<code href="http://www.docbook.org/tdg/en/html/editor.html">editor</code>,
<code href="http://www.docbook.org/tdg/en/html/othercredit.html">othercredit</code>, and
<code href="http://www.docbook.org/tdg/en/html/publisher.html">publisher</code>
elements in DocBook. DocBook does not have specific elements for maintainers
and translators.</p>
<p>In DocBook, certain credit elements have highly structured content, whereas
others allow simple inline text. In Mallard, all credits use simple structured
content. While Mallard does not provide child elements for everything that can
be recorded in DocBook, elements from external namespaces may be used for any
additional information that is needed.</p>
<p>The <code>credit</code> element also records copyright information.
In this capacity, it is similar to the
<code href="http://www.docbook.org/tdg/en/html/copyright.html">copyright</code>
element in DocBook.</p>
</section>
<!-- END comparison -->
</page>
|
