Topic Elements

A short list of possible topic elements.

In a topic you can freely insert text. The only constraint is that the topic should be short, and should have a clear scope.

Note: The topics are ment to be reused. Make sure you write it in a context independent manner, in such way it keeps is meaning when used in other book.
There is a large number of topic elements. In this example we will use just a small fraction. For the entire set, please see the DITA specification, available online:

Images

The images can be placed inline, like the one here , or separated from the surrounding text(all images are from Wikipedia ):

Heathrow Terminal 5 building

Tables and Lists

supports CALS tables allowing very complex layouts and supporting multiple column and row spanning, but also simple tables. The simple tables are a very fast and convenient way of creating tables that have a uniform layout.

Table 1. CALS Table
Name Description Data Type Default Value Required?
frame Specifies which portion of a border should surround the element. Allowable values are:
top
Draw a line before the element
bottom
Draw a line after the element
-dita-use-​conref-​target
See Using the -dita-use-conref-target value for more information.
Threre are more possible valus, see the Data Type column.
(top | bottom | topbot | all | sides | none | -dita-use-​conref-​target) #IMPLIED No
colsep Column separator. A value of 0 indicates no separators; 1 indicates separators. NMTOKEN
rowsep Row separator. A value of 0 indicates no separators; 1 indicates separators. NMTOKEN

And now data organized in a simple table:

Type style Elements used
Bold b
Italic i
Underlined u
Note: The simple table has no title.

DITA has two basic lists: one unordered, with bullets, inspired from the HTML ul element, and an ordered list, similar to the HTML ol element.

You may use the ol element to create a sequence of operations, or to impose an order:

The cross finish results were:
  1. Ben Herman
  2. Julio Webber
  3. Jack Paul

The ul element can be used to create a list of possible values for instance:

Example title

To format an HTML document, you may use in the document either:

  • section
  • div
  • table
    • tr - To create a row
    • td - To create a cell

UI Elements

uicontrol example: Press the OK button.

wintitle example: The Configuration Options window will be closed.