Title

A title is a heading or label for an object. Titles can be associated with topics, maps, sections, examples, figures, tables, and other structures.

Syntax

XDITA

<title> in <topic>, <section>, <example>, <fig>, and <simpletable>.

HDITA

<h1> and <title> for topic (The content for Title in an HDITA topic MUST map to both <title> and <h1>). <h2> for section and example. <figcaption> in <figure>.<caption> for table. Title also applied to audio and video in HDITA as attribute???

MDITA (core and extended profiles)

# or === underline for topic; ## or ----- underline for section

Attributes

The available attributes vary based on the authoring format:

XDITA and HDITA
The following attributes are available on this element: localization attributes and universal attributes.
MDITA
There is no attribute support for the MDITA core profile. For the MDITA extended profile, attributes can be specified by using the HDITA representation.

Examples

This section is non-normative.

Example 1. XDITA example

The following example demonstrates the use of a title in an XDITA topic.

 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE topic PUBLIC "-//OASIS//DTD LIGHTWEIGHT DITA Topic//EN" "lw-topic.dtd">
 <topic id="install-and-setup">
   <title>Installing and Setting up Remote Lighting</title>
   <shortdesc>Installation of your lighting kit includes installing the light bulbs into
   light fixtures, preparing the remote control, and programming lighting groups.
   </shortdesc>
  </topic>
Example 2. HDITA example

The following example demonstrates the use of a title in an HDITA topic.

  <!DOCTYPE html>
  <html>
  <head>
  <title>Installing and Setting up Remote Lighting</title>
  </head>
  <body>
   <article id="install-and-setup">
    <h1>Installing and Setting up Remote Lighting</h1>
    <p>Installation of your lighting kit includes installing the light bulbs into light fixtures, preparing the remote control, and programming lighting groups.</p>
  </article>
  </body>
  </html>
Example 3. MDITA example

The following example demonstrates the use of a title in an MDITA topic using ATX headings.

# Installing and Setting up Remote Lighting

Installation of your lighting kit includes installing the light bulbs into light fixtures, preparing the remote control, and programming lighting groups.
Example 4. MDITA example

The following example demonstrates the use of a title in an MDITA topic using Setext headings.

Installing and Setting up Remote Lighting
=========================================

Installation of your lighting kit includes installing the light bulbs into light fixtures, preparing the remote control, and programming lighting groups.