Adding tables to a concept topic

Use the <table> element when you need to create a larger or more complex table than you can with the <simpletable> element. If you need a caption for your table, or more than one header row, use the <table> element.

The elements contained in the <table> element include:

<title>	The container element for the text of a <table> element’s title or caption. A <table> element can only contain one <title> element.
<tgroup>	The container element for the main content of a <table> element. The <tgroup> element contains the <colspec>, <thead>, and <tbody> elements. A <table> element can contain one or more <tgroup> elements.
<colspec>	The element that provides information about the columns in a <table> element. The column specifications are defined using the colname (the name of the column), colnum (the order in which the column appears), and colwidth (the relative width of the column) attributes.
<thead>	The container element for the header in a <table> element. The <thead> element can contain one or more <row> elements and is optional.
<tbody>	The container element for the body rows in a <table> element. The <tbody> element can contain one or more <row> elements.
<row>	The container element for a row of cells in a <table> element. The <row> element contains one or more <entry> elements.
<entry>	The container element for a single cell in a <table> element. The <entry> element contains the text of a cell in the <table> element, which should be wrapped in a <p> element according to best practice.

This lesson will cover the basics of using the <table> element. To highlight the differences between the <table> and <simpletable> elements, you will be using the same sample content for your <table> exercise as you used for your <simpletable> exercise.

Continue using the file lesson2/l_concept_images_tables_start.dita to add the <table> element.

Note:

If you are using a DITA editor, some child elements of the <table> element will automatically be inserted as you work through the examples.

Video: Creating a table in DITA

Note:

This video shows an alternative way to create a table in DITA using the oXygen XML Editor table wizard. The exercises show you how to create a table using DITA code.

Practice

After the <simpletable> element, add a <table> element as shown in the following example:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA 2.x Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
   <title>Duckling growth and development</title>
  <conbody>
...
</simpletable>
<table>
</table>
   </conbody>
</concept>

Inside the <table> element, add a <title> element and add content to it as shown in the following example:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA 2.x Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
   <title>Duckling growth and development</title>
  <conbody>
...
<table>
<title>Typical development of mallard ducks</title>
</table>
</conbody>
</concept>

The <title> element is optional, but it allows you to add context to your table, just as it does for images when used inside the <fig> element.

After the <title> element, add the <tgroup> element as shown in the following example:
```
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA 2.x Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
   <title>Duckling growth and development</title>
   <conbody>
...
<title>Typical development of mallard ducks</title>
<tgroup cols="2">
</tgroup>
...
</conbody>
</concept>
```
The <tgroup> element contains the body of the table. The number of table columns is set inside the <tgroup> element using the cols attribute. In the example you added, cols=”2″ shows that this table will contain two columns.

A single <table> element can contain more than one <tgroup> element, which is useful if you need to show more than one table with different headers or numbers of columns under the same title.
Inside the <tgroup> element, add two <colspec> elements and add content to them as shown in the following example:
```
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA 2.x Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
   <title>Duckling growth and development</title>
   <conbody>
...
<tgroup cols="2">
<colspec colname="c1" colnum="1" colwidth="1.0*"/>
<colspec colname="c2" colnum="2" colwidth="1.0*"/>
...
</conbody>
</concept>
```
The <colspec> element sets up your table columns and specifies information about them (such as their names, sequence, and widths) using attributes. In the example you added, the colname attribute was used to name your columns “c1” and “c2” and the colnum attribute was used to designate the order in which these columns appear.

The optional colwidth attribute can be used to control the proportions of the column widths. In the example you added, the colwidth attribute is the same for each column, meaning that they will display at equal widths.
After the last <colspec> element, add the <thead> element as shown in the following example:
```
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA 2.x Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
   <title>Duckling growth and development</title>
   <conbody>
...
<colspec colname="c2" colnum="2" colwidth="1.0*"/>
<thead>
</thead>
...
</conbody>
</concept>
```
The <thead> element contains the elements associated with the table header. Unlike the <sthead> element in a <simpletable> element, the <thead> element in a <table> element can contain more than one header row.

Inside the <thead> element, add the <row> element as shown in the following example:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA 2.x Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
   <title>Duckling growth and development</title>
   <conbody>
...
<thead>
 <row>
</row>
...
</concept>

The <row> element contains the elements associated with a table row.

Inside the <row> element, add two <entry> elements and add content to them as shown in the following example:
```
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA 2.x Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
   <title>Duckling growth and development</title>
  <conbody>
...
<row>
<entry><p>Age</p></entry>
<entry><p>Milestone</p></entry>
...
</concept>
```
Each <entry> element corresponds to a single table cell in a row. In the example you added, each <entry> element follows the best practice of wrapping a <p> element surrounding the text.
After the <thead> element, add the <tbody> element as shown in the following example:
```
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA 2.x Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
   <title>Duckling growth and development</title>
  <conbody>
...
</thead>
<tbody>
</tbody>
...
</conbody>
</concept>
```
The <tbody> element is for the main body of the table. Following the same structure as the <thead> element, the <tbody> element can contain <row> elements with <entry> elements inside them.

Inside the <tbody> element, add a <row> element and add content to it with <entry> elements and their containing text as shown in the following example:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA 2.x Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
   <title>Duckling growth and development</title>
  <conbody>
...
<tbody>
<row>
<entry><p>7 weeks</p></entry>
<entry><p>Attempt flight for the first time</p></entry>
</row>
...
</concept>

After the <row> element you just added, add two more rows and add content to them as shown in the following example:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA 2.x Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
   <title>Duckling growth and development</title>
   <conbody>
...
</row>
<row>
<entry><p>12-14 weeks</p></entry>
<entry><p>Reach adult body weight</p></entry>
</row>
<row>
<entry><p>1 year</p></entry>
<entry><p>Capable of reproduction</p></entry>
</row>
...
</concept>

The <tbody> element can contain one or more <row> elements.

Video: Creating a table in DITA

Check your file lesson2/l_concept_images_tables_start.dita against the sample file lesson2/l_concept_images_tables.dita.

Practice

Open the file lesson2/l_concept_images_tables_exercise_start.dita and use it to convert the following content into DITA:

Use the sample image lesson2/images/configurebetter1.png for this exercise.

Supporting marketing with technical content

Tech comm and marcom have long occupied opposite ends of the content spectrum. The stereotype is that tech comm is text-heavy, dense, and badly formatted whereas marcom is shiny, beautiful, and content-free. From there, the debate just intensifies:
Marcom versus tech comm: the stereotypes

	Marcom	Tech comm
Design or automation?	Design	Automation
How much detail?	As little as possible	As much as possible
Assumed impact on revenue	A lot	None
Primary purpose	Persuade people to buy	Inform people

Give people a friendly interface that lets them quickly narrow down their options and choose the one they want. You don’t have to expose all of the fields in the database—just the ones that help people narrow down their choices.

The product list on the right updates as you make selections on the left

Check your file lesson2/l_concept_images_tables_start.dita against the sample file lesson2/l_concept_images_tables_exercise.dita.

Contributors

Gretyl Kinsey, Scriptorium