Step by step process to create new DITA project

Posts: 1
Joined: Fri Feb 03, 2012 6:47 pm

Step by step process to create new DITA project

Post by nant » Fri Feb 03, 2012 6:50 pm

Newbie here.

Trying to learn how to work with XML Author to create DITA based documentation.

Is there a simple step by step process on how to create an empty document?

What should I create first?

A project?

What kind of project?

What next?

A simple primer article would really help here.

Posts: 7028
Joined: Fri Jul 09, 2004 5:18 pm

Re: Step by step process to create new DITA project

Post by Radu » Mon Feb 06, 2012 11:24 am


We do not have a specific template for creating a DITA project but we'll consider adding one.

Basically a DITA project on disk consists of a DITA Map file (which references a sequence of DITA topics) and DITA topics which can be of different types (usually "topic", "task", "concept" and "reference").

Such files can be created by using the New... toolbar action and by quick searching for the word "DITA".

We have some DITA samples in the Oxygen samples project.
For example you can try to open in Oxygen this DITA Map:


You will have the possibility either to open it in the DITA Maps Manager (and see it in a TOC manner) or in the main editor and see how its XML structure looks like.

We also have a video demonstration section on our web site:

and my recommendation for getting started would be these 2 videos:


You can see an answer (which has some interesting links) to a similar question here:

The part from our user manual (also created using DITA) describing DITA editing can be found here: ... -dita.html

Radu Coravu
<oXygen/> XML Editor

Post Reply