• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar

Learning DITA

Free DITA training

Free DITA training

  • Log in
  • Register
  • Newsletter
  • Profile
  • Privacy
  • Home
  • About
  • Courses
  • News
  • Resources
    • Recordings
  • Questions?
  • Contact

Creating a new concept topic

Posted on 08.30.15

Concept topics contain basic DITA elements, such as paragraphs, lists, images, tables, and many others. Most of these elements can be used in the other topic types (task, reference, and glossary), as well. The only exception is the <conbody> element, which is specific to the concept topic type.

At a minimum, the concept topic must contain a <concept> root element (with an id attribute) that contains a <title> element.

After the <title> element and an optional <shortdesc> or <abstract> element, the <conbody> element contains the concept itself.

The <conbody> element has an open content model. This means that the elements contained in <conbody> are not required to follow a strict sequence. As long as an element is allowed inside <conbody>, it can appear in any order. The exceptions are the <section> and <example> elements, which can only be followed by other <section> or <example> elements or a <conbodydiv> element.

Video: Creating a DITA concept

Practice
  1. Make a copy of the file lesson1/l_new_concept_start.dita and open it in your editor.

    Note:

    If you are using a DITA-aware text editor, make sure you are in text mode, rather than author or visual mode.

    You should see this:

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
    <concept id="my_first_concept">
    <title>xyz</title>
    </concept>

    The first line (which begins with <?xml) is an XML declaration, which is a standard part of all XML files.

    The DOCTYPE declaration on the second line identifies this file as a concept topic.

    The third line is the opening tag of the <concept> element, which uses the unique ID “my_first_concept”.

    The <title> element on the fourth line contains the title of the topic.

    The fifth line uses the closing tag </concept> to show where the <concept> element ends.

  2. Inside the <title> element, change the text of the title as shown in the following example.

    Note:

    When working inside an element, insert the content between the opening and closing tags.

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
    <concept id="my_first_concept">
       <title>Wild duck species</title>
    </concept>
  3. After the <title> element, add a <conbody> element.

    Note:

    When adding an element after another element, insert the new element after the closing tag of the first element.

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
    <concept id="my_first_concept">
       <title>Wild duck species</title>
       <conbody>
    </conbody>

    </concept>
    The <conbody> element will contain all the actual content in the concept.
Contributors
  • Gretyl Kinsey, Scriptorium

sidebar

Blog Sidebar

  • Scriptorium logo
    Maximize the value of your content. Read more.
  • Scriptorium logo
    Already in DITA and need support? Contact us.
RSSLinkedin

Want to add content? Join the ditatraining GitHub repository.

  • Home
  • News
  • Contact
  • Privacy
  • Cookie Policy

Maintained by Scriptorium Publishing

Logo and site presentation © 2015–2023 Scriptorium Publishing. Content based on the open-source DITA training project.

Manage Cookie Consent
To provide the best experiences, we use technologies like cookies to store and/or access device information. Consenting to these technologies will allow us to process data such as browsing behavior or unique IDs on this site. Not consenting or withdrawing consent, may adversely affect certain features and functions.
Functional Always active
The technical storage or access is strictly necessary for the legitimate purpose of enabling the use of a specific service explicitly requested by the subscriber or user, or for the sole purpose of carrying out the transmission of a communication over an electronic communications network.
Preferences
The technical storage or access is necessary for the legitimate purpose of storing preferences that are not requested by the subscriber or user.
Statistics
The technical storage or access that is used exclusively for statistical purposes. The technical storage or access that is used exclusively for anonymous statistical purposes. Without a subpoena, voluntary compliance on the part of your Internet Service Provider, or additional records from a third party, information stored or retrieved for this purpose alone cannot usually be used to identify you.
Marketing
The technical storage or access is required to create user profiles to send advertising, or to track the user on a website or across several websites for similar marketing purposes.
Manage options Manage services Manage vendors Read more about these purposes
View preferences
{title} {title} {title}
Manage Cookie Consent
To provide the best experiences, we use technologies like cookies to store and/or access device information. Consenting to these technologies will allow us to process data such as browsing behavior or unique IDs on this site. Not consenting or withdrawing consent may adversely affect certain features and functions.
Functional Always active
The technical storage or access is strictly necessary for the legitimate purpose of enabling the use of a specific service explicitly requested by the subscriber or user, or for the sole purpose of carrying out the transmission of a communication over an electronic communications network.
Preferences
The technical storage or access is necessary for the legitimate purpose of storing preferences that are not requested by the subscriber or user.
Statistics
The technical storage or access that is used exclusively for statistical purposes. The technical storage or access that is used exclusively for anonymous statistical purposes. Without a subpoena, voluntary compliance on the part of your Internet Service Provider, or additional records from a third party, information stored or retrieved for this purpose alone cannot usually be used to identify you.
Marketing
The technical storage or access is required to create user profiles to send advertising, or to track the user on a website or across several websites for similar marketing purposes.
Manage options Manage services Manage vendors Read more about these purposes
View preferences
{title} {title} {title}