Import types

You can import many different types of content into Paligo. Some formats can be imported directly, whereas others require an indirect import where you convert the content into a different format before you import it into Paligo.

  • For direct imports, you can use the Paligo import wizard.

  • For indirect imports, use an external application to convert the content to a format that Paligo supports for direct imports. Then use the Paligo import wizard to import that content. For example, if you want to import Adobe FrameMaker content, you could use FrameMaker to create an XHMTL version, and then import the XHTML content.

Format to import

Description

DocBook 5

Direct import in Paligo import wizard

Note

It is also possible to have this import customized for your needs. Contact support for more information.

DocBook 4.5

Direct import in Paligo import wizard

Note

It is also possible to have this import customized for your needs. Contact support for more information.

HTML

Direct import in Paligo import wizard

Note

It is also possible to have this import customized for your needs. Contact support for more information.

Note

HTML is not a structured format. The import will handle many flavors of HTML, but because of the many proprietary variants there is no guarantee it will work for yours. If you have problems, inquire about the possibilities to tweak the content.

Confluence

Direct import in Paligo import wizard

The import works with an HTML Confluence Space export.

Read more in Import from Confluence.

Note

It is also possible to have this import customized for your needs. Contact support for more information.

Paligo Export Format

Direct import in Paligo import wizard

This XML format is used for backups, among other things.

DITA (ditamap)

Direct import in Paligo import wizard

The DITA import can also import keyrefs/conkeyrefs as variable sets. If you have any trouble with this, ask support for instructions about how to prepare the content.

Read more in Import DITA.

Note

It is also possible to have this import customized for your needs. Contact support for more information.

Microsoft Word

There are three options:

  1. Direct import in Paligo import wizard

    This will handle most well-structured Word documents well. If it has problems with your Word styles, try one of the other two options.

  2. Convert to DocBook using the optional Oxygen editor client.

  3. Get a customized Word import from support if your content is not easily imported directly.

Read more in Import from Microsoft Word.

Note

It is also possible to have this import customized for your needs. Contact support for more information.

MadCap Flare

Direct import in Paligo import wizard

Besides the content itself, the MadCap Flare import also handles most "snippets" and variables. If you import multiple projects one after another, you can also specify to reuse the already existing variables, in the options tab.

The direct import handles all the basic content import. For more advanced import, with more support for variables and "snippets", please contact support.

Read more in Import from MadCap Flare.

Note

It is also possible to have this import customized for your needs. Contact support for more information.

Zendesk Guide (Help Center)

Direct import in Paligo import wizard

Zendesk content can be imported directly from Zendesk via the integration, if you have this included in your plan.

Read more in Import from Zendesk into Paligo.

Help & Manual

Direct import in Paligo import wizard

The Help & Manual import will be able to import the bulk of the content well. There are however some known limitations:

  • Help & Manual uses a very flat structure that needs to be converted into more structured nested XML. This is a great challenge for a conversion, and you should make sure the attempt to fix this has not misinterpreted the intended content order.

  • Variables are only partially supported, as the use of variables differs greatly from the way it is implemented in Paligo. Non-supported variable types will be marked with a "remark" element in the import ("UNHANDLED VARIABLE")

  • Conditional filtering is completely different in Help & Manual than in Paligo and most XML-based single-sourcing, so a direct conversion of this is not possible. Instead, it is marked up by "remark" elements to be manually fixed post-import.

Read more in Import from Help and Manual.

Note

It is also possible to have this import customized for your needs. Contact support for more information.

Author-it

Export to XHTML and then import directly in the Paligo import wizard using the Author-it format option.

If conditional filtering has been used, this is not included in the XHTML export, and needs to be applied post-import.

Note

It is also possible to have this import customized for your needs. Contact support for more information.

Adobe FrameMaker

For FrameMaker content, you can first export the content to XHMTL. Then use the Paligo import wizard to import the XHTML.

Note

It is also possible to have this import customized for your needs. Contact support for more information.

If conditional filtering has been used, this is not included in the XHTML export, and needs to be applied post-import.

Alternatively, you can use an external service who can prepare your content for a Paligo import. This can result in a more robust import. Please contact support for details of our recommended FrameMaker specialist.

Other formats:

  • Adobe RoboHelp

  • Adobe InDesign

  • Any other format that can export to one of the supported formats

Export your content to any of the supported formats (available from all of these applications), and then follow the steps above for the applicable format

Pre-processing may be necessary

Depending on the output of the export from any of these tools, some tweaks may be necessary to get the desired results. For instance, the HTML output from InDesign may not always be structured enough, and a pre-transformation and/or some manual tweaks may be necessary.

If you need help with this, please contact support.