Skip to main content

Import HTML (Single File)

Paligo can import a single HTML file, as long as the file (and any file it references) is organized into a particular folder structure. Select the HTML (index.html) option when importing to Paligo.

Important

Paligo can only import valid HTML. We recommend that you test your HTML first by using a third-party HTML validator tool such as https://validator.w3.org/.

The import will fail if the HTML is invalid (Paligo recognises the content is invalid and reports "nothing to import").

Prepare HTML File for Import

Before you can import an HTML file, you need to organize the file and any referenced files into folders. You must also make sure that any references to other files, such as images or CSS, use relative references.

Important

When importing HTML, the folder names are case-sensitive.

Note

Ensure that the source files are valid by using an HTML validator to test your HTML file, like Tidy or W3C. This will help to identify and potentially fix any structural problems in your HTML before you attempt to import it.

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.

Tip

To learn about relative references, see www.w3schools.com.

  1. Organize your HTML content like this:

    • Parent container folder

      It is important that the "container" folder includes one HTML file at the root level, with any referenced images or CSS files in subfolders.

      • HTML file to be imported (for example instruction.html)

      • Images folder - The folder name can be anything, but is case-sensitive, which means that the @src attribute must match the name and case of the actual folder otherwise the images will not be imported.

        • Image files (for example controls.jpg, connections.png)

      • CSS folder

        • CSS files (for example style.css)

    Mac iOS folder view. There is a parent container folder. Inside that folder is an introduction.html file and an images subfolder and a CSS subfolder.

    Example of a valid structure to import an HTML file.

  2. Next, use your computer's operating system or a third-party application to make a zip file of the "container" folder.

    Tip

    To learn how to zip a file, see the operating system's documentation:

  3. Use the Import Wizard to import the zip file. Select the HTML format.

Troubleshooting HTML Imports

If your HTML import does not work, we recommend that you:

  • Validate your HTML content. Paligo will only import correctly formed HTML content.

    There are many HTML validation tools you can use, such as https://www.html-tidy.org.

  • Make sure that you have organized the content as described. The arrangement of the files and folders in the zip file that you import is vital to the success of the import.

  • Check that your HTML files use relative references to images and CSS.

Note

If you fix these issues and the import still fails to work, contact customer support for assistance.