DITA Flashcards

1
Q

What does DITA stand for?

A

Darwin Information Typing Architecture

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
2
Q

What file type organises dita topics?

A

Dita maps

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
3
Q

What is the basic building block for DITA information?

A

The topic

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
4
Q

What are the 3 basic DITA topic types?

A

Concept (what is?)
Task (how to?)
Reference (reference)

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
5
Q

What are the 2 types of references most commonly used in DITA?

A
Key reference (product names, etc.)
Content reference (warnings, notices, etc.)
How well did you know this?
1
Not at all
2
3
4
5
Perfectly
6
Q

Who created DITA and when?

A

IBM created DITA in 2005. It was donated to OASIS

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
7
Q

What language is DITA based on?

A

XML

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
8
Q

What provides additional information about a XML tag?

A

Attributes and its value

tag attribute=”value” /tag

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
9
Q

Where are XML tags defined?

A

In a different file

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
10
Q

What are called tag names in DITA?

A

Elements

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
11
Q

What is the name of the 3 most common root tags in DITA?

A

Concept, task, reference

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
12
Q

What is a necessary attribute for a topic tag?

A

id (ex: topic id=”sample”)

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
13
Q

What element provides a 2-3 sentence summary of the topic content?

A

shortdesc

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
14
Q

What element provides the title of a topic?

A

title

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
15
Q

What element provides the bulk of information of a topic?

A

body

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
16
Q

What are the two task types provided by DITA?

A

Strict task

General task

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
17
Q

What is information about information called?

A

Metadata

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
18
Q

What is a common attribute to include language of a topic?

A

xml:lang=”en-us”
Ex: topic id=”123” xml:lang=”en-us”

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
19
Q

What element allows you to store metadata for the entire topic?

A

prolog

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
20
Q

What is used to specify metadata on the element level?

A

attributes

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
21
Q

On the map level, where do you specify the metadata of a referenced topic?

A

topicref

ex: topicref href=”abc.dita” audience=”novice”

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
22
Q

What are the 3 default attribules that support filtering or conditional processing?

A

Audience
Product
Platform

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
23
Q

What does a basic DITA topic require?

A

XML declaration (?xml version=”1.0” encoding=”UTF-8”?)
DOCTYPE declaration !DOCTYPE topic PUBLIC “-//OASIS//DTD DITA Topic//EN” “topic.dtd”
A topic topic id=”myfirsttopic”
id attribute on the topic id=”myfirsttopic”
Title title Hello world /title

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
24
Q

What element lets you create notes, cautions, warnings, and other admonishments

A

note

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
25
Q

What are the most common list types in DITA?

A
unordered list ( ul)
ordered list ( ol )
How well did you know this?
1
Not at all
2
3
4
5
Perfectly
26
Q

What are the 2 types of tables included in DITA?

A
Simple tables (simpletable)
Tables (table)
How well did you know this?
1
Not at all
2
3
4
5
Perfectly
27
Q

What are the 3 possible elements in simple tables?

A

sthead
strow
stentry

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
28
Q

In a ditamap, what element provides a link to a specific topic?

A

topicref

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
29
Q

In a ditamap, what element provides a link to another map?

A

mapref

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
30
Q

In what language are most stylesheets of the DITA Open Toolkit written in?

A

XSL (Extensible Stylesheet Language)

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
31
Q

What element is used to create links from text to other locations in text, figures, tables or websites?

A

xref href=”target”

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
32
Q

What is safer than using xref?

A

Relationship tables (reltables)

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
33
Q

Where are reltables located?

A

In the map file (usually at the end)

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
34
Q

What element is used to reuse pieces of content?

A

conref

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
35
Q

What is the DOCTYPE statement used for?

A

To identify the topic type (ex. Concept, task, etc.)

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
36
Q

What is the ?xml statement used for?

A

Identify the file as an xml file

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
37
Q

Should the ol element be used for step-by-step instructions?

A

No! The Task topic should be used instead

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
38
Q

What attribute is used by the image element to create a link to the image’s location?

A

href

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
39
Q

What element is used to add a caption to an image?

A

fig

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
40
Q

What element is used to give a definition?

A

term

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
41
Q

What element is used for a citation?

A

cite

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
42
Q

What element is used for a word or phrase that may change based on the user’s circumstances?

A

varname

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
43
Q

What element is used for subscript text?

A

sub

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
44
Q

What element is used for superscript text?

A

sup

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
45
Q

What element is used to add a footnote?

A

fn

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
46
Q

What element is used to indicate the order of a menu path?

A

menucascade

then uicontrol

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
47
Q

What elements contains a definition list (a list of terms with their corresponding definition)

A

dl (definition list)
dlentry (definition entry)
dt (definition term)
dd (definition definition)

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
48
Q

What element is used to write pieces of code?

A

codeblock

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
49
Q

What element is used to mark a single word or phrase as code inside a p element?

A

codeph (codephrase)

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
50
Q

What element is used to include a quote from an outside source?

A

lq (long quote)

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
51
Q

What element is used to divide body of a topic into subsections with individual titles?

A

section

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
52
Q

What element allows the creation of a comment in the DITA code that won’t be rendered in the final transformation?

A

draft-comment

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
53
Q

What element allows to wrap content that is tagged incorrectly?

A

required-cleanup

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
54
Q

What optional element in a task describes what the reader needs before performing the task?

A

prereq

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
55
Q

What optional element in a task provides background information about the task, like its purpose, etc.

A

context

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
56
Q

What are the 4 main elements of steps within a task?

A

steps
step
cmd
info

How well did you know this?
1
Not at all
2
3
4
5
Perfectly
57
Q

What is an essential element of a step?

A

cmd

58
Q

What is an optional element of a step?

A

info

59
Q

What type of voice should be used in a cmd element?

A

Active voice

60
Q

What do strict tasks only allow a single steps tag?

A

To ensure that the topic only describes how to perform one task

61
Q

How many sentences should a cmd tag have in order to follow best practices?

A

One

62
Q

In a task, how many info tags can be added after a cmd element?

A

Any number

63
Q

What elements can be used when listing choices to the reader?

A

choices

choicetable

64
Q

What element is used to add more detail to a step?

A

substeps

65
Q

What element can be used to give step examples on how to perform a step in a task topic?

A

stepxmp

66
Q

What element is used to describe the result of a step?

A

stepresult

67
Q

What element is used to add comments between two steps in a task topic?

A

stepsection

68
Q

What two elements can be used to add admonitions to the reader before a cmd element of a step in a task?

A

note

hazardstatement

69
Q

What element is used to describe a completed task?

A

result

70
Q

What element is used to show an example of an entire task?

A

example

71
Q

What element tells you what to do once a task is completed?

A

postreq (postrequisites)

72
Q

To what question do Reference topics answer?

A

What?

73
Q

To what question does the Concept topic answer?

A

Why?

74
Q

To what question does the Task topic answer?

A

How?

75
Q

What 2 refbody elements are specific to the reference topic?

A

refsyn

properties

76
Q

What element denotes the name of a command when referenced as a part of software?

A

cmdname

77
Q

In the Reference topic type, what element used for code syntax is a specialization of the section element

A

refsyn

78
Q

What elements are the preferred way to show syntax diagrams in the refsyn element?

A

synph (syntax phrase)

syntaxdiagram

79
Q

What are the 4 most common sub-elements of the properties element?

A

property
proptype
propvalue
propdesc

80
Q

The properties element is a specialization of what element?

A

simpletable

81
Q

How do you call an element related to a specific field (like programming, etc)?

A

domain element

82
Q

What topic type should be used to define a specific term or concept contained within your content?

A

Glossary entry topic

83
Q

How do you call a file with multiple glossary entry topics?

A

glossary group

84
Q

What is the root element of a glossary entry topic?

A

glossentry

85
Q

What element is a glossterm a specialization of?

A

title

86
Q

It is best practice to add what before the filename of a glossary entry?

A

g_

87
Q

Where is it better to gather all glossary topics?

A

in a dita map file

88
Q

What element is used to add a topic inside a map?

A

topicref

89
Q

Where should maps be stored on your file system?

A

At the top level, since topicrefs cannot link to topics located above the map level.

90
Q

What is the difference between a map and a bookmap?

A

Bookmaps provide elements to create book-like structures. (chapters, appendices, parts)

91
Q

When is it generally preferable to use bookmaps instead of maps?

A

When your content is in print or PDF form.

92
Q

What is the bookmap’s frontmatter element typically used for?

A

table of contents or preface

93
Q

What is the bookmap’s backmatter element typically used for?

A

index or glossary

94
Q

How many bookmap chapters can be nested inside bookmap chapters?

A

0

95
Q

What element is used to add metadata to maps?

A

topicmeta

96
Q

Which metadata takes precedence over the other, a topic metadata defined in a map’s topicref, or the referenced’ topic file’s metadata (e.g., prolog)?

A

The metadata defined in a map’s topicref

97
Q

What frontmatter and backmatter element can be used for toc, indexlist or glossarylist?

A

booklists

98
Q

What element inside the booklists element of a bookmap is used to say where to generate a table of contents?

A

toc

99
Q

What bookmap element is used to generate an index at that location within the map?

A

indexlist

100
Q

What element of a bookmap is used to change the title of a reused topic?

A

navtitle

101
Q

What attribute of topicref in a bookmap should you change in order to use the navtitle element?

A

locktitle=”yes”

102
Q

Why is the topichead element useful?

A

It helps you group topics together that are contextually related without implying a hierachical relationship

103
Q

In what element can you find a reltable?

A

map or bookmap

104
Q

Where are reltables located inside a map?

A

at the very end, just before the map or bookmap closing tag

105
Q

In a reltable, what relcell attribute can be used to make the reltable cell topics relate one another?

A

collection-type=”family”

106
Q

What attribute of a topicref in a reltable makes this topic only the target of other topics (i.e., you can have a link to topic B, but topic B will not have any links to other topics)

A

linking=”targetonly”

107
Q

What attribute of a topicref in a reltable prevents this topic from being a target for other topics?

A

linking=”sourceonly”

108
Q

How do you override the link types of recolspecs in reltables?

A

by adding a title tag in the relcospec element

109
Q

What are the different reuse facilities offered by DITA?

A

topics and maps
fragments (conref)
variables (keys)
filtering (conditions)

110
Q

What type of reuse involves pulling shared pieces of content, usually elements?

A

Fragment (conrefs)

111
Q

What type of reuse is best suited for company names, product names, URLs, or filenames?

A

Variables (keys)

112
Q

What type of reuse is best suited to selectively remove certain pieces of content, based on different conditions, to create product- or customer-specific deliverables?

A

Filtering (conditions)

113
Q

What attribute do you need to use when you reuse a topic multiple times in a single map?

A

copy-to=”first_copy.dita”

copy-to=”second_copy.dita

114
Q

What element could be the best example of a reusable element using a conref?

A

note

115
Q

What are the two parts of a conref?

A

a referenced element

a referencing element

116
Q

What attribute is necessary for conref referenced elements?

A

ID

117
Q

What are the four basic conditional attributes used for content filtering?

A

audience
platform
product
otherprops (custom aspect)

118
Q

How do you specify multiple values in attributes for content filtering?

A

use space

119
Q

What file is used to indicate which attributes and values to filter out of your content?

A

ditaval files

120
Q

In DITA 1.3, what element within a map is used to include a ditaval file?

A

ditavalref

121
Q

What is the root element of a ditaval file?

A

val

122
Q

What is the main child element of a val tag?

A

prop (prop att=”platform” val=”iphone” action=”exclude” /)

123
Q

In a ditaval file, what element can be used to add images bofore and after a flagged element?

A

startflag

endflag

124
Q

Where is the final value for a key defined?

A

In a DITA map

125
Q

What element defines keys in a ditamap?

A

keydef

126
Q

What attribute references a key?

A

keyref
ex: image keyref=”product_image”/
ph keyref=”product_name”/

127
Q

What elements must you nest inside a keydef that will contain a text string?

A

keydef
topicmeta
keywords
keyword

128
Q

What 3 elements can reference a string of text?

A

ph
term
keyword

129
Q

What content reference element uses a key instead of a file path?

A

conkeyref

130
Q

How do you call folders and files containing topics and maps destined to be reused?

A

Warehouses

131
Q

What element is used to pull a sequence of two or more elements into a topic?

A

conrefend and conref

132
Q

What conref attribute allows you to “push” content into a topic of the same map?

A

conaction=”pushreplace”
conaction=”pushbefore”
conaction=”pushafter”

133
Q

What attribute of a topicref in a map should be used to avoid displaying a specific topic?

A

processing-role=”resource-only”

134
Q

What is the difference between a conref and a conkeyref attribute?

A

conref references an element’s id

conkeyref references an element’s key

135
Q

Why should you use a conkeyref?

A

They make your topic reusable

136
Q

What does CCMS stand for?

A

Component Content Management System

137
Q

What is DITA’s open source publishing tool?

A

DITA OT

138
Q

What can be used to change the Look-and-feel of default DITA-OT publishes?

A

Custom plugins

139
Q

What knowledge is required to customize or update custom plugins?

A

Ant, XSL and DTD for the base

XHTML, JavaScript and XSL-FO for the output

140
Q

What document type can be used to simply change the output style?

A

CSS