DITA Flashcards
What does DITA stand for?
Darwin Information Typing Architecture
What file type organises dita topics?
Dita maps
What is the basic building block for DITA information?
The topic
What are the 3 basic DITA topic types?
Concept (what is?)
Task (how to?)
Reference (reference)
What are the 2 types of references most commonly used in DITA?
Key reference (product names, etc.) Content reference (warnings, notices, etc.)
Who created DITA and when?
IBM created DITA in 2005. It was donated to OASIS
What language is DITA based on?
XML
What provides additional information about a XML tag?
Attributes and its value
tag attribute=”value” /tag
Where are XML tags defined?
In a different file
What are called tag names in DITA?
Elements
What is the name of the 3 most common root tags in DITA?
Concept, task, reference
What is a necessary attribute for a topic tag?
id (ex: topic id=”sample”)
What element provides a 2-3 sentence summary of the topic content?
shortdesc
What element provides the title of a topic?
title
What element provides the bulk of information of a topic?
body
What are the two task types provided by DITA?
Strict task
General task
What is information about information called?
Metadata
What is a common attribute to include language of a topic?
xml:lang=”en-us”
Ex: topic id=”123” xml:lang=”en-us”
What element allows you to store metadata for the entire topic?
prolog
What is used to specify metadata on the element level?
attributes
On the map level, where do you specify the metadata of a referenced topic?
topicref
ex: topicref href=”abc.dita” audience=”novice”
What are the 3 default attribules that support filtering or conditional processing?
Audience
Product
Platform
What does a basic DITA topic require?
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
What element lets you create notes, cautions, warnings, and other admonishments
note
What are the most common list types in DITA?
unordered list ( ul) ordered list ( ol )
What are the 2 types of tables included in DITA?
Simple tables (simpletable) Tables (table)
What are the 3 possible elements in simple tables?
sthead
strow
stentry
In a ditamap, what element provides a link to a specific topic?
topicref
In a ditamap, what element provides a link to another map?
mapref
In what language are most stylesheets of the DITA Open Toolkit written in?
XSL (Extensible Stylesheet Language)
What element is used to create links from text to other locations in text, figures, tables or websites?
xref href=”target”
What is safer than using xref?
Relationship tables (reltables)
Where are reltables located?
In the map file (usually at the end)
What element is used to reuse pieces of content?
conref
What is the DOCTYPE statement used for?
To identify the topic type (ex. Concept, task, etc.)
What is the ?xml statement used for?
Identify the file as an xml file
Should the ol element be used for step-by-step instructions?
No! The Task topic should be used instead
What attribute is used by the image element to create a link to the image’s location?
href
What element is used to add a caption to an image?
fig
What element is used to give a definition?
term
What element is used for a citation?
cite
What element is used for a word or phrase that may change based on the user’s circumstances?
varname
What element is used for subscript text?
sub
What element is used for superscript text?
sup
What element is used to add a footnote?
fn
What element is used to indicate the order of a menu path?
menucascade
then uicontrol
What elements contains a definition list (a list of terms with their corresponding definition)
dl (definition list)
dlentry (definition entry)
dt (definition term)
dd (definition definition)
What element is used to write pieces of code?
codeblock
What element is used to mark a single word or phrase as code inside a p element?
codeph (codephrase)
What element is used to include a quote from an outside source?
lq (long quote)
What element is used to divide body of a topic into subsections with individual titles?
section
What element allows the creation of a comment in the DITA code that won’t be rendered in the final transformation?
draft-comment
What element allows to wrap content that is tagged incorrectly?
required-cleanup
What optional element in a task describes what the reader needs before performing the task?
prereq
What optional element in a task provides background information about the task, like its purpose, etc.
context
What are the 4 main elements of steps within a task?
steps
step
cmd
info