Getting Started with Paligo

Importing DITA

DITA can be imported directly in the Paligo Import Wizard. Follow these instructions to prepare your import package.

Note

The Paligo can handle import of a lot of the most common DITA content, including conrefs partially. If something is not currently supported, that will need to be treated manually post-import.

  1. In a folder with your DITA content, make sure you have just one main ditamap file. Name this ditamap file index.ditamap.

    If you have e.g one ditamap for the entire publication, and several "chapter" ditamaps or the like, only select and rename the main publication one. It doesn't matter if that's a regular ditamap or a bookmap.

  2. Include the DTD files inside the folder if they are not already there.

    (If they are not there, you can get them from the DITA OT, and if you are using standard (non-specialized) DITA, the folders from the DTD you need are usually base and technicalContent.)

  3. If you didn't already have these DTD folders in your content folder, you may have to make sure that your content files reference the DTDs correctly in the DocType declaration. So if you have one that looks like this:

    <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd" []>
    

    Then if you don't really have your DTD in the same folder, you need to change this declaration to point to where it is, for example if you copied the DTD folders as described above:

    <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "technicalContent/dtd/topic.dtd" [
    ]>
    

    Note

    The same needs to be done for concepts, tasks, ditamaps, as they all have different DTDs.

    Tip

    The easiest way to do this is with an XML or text editor that can search and replace in all your files at once. Then just search for the current DocType declaration you have in a document, and replace it with the corresponding new one. Do the same for the different topic types and ditamaps.

    Contact support if you need guidance for this.

  4. When you have prepared the files, zip the folder.

  5. Import the zip file using the Import Wizard, selecting DITA (ditamap) as the source format to import.