DITA-XML for technical documentation

DITADITA stands for Darwin Information Typing Architecture. DITA is an XMLXML-based document format that enables you to organize, edit and assemble modular content and generate information products from these modules.

DITA is an open standard based on XML. There are various tools that you can use to create, edit, format, and manage DITA files. Depending on your business requirements, you can choose an authoring system that best fits your needs. You can use DITA with or without a component content management system (CCMSCCMS). 

• Topic-based writing and single-source publishing. In DITADITA-XMLXML, you organize your technical documentation into self-contained topics. These topics are short enough to describe a single subject and long enough to be useful on their own. Topics are the building blocks that you organize in a DITA map and later publish in multiple formats. DITA-XML separates content from format. Your technical communicators can focus on the content. Later, you can automatically publish the content in multiple formats: HTML, Web Help, print, and more.

• Reuse. Each piece of content in DITA-XML ideally exists only once. This reduces redundancy and eliminates the need to copy content. With DITA-XML, you maintain information in a central location and can reuse it in multiple places.

• Smart documentation with DITA-XML. DITA content can be enriched with metadatametadata. Metadata identifies different documentation variants, such as content for specific product variants. It also supports searching and filtering of content after publication, for example in a web portal. Metadata can be custom or based on a standard like iiRDSiiRDS. parson is an iiRDS expert. Learn more

DITADITA XMLXML provides different topic types for different information needs. These topic types are the most common:

• Task: A step-by-step instruction for a task with a result

• Concept: A topic that provides background information or explains a concept

• Reference: Information to look up facts, such as technical data, configuration parameters, etc.

• Troubleshooting: Information for solving errors and problems

You can connect all topic types and give your users a complete overview of all the information that is available on a specific subject.

DITADITA-XMLXML is not a tool. DITA-XML is a semantic XML format, a so-called "document type definition". It is used to create and publish modular documentation with a strong focus on reuse and variant managementvariant management. DITA-XML is an open-source standard that is supported by several component content management systems (CCMSCCMS), but can also be used without a CCMS. 

Not necessarily. You can use an XMLXML editor, such as Oxygen, to create the content, and the DITA Open Toolkit (OT) to publish it. Learn more about the DITA Open Toolkit.

There are several DITA-XML editors on the market that you can use to write and manage DITA-XML content. The most popular editor is Oxygen XML Author, a powerful system with an easy-to-use interface, validation, and integration with the DITA Open Toolkit. Buy Oxygen product

Also, there are several component content management systems on the market that use DITA-XML as native document format. Examples include Adobe AEM Guides, Empolis CLS, Herretto, Oxygen Content Fusion, IXIASOFT, and Tridion Docs from RWS.

DITADITA-XMLXML supports a range of output formats: HTML, PDF, WebHelp, or mobile applications. You can also use DITA-XML to create output formats such as ODT, Markdown, and other XML-based formats. Output formats are typically created using scripts or tools such as the DITA Open Toolkit.

A DITADITA map organizes your DITA topics in a hierarchical structure, much like a document. You can create output for your DITA map using a variety of output formats.