Skip to main content

Import from Confluence

To import content from Atlassian Confluence, use the Import Wizard.

For Confluence, you can import all of the HTML files in a Confluence space at once or you can choose to import individual files. The preparation required for single file imports and multi-file imports is slightly different.

When importing from Confluence, please bear in mind that:

  • Paligo maps the <h1> tags in the Confluence HTML files to <title> elements in <sections> in Paligo topics.

  • If there are images in your Confluence import, the references to them must be accurate. The relative paths from the source files to the image files has to be correct, otherwise the images will not import.

Note

Paligo will be able to handle most common Confluence space exports. If you should have something particular in your content that may not be standard, it may still be possible to customize the import to handle that. Simple customizations may be included, depending on your plan, or can involve a cost for the additional service.

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

For instance, if you find that the topic sizes do not come out the way you want, this is a setting that can easily be changed for your import.

Multi-file Import

A Confluence space HTML export will contain one index.html file and a number of additional HTML file for each space section you had in your Confluence space. Do this to prepare the package to import them all at once:

  1. Open the file index.html in any text editor.

  2. Locate the element ul that comes right after the div with class "pageSectionHeader":

    confluencetoc.png

  3. Add a class attribute to it with the value "toc", like this: <ul class="toc">

    confluencetoc2.png

    This tells Paligo which unordered list (UL) to look in for the structure of the HTML files to import. If there are lower-level unordered lists that have class names, you can leave those in place as long as the top level of the unordered list has the class name "toc".

  4. Zip the entire folder with this file and all its resource folders.

  5. Use the Import Wizard to import it to Paligo.

Single File Import

It's also possible to import just a single HTML file from a Confluence export (in case each of your sections in Confluence have been quite long, a publication in itself). Then do this:

  1. Pick the HTML file you want to import. Copy that and all resource folders. 

  2. Paste these files into a new folder, name it anything you want, e.g ConfluenceImport_1 or whatever suits you.

    In this case it doesn't matter what the file is named, but it needs to be just one HTML file in this import folder.

  3. Zip that folder.

  4. Use the Import Wizard to import it to Paligo.