Skip to main content
  • Paligo Documentation
  • Publish
  • About Publishing

About Publishing

Paligo makes it easy to publish your content to many different output formats, such as PDF (print), HTML, online help, Mobile / HTML5, MS Word, help desk portals (Zendesk, Freshdesk, Salesforce Knowledge), SCORM (for LMS eLearning systems).

Tip

More formats are available on request, such as JavaHelp, manpages (for command line help), and HTML5 slide shows. Some formats can also be added as customizations (paid service).

If you need an additional output format, please contact customer support to see if it is already available and if it can be enabled for you.

A layout contains settings that tell Paligo how to process and style your content for publishing. Available layouts (both built-in and custom layouts created in your Paligo instance) are shown when you choose output type, see Layouts.

If your content contains:

  • Filtering / Profiling, use the Profiling attributes section to tell Paligo which content to include.

    For example, if you have used an output format filter, you could mark up some content to have a PDF value and other content to have an HTML value. In the publishing settings, if you set the Output Format to PDF, it will include the content that is filtered as outputformat:PDF. Paligo will then exclude any content that is filtered as outputformat:HTML filter (or any value other than PDF).

  • Variables - Use the Variables section to choose which variants to be published.

publish-document-jan23.png

Note

There are a number of built-in layouts for each output format. You can customize them just as you please using the Layout Editor. If that is not enough, you can also purchase customizations from Paligo, in which case there are very few limitations to the output you can get.

What Happens during Publish?

When you choose to publish a publication or topic, Paligo generates an output, such as an HTML5 Help Center or a PDF. To generate the output, Paligo performs a "transformation", where it looks at:

  • The type of Layout to find out which type of output to create.

  • The layout settings to find out which settings and features to apply.

  • The publishing settings to find out what languages, Filtering / Profiling, Variables and other settings to use.

  • Detects any attributes that are set for elements in your content. These tell Paligo to apply certain properties in the output, for example, Paligo can use the role attribute to create a matching class name in an HTML5 output.

  • Creates an output file that downloads in your browser (and is published to another system, if you publish to an integration, such as Zendesk)

In Paligo, the content and styling are separated. For styling your output, use the Layout Editor. When you publish, you only need to configure the Layout settings and choose the publishing settings. Paligo takes care of the actual "transformation" into HTML5, PDF, and other formats.

Note

For HTML5 outputs, you can also Style with CSS and Style with JavaScript. Paligo includes these files in the output so that the browser can see the CSS and JS to apply those styling rules in the browser.

Tip

To learn how to