没有合适的资源?快使用搜索试试~ 我知道了~
资源详情
资源评论
DITA Version 1.1
Language Specification
OASIS Standard, 1 August 2007
Document identifier:
DITA_v1.1LangSpecification
Locations:
This Version:
http://docs.oasis-open.org/dita/v1.1/OS/langspec/ditaref-type.html
http://docs.oasis-open.org/dita/v1.1/OS/langspec/ditaref-type.pdf
http://docs.oasis-open.org/dita/v1.1/OS/langspec/langspec.zip (DITA source; see ditaref-type.ditamap)
Previous Version:
http://docs.oasis-open.org/dita/v1.1/CS01/langspec/ditaref-type.html
http://docs.oasis-open.org/dita/v1.1/CS01/langspec/ditaref-type.pdf
Latest Version:
http://docs.oasis-open.org/dita/v1.1/langspec/ditaref-type.html
http://docs.oasis-open.org/dita/v1.1/langspec/ditaref-type.pdf
http://docs.oasis-open.org/dita/v1.1/langspec/langspec.zip (DITA source; see ditaref-type.ditamap)
Technical Committee:
OASIS Darwin Information Typing Architecture (DITA) TC
Chair(s):
Don Day
Editor(s):
Michael Priestley
Robert D. Anderson
JoAnn Hackos
Related Work:
This specification replaces or supercedes:
OASIS DITA Version 1.0 Language Specification
This specification is related to:
OASIS DITA Version 1.1 Architectural Specification
(http://docs.oasis-open.org/dita/v1.1/OS/archspec/archspec.html)
OASIS DITA Version 1.1 DTDs (http://docs.oasis-open.org/dita/v1.1/OS/dtd/ditadtd.zip)
OASIS DITA Version 1.1 Schemas
(http://docs.oasis-open.org/dita/v1.1/OS/schema/ditaschema.zip)
Declared XML Namespace(s):
[none]
Abstract:
The DITA 1.1 Language Specification describes each element in version 1.1 of the DITA Standard.
Status:
This document was last revised or approved by the Darwin Information Typing Architecture (DITA) TC on
the above date.The level of approval is also listed above. Check the "Latest Version" or "Latest Approved
Version" location noted above for possible later revisions of this document.
Technical Committee members should send comments on this specification to the Technical Committee’ s
email list. Others should send comments to the Technical Committee by using the “Send A Comment”
button on the Technical Committee’s web page at
http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita.
Copyright © OASIS® 1993-2007. All Rights Reserved.
1 August 2007
For information on whether any patents have been disclosed that may be essential to implementing this
specification, and any offers of patent licensing terms, please refer to the Intellectual Property Rights section
of the Technical Committee web page (http://www.oasis-open.org/committees/dita/ipr.php).
The non-normative errata page for this specification is located at
http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita.
Notices
Copyright © OASIS® 1993-2007. All Rights Reserved.
All capitalized terms in the following text have the meanings assigned to them in the OASIS Intellectual
Property Rights Policy (the "OASIS IPR Policy"). The full Policy may be found at the OASIS website.
This document and translations of it may be copied and furnished to others, and derivative works that
comment on or otherwise explain it or assist in its implementation may be prepared, copied, published,
and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice
and this section are included on all such copies and derivative works. However, this document itself may
not be modified in any way, including by removing the copyright notice or references to OASIS, except as
needed for the purpose of developing any document or deliverable produced by an OASIS Technical
Committee (in which case the rules applicable to copyrights, as set forth in the OASIS IPR Policy, must
be followed) or as required to translate it into languages other than English.
The limited permissions granted above are perpetual and will not be revoked by OASIS or its successors
or assigns.
This document and the information contained herein is provided on an "AS IS" basis and OASIS DISCLAIMS
ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY
THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS
OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
OASIS requests that any OASIS Party or any other party that believes it has patent claims that would
necessarily be infringed by implementations of this OASIS Committee Specification or OASIS Standard,
to notify OASIS TC Administrator and provide an indication of its willingness to grant patent licenses to
such patent claims in a manner consistent with the IPR Mode of the OASIS Technical Committee that
produced this specification. OASIS invites any party to contact the OASIS TC Administrator if it is aware
of a claim of ownership of any patent claims that would necessarily be infringed by implementations of this
specification by a patent holder that is not willing to provide a license to such patent claims in a manner
consistent with the IPR Mode of the OASIS Technical Committee that produced this specification. OASIS
may include such claims on its website, but disclaims any obligation to do so. OASIS takes no position
regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain
to the implementation or use of the technology described in this document or the extent to which any license
under such rights might or might not be available; neither does it represent that it has made any effort to
identify any such rights. Information on OASIS' procedures with respect to rights in any document or
deliverable produced by an OASIS Technical Committee can be found on the OASIS website. Copies of
claims of rights made available for publication and any assurances of licenses to be made available, or
the result of an attempt made to obtain a general license or permission for the use of such proprietary
rights by implementers or users of this OASIS Committee Specification or OASIS Standard, can be obtained
from the OASIS TC Administrator. OASIS makes no representation that any information or list of intellectual
property rights will at any time be complete, or that any claims in such list are, in fact, Essential Claims.
The name "OASIS" is a trademark of OASIS, the owner and developer of this specification, and should be
used only to refer to the organization and its official outputs. OASIS welcomes reference to, and
implementation and use of, specifications, while reserving the right to enforce its marks against misleading
uses. Please see http://www.oasis-open.org/who/trademark.php for above guidance.
2 | OpenTopic | Preface
Copyright © OASIS® 1993-2007. All Rights Reserved.
1 August 2007
Contents
Chapter 1. Introduction . . . . . . . .1
Chapter 2. Topic elements . . . . . . .3
topic . . . . . . . . . . . . . . . . .3
title . . . . . . . . . . . . . . . . .5
titlealts . . . . . . . . . . . . . . . .6
navtitle . . . . . . . . . . . . . . . .7
searchtitle . . . . . . . . . . . . . . .8
abstract . . . . . . . . . . . . . . . .9
shortdesc . . . . . . . . . . . . . . .11
body . . . . . . . . . . . . . . . .13
section . . . . . . . . . . . . . . . .14
example . . . . . . . . . . . . . . .15
related-links . . . . . . . . . . . . . .16
Chapter 3. Concept elements . . . . .19
concept . . . . . . . . . . . . . . . .19
conbody . . . . . . . . . . . . . . .20
Chapter 4. Reference elements . . . .23
reference . . . . . . . . . . . . . . .23
refbody . . . . . . . . . . . . . . . .24
refsyn . . . . . . . . . . . . . . . .25
properties . . . . . . . . . . . . . . .26
prophead . . . . . . . . . . . . . . .28
proptypehd . . . . . . . . . . . . . .29
propvaluehd . . . . . . . . . . . . . .29
propdeschd . . . . . . . . . . . . . .30
property . . . . . . . . . . . . . . .31
proptype . . . . . . . . . . . . . . .32
propvalue . . . . . . . . . . . . . . .33
propdesc . . . . . . . . . . . . . . .34
Chapter 5. Task elements . . . . . . .37
task . . . . . . . . . . . . . . . . .37
taskbody . . . . . . . . . . . . . . .38
prereq . . . . . . . . . . . . . . . .39
context . . . . . . . . . . . . . . . .40
steps . . . . . . . . . . . . . . . .41
steps-unordered . . . . . . . . . . . . .42
step . . . . . . . . . . . . . . . . .43
cmd . . . . . . . . . . . . . . . . .46
info . . . . . . . . . . . . . . . . .47
substeps . . . . . . . . . . . . . . .47
substep . . . . . . . . . . . . . . . .48
stepxmp . . . . . . . . . . . . . . .51
choicetable . . . . . . . . . . . . . .52
chhead . . . . . . . . . . . . . . . .53
choptionhd . . . . . . . . . . . . . .54
chdeschd . . . . . . . . . . . . . . .55
chrow . . . . . . . . . . . . . . . .56
choption . . . . . . . . . . . . . . .57
chdesc . . . . . . . . . . . . . . . .58
choices . . . . . . . . . . . . . . . .59
choice . . . . . . . . . . . . . . . .60
stepresult . . . . . . . . . . . . . . .61
tutorialinfo . . . . . . . . . . . . . .62
result . . . . . . . . . . . . . . . .63
postreq . . . . . . . . . . . . . . . .64
Chapter 6. Glossentry elements . . . .67
glossentry . . . . . . . . . . . . . . .67
glossdef . . . . . . . . . . . . . . .68
glossterm . . . . . . . . . . . . . . .69
Chapter 7. Body elements . . . . . .71
p . . . . . . . . . . . . . . . . . .71
note . . . . . . . . . . . . . . . . .72
ph . . . . . . . . . . . . . . . . .74
keyword . . . . . . . . . . . . . . .75
xref . . . . . . . . . . . . . . . . .77
ol . . . . . . . . . . . . . . . . . .80
ul . . . . . . . . . . . . . . . . . .82
li . . . . . . . . . . . . . . . . . .83
sl . . . . . . . . . . . . . . . . . .84
sli . . . . . . . . . . . . . . . . .86
dl . . . . . . . . . . . . . . . . . .87
dlhead . . . . . . . . . . . . . . . .89
dthd . . . . . . . . . . . . . . . . .90
ddhd . . . . . . . . . . . . . . . .91
dlentry . . . . . . . . . . . . . . . .92
dt . . . . . . . . . . . . . . . . .93
dd . . . . . . . . . . . . . . . . .94
fig . . . . . . . . . . . . . . . . .95
figgroup . . . . . . . . . . . . . . .96
desc . . . . . . . . . . . . . . . . .97
image . . . . . . . . . . . . . . . .98
alt . . . . . . . . . . . . . . . . . 101
object . . . . . . . . . . . . . . . . 102
param . . . . . . . . . . . . . . . . 106
pre . . . . . . . . . . . . . . . . . 107
lines . . . . . . . . . . . . . . . . 109
cite . . . . . . . . . . . . . . . . .110
lq . . . . . . . . . . . . . . . . . 111
q . . . . . . . . . . . . . . . . .113
Chapter 8. Table elements . . . . . .115
table . . . . . . . . . . . . . . . .115
tgroup . . . . . . . . . . . . . . . .118
colspec . . . . . . . . . . . . . . . 120
thead . . . . . . . . . . . . . . . . 122
tbody . . . . . . . . . . . . . . . . 124
row . . . . . . . . . . . . . . . . 125
entry . . . . . . . . . . . . . . . . 126
simpletable . . . . . . . . . . . . . . 129
sthead . . . . . . . . . . . . . . . . 131
strow . . . . . . . . . . . . . . . . 132
stentry . . . . . . . . . . . . . . . 133
iii
Copyright © OASIS® 1993-2007. All Rights Reserved.
1 August 2007
Chapter 9. Prolog elements . . . . . 135
prolog . . . . . . . . . . . . . . . . 135
audience . . . . . . . . . . . . . . . 136
author . . . . . . . . . . . . . . . . 138
brand . . . . . . . . . . . . . . . . 140
category . . . . . . . . . . . . . . . 141
component . . . . . . . . . . . . . . 142
copyright . . . . . . . . . . . . . . . 143
copyrholder . . . . . . . . . . . . . . 144
copyryear . . . . . . . . . . . . . . 145
created . . . . . . . . . . . . . . . 146
critdates . . . . . . . . . . . . . . . 147
featnum . . . . . . . . . . . . . . . 148
keywords . . . . . . . . . . . . . . . 149
metadata . . . . . . . . . . . . . . . 151
othermeta . . . . . . . . . . . . . . 152
permissions . . . . . . . . . . . . . . 153
platform . . . . . . . . . . . . . . . 154
prodinfo . . . . . . . . . . . . . . . 155
prodname . . . . . . . . . . . . . . 156
prognum . . . . . . . . . . . . . . . 157
publisher . . . . . . . . . . . . . . . 158
resourceid . . . . . . . . . . . . . . 160
revised . . . . . . . . . . . . . . . 161
series . . . . . . . . . . . . . . . . 162
source . . . . . . . . . . . . . . . . 163
vrmlist . . . . . . . . . . . . . . . 164
vrm . . . . . . . . . . . . . . . . 165
Chapter 10. Related links elements 167
link . . . . . . . . . . . . . . . . . 167
linklist . . . . . . . . . . . . . . . . 169
linkpool . . . . . . . . . . . . . . . 172
linktext . . . . . . . . . . . . . . . 175
linkinfo . . . . . . . . . . . . . . . 176
Chapter 11. Miscellaneous elements 179
dita . . . . . . . . . . . . . . . . . 179
draft-comment . . . . . . . . . . . . . 180
fn . . . . . . . . . . . . . . . . . 182
indexterm . . . . . . . . . . . . . . 184
indextermref . . . . . . . . . . . . . . 187
index-base . . . . . . . . . . . . . . 188
tm . . . . . . . . . . . . . . . . . 189
data-about . . . . . . . . . . . . . . 191
data . . . . . . . . . . . . . . . . 194
foreign . . . . . . . . . . . . . . . 198
unknown . . . . . . . . . . . . . . . 200
Chapter 12. Specialization elements 203
itemgroup . . . . . . . . . . . . . . 203
no-topic-nesting . . . . . . . . . . . . 204
required-cleanup . . . . . . . . . . . . 205
state . . . . . . . . . . . . . . . . 207
term . . . . . . . . . . . . . . . . 208
boolean . . . . . . . . . . . . . . . 210
Chapter 13. Typographic elements 213
b . . . . . . . . . . . . . . . . . 213
i . . . . . . . . . . . . . . . . . . 214
u . . . . . . . . . . . . . . . . . 215
tt . . . . . . . . . . . . . . . . . 216
sup . . . . . . . . . . . . . . . . . 218
sub . . . . . . . . . . . . . . . . . 219
Chapter 14. Programming elements 221
apiname . . . . . . . . . . . . . . . 221
codeblock . . . . . . . . . . . . . . 222
codeph . . . . . . . . . . . . . . . 224
option . . . . . . . . . . . . . . . . 225
parmname . . . . . . . . . . . . . . 226
parml . . . . . . . . . . . . . . . . 228
plentry . . . . . . . . . . . . . . . 230
pt . . . . . . . . . . . . . . . . . 231
pd . . . . . . . . . . . . . . . . . 232
synph . . . . . . . . . . . . . . . . 233
syntaxdiagram . . . . . . . . . . . . . 234
groupseq . . . . . . . . . . . . . . . 236
groupchoice . . . . . . . . . . . . . . 238
groupcomp . . . . . . . . . . . . . . 241
fragment . . . . . . . . . . . . . . . 244
fragref . . . . . . . . . . . . . . . . 245
synblk . . . . . . . . . . . . . . . . 249
synnote . . . . . . . . . . . . . . . 250
synnoteref . . . . . . . . . . . . . . 251
kwd . . . . . . . . . . . . . . . . 252
var . . . . . . . . . . . . . . . . . 255
oper . . . . . . . . . . . . . . . . 257
delim . . . . . . . . . . . . . . . . 260
sep . . . . . . . . . . . . . . . . . 263
repsep . . . . . . . . . . . . . . . . 266
Chapter 15. Software elements . . . . 269
msgph . . . . . . . . . . . . . . . . 269
msgblock . . . . . . . . . . . . . . . 270
msgnum . . . . . . . . . . . . . . . 271
cmdname . . . . . . . . . . . . . . . 273
varname . . . . . . . . . . . . . . . 274
filepath . . . . . . . . . . . . . . . 276
userinput . . . . . . . . . . . . . . . 277
systemoutput . . . . . . . . . . . . . 279
Chapter 16. User interface elements 281
uicontrol . . . . . . . . . . . . . . . 281
wintitle . . . . . . . . . . . . . . . 282
menucascade . . . . . . . . . . . . . 284
shortcut . . . . . . . . . . . . . . . 285
screen . . . . . . . . . . . . . . . . 286
Chapter 17. Utilities elements . . . . 289
imagemap . . . . . . . . . . . . . . 289
area . . . . . . . . . . . . . . . . 291
coords . . . . . . . . . . . . . . . . 292
shape . . . . . . . . . . . . . . . . 294
Chapter 18. Indexing group elements 297
index-see . . . . . . . . . . . . . . . 297
index-see-also . . . . . . . . . . . . . 298
index-sort-as . . . . . . . . . . . . . 300
iv DITA Language Specification v1.1
Copyright © OASIS® 1993-2007. All Rights Reserved.
1 August 2007
Chapter 19. Map elements . . . . . . 303
map . . . . . . . . . . . . . . . . 303
anchor . . . . . . . . . . . . . . . . 305
navref . . . . . . . . . . . . . . . . 306
reltable . . . . . . . . . . . . . . . 307
relrow . . . . . . . . . . . . . . . . 309
relcell . . . . . . . . . . . . . . . . 310
relheader . . . . . . . . . . . . . . .311
relcolspec . . . . . . . . . . . . . . . 312
topicmeta . . . . . . . . . . . . . . . 313
topicref . . . . . . . . . . . . . . . 314
Chapter 20. Map group elements . . . 317
topicgroup . . . . . . . . . . . . . . 317
topichead . . . . . . . . . . . . . . . 318
Chapter 21. Bookmap content
elements . . . . . . . . . . . . . 321
bookmap . . . . . . . . . . . . . . . 321
abbrevlist . . . . . . . . . . . . . . . 322
amendments . . . . . . . . . . . . . . 324
appendix . . . . . . . . . . . . . . . 325
backmatter . . . . . . . . . . . . . . 327
bibliolist . . . . . . . . . . . . . . . 328
bookabstract . . . . . . . . . . . . . . 329
booklibrary . . . . . . . . . . . . . . 331
booklist . . . . . . . . . . . . . . . 331
booklists . . . . . . . . . . . . . . . 332
booktitle . . . . . . . . . . . . . . . 333
booktitlealt . . . . . . . . . . . . . . 334
chapter . . . . . . . . . . . . . . . 334
colophon . . . . . . . . . . . . . . . 336
dedication . . . . . . . . . . . . . . 338
draftintro . . . . . . . . . . . . . . . 339
figurelist . . . . . . . . . . . . . . . 341
frontmatter . . . . . . . . . . . . . . 342
glossarylist . . . . . . . . . . . . . . 343
indexlist . . . . . . . . . . . . . . . 344
mainbooktitle . . . . . . . . . . . . . 346
notices . . . . . . . . . . . . . . . 346
part . . . . . . . . . . . . . . . . 348
preface . . . . . . . . . . . . . . . 350
tablelist . . . . . . . . . . . . . . . 351
toc . . . . . . . . . . . . . . . . . 353
trademarklist . . . . . . . . . . . . . 354
Chapter 22. Bookmap metadata
elements . . . . . . . . . . . . . 357
bookmeta . . . . . . . . . . . . . . . 357
approved . . . . . . . . . . . . . . . 358
bookchangehistory . . . . . . . . . . . 360
bookevent . . . . . . . . . . . . . . 362
bookeventtype . . . . . . . . . . . . . 364
bookid . . . . . . . . . . . . . . . 366
booknumber . . . . . . . . . . . . . . 368
bookowner . . . . . . . . . . . . . . 370
bookpartno . . . . . . . . . . . . . . 372
bookrestriction . . . . . . . . . . . . . 374
bookrights . . . . . . . . . . . . . . 376
completed . . . . . . . . . . . . . . 378
copyrfirst . . . . . . . . . . . . . . . 379
copyrlast . . . . . . . . . . . . . . . 381
day . . . . . . . . . . . . . . . . . 383
edited . . . . . . . . . . . . . . . . 383
edition . . . . . . . . . . . . . . . 385
isbn . . . . . . . . . . . . . . . . 387
maintainer . . . . . . . . . . . . . . 389
month . . . . . . . . . . . . . . . . 391
organization . . . . . . . . . . . . . . 392
person . . . . . . . . . . . . . . . . 394
printlocation . . . . . . . . . . . . . . 396
published . . . . . . . . . . . . . . 398
publisherinformation . . . . . . . . . . . 400
publishtype . . . . . . . . . . . . . . 401
reviewed . . . . . . . . . . . . . . . 403
revisionid . . . . . . . . . . . . . . 405
started . . . . . . . . . . . . . . . . 405
summary . . . . . . . . . . . . . . . 406
tested . . . . . . . . . . . . . . . . 407
volume . . . . . . . . . . . . . . . 409
year . . . . . . . . . . . . . . . .411
Chapter 23. xNAL domain elements 413
xNAL usage guidelines . . . . . . . . . . 413
authorinformation . . . . . . . . . . . . 415
addressdetails . . . . . . . . . . . . . 417
administrativearea . . . . . . . . . . . . 418
contactnumber . . . . . . . . . . . . . 418
contactnumbers . . . . . . . . . . . . 421
country . . . . . . . . . . . . . . . 423
emailaddress . . . . . . . . . . . . . 423
emailaddresses . . . . . . . . . . . . . 426
firstname . . . . . . . . . . . . . . . 428
generationidentifier . . . . . . . . . . . 430
honorific . . . . . . . . . . . . . . . 432
lastname . . . . . . . . . . . . . . . 434
locality . . . . . . . . . . . . . . . 436
localityname . . . . . . . . . . . . . . 436
middlename . . . . . . . . . . . . . . 437
namedetails . . . . . . . . . . . . . . 439
organizationinfo . . . . . . . . . . . . 441
organizationname . . . . . . . . . . . . 443
organizationnamedetails . . . . . . . . . . 444
otherinfo . . . . . . . . . . . . . . . 445
personinfo . . . . . . . . . . . . . . 447
personname . . . . . . . . . . . . . . 449
postalcode . . . . . . . . . . . . . . 451
thoroughfare . . . . . . . . . . . . . 452
url . . . . . . . . . . . . . . . . . 453
urls . . . . . . . . . . . . . . . . . 455
Chapter 24. DITAVAL elements . . . . 459
val . . . . . . . . . . . . . . . . . 459
style-conflict . . . . . . . . . . . . . . 459
prop . . . . . . . . . . . . . . . . 460
revprop . . . . . . . . . . . . . . . 462
startflag . . . . . . . . . . . . . . . 463
endflag . . . . . . . . . . . . . . . 464
alt-text . . . . . . . . . . . . . . . 464
Contents v
Copyright © OASIS® 1993-2007. All Rights Reserved.
1 August 2007
剩余499页未读,继续阅读
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功
评论1
最新资源