eLearning – Paligo

Abstract

Learn how to use Paligo to create single-source eLearning content that you can publish to a Learning Management System.

With Paligo's eLearning support, you can author content in Paligo and publish it as an eLearning package. You can then upload the package to your Learning Management System (LMS).

There are many benefits to this approach to creating and managing eLearning content:

Your documentation and eLearning content is stored in one place as one "source of truth"
Avoid unnecessary duplication with Paligo's content reuse features. There's no need for content creators to make multiple versions of the same content for different outputs. Instead, you can easily reuse your documentation content in your eLearning content.
You can use Paligo's advanced authoring features with your eLearning content, such as variables, profiling (filters), and branching.
Paligo content is pure XML (Paligo XML) so is more future proof.

Learning Management System with a Paligo eLearning course uploaded to it.

An LMS containing a course that was created in Paligo.

eLearning Workflow

To create an eLearning course in Paligo that you can use in a Learning Management System (LMS):

Create an eLearning Publication - The publication acts as a "table of contents" for your eLearning course.
Add Information Topics for eLearning and add them to your eLearning publication. You can create new topics and reuse topics that already exist in Paligo. When you edit your topics, you can also reuse structures that already exist in Paligo, such as informal topics, admonitions, and text fragments such as paragraphs.
Quiz Topic Your quiz topics can contain questions with a numerical answer or questions with multiple-choice answers. There are several variations of multiple-choice questions, including trick questions.
Organize the eLearning Publication so that the course topics and quizzes are in the correct order.
Create an eLearning Layout and set your publishing preferences.
Publish the eLearning using your eLearning layout.
Use CSS and JS to style your eLearning and modify its behavior, if required,see eLearning Styling.)
Republish your eLearning publication with your custom CSS and JS in place.
Upload the eLearning Output to your LMS.

Create an eLearning Publication

To set up an eLearning course in Paligo, we recommend that you start by creating a publication. The publication acts like a "table of contents" for your eLearning topics and is where you will choose which topics are included and the order they should appear.

Create a publication for your eLearning:

Select the Dotted menu ( ... ) for a folder in Content Manager and choose Create Content and Publication.

The new publication appears in the selected folder. For details, see Create a Publication.
Select the new publication in the Content Manager to open its structure.

Paligo opens the publication structure.
Select Save.

You now have an eLearning publication to contain your course. The next step is to add information topics and quiz topics to it.

Set a Minimum Passing Score

The default minimum passing score in Paligo is set to 70 % correct answers, regardless if they are distributed into multiple quizzes or a single quiz.

This can be adjusted in two different ways:

Publication level lets each quiz publication have its own settings.
Layout level will result in a general setting for all quizzes.

Override Passing Score on Publication Level

On the publication level it is possible to set a basic passing score or to profile it with different minimum scores depending on for example user level, product or market. This can be set when the publication is created or adjusted afterwards.

Tip

By including questions for different user levels and profiling them, you will only need one publication.

Select the Dotted Menu (...) for the publication in Content Manager.
Select Edit and choose Open in editor.

Paligo opens the publication topic.
Use the keyboard down arrow ⬇️ to position the cursor at the bottom of the article.
Press Alt + Enter ⏎ (Windows) or Command ⌘ + Enter ⏎ (Mac) to display the Element Context Menu.
Enter Remark and select it from the menu.
Enter the minimum passing score in percentage, but exclude the percent sign.
Add the attribute Role in the Element Attributes Panel.
Add the value elearning.min.score.

This value collects the minimum passing score stated in the Remark element.

Note

The three following steps shows how to separate different passing scores depending on user level.

Read more about profiling information, see Filtering / Profiling.
Add the attribute userlevel and select a filtering to a specific group of questions (for example Basic user).
Add an extra remark, below the first one, with a different minimum passing score.
Add the attribute userlevel and select a filtering to a different group of questions (for example Advanced user).
Select Save.

Override Passing Score on Layout Level

If you want to have a general passing score, that overrides the Paligo default value, it must be adjusted on a layout level. At this level there is no possibility to use profiling / filtering. Using this method will also override any values set on the publication level.

To do this the following line must be added to your custom JavaScript file:

...
var minScore = 65;
...

Add Information Topics for eLearning

eLearning courses usually consist of a series of "information topics" followed by a quiz. The information topics provide facts and explain concepts, and the quiz topics test the user's knowledge.

Here, we are going to focus on the information topics. These are regular topics, and are no different to the topics you might create for HTML help centers or PDFs. Each topic has a title and you can add paragraphs, images, notes, and other types of content as needed.

For your information topics, you can create new topics and / or reuse topics that already exist. For example, let's say you have an "Introduction to Acme 100" topic that was created for a PDF output. Rather than duplicating the same content for your eLearning course, you can reuse the same topic.

Example of an information topic. This topic is titled "Topic Based Authoring - How it Works" and it contains text and images.

Example of an information topic. It contains text and images.

Create new eLearning topics

To create new eLearning topics:

Select the eLearning publication in the Content Manager to open its structure.
Select New topic.

Paligo adds a new topic. It is added to the publication structure automatically and is also added as a topic in the Content Manager.
Enter a name for the new topic.
Select Save.

Note

Alternatively, you could add a new topic in the Content Manger and then manually drag and drop it into the publication structure. To learn more, see Create a Topic.

Reuse existing topics in the eLearning

To reuse topics that already exist in Paligo, you have to open the eLearning publication.

Select the eLearning publication in the Content Manager to open its structure.
Find the topic that you want to reuse in the eLearning. You can explore the folders manually or use the search at the bottom to find topics by name.
Drag and drop the topic into the structure of the publication.
Select Save.

You can edit new and existing information topics in the same way as other Paligo topics. For details, see Add Topic Content and Content Reuse.

Tip

To learn how to add quiz topics to your eLearning publication, see Create a Quiz Topic.

Quiz Topic

Quizzes are a fun way to test your audience's knowledge at various stages of your eLearning course. You can create your quizzes in Paligo and add questions with numerical answers and multiple-choice questions, see Question Types.

When you upload your eLearning to a Learning Management System (LMS), users will be able to take the quizzes and the LMS will track their progress and scores, see Upload the eLearning Output to your LMS.

To create a quiz:

Create a Quiz Topic
Add More Questions to a Quiz.
Add the answers to your questions, see:
- Set Up a Numerical Question/Answer
- Set Up a Multiple Choice Question/Answer

Multiple choice question. Each possible answer has a checkbox. The user can select multiple answers.

Example of a multiple choice question with multiple correct answers.

Note

If you did not create the quiz topic from the publication structure, you will need to manually add the topic to the publication, see Organize the eLearning Publication.

Question Types

Before you add a question to your quiz, consider what type of answer formats are available. Paligo supports answers that require the user to:

Enter a numerical value into a field, see Set Up a Numerical Question/Answer
Choose one answer from a list of potential answers, see Set Up a Multiple Choice Question/Answer.
Choose several answers from a list of potential answers, see Set Up a Multiple Choice Question/Answer.

It is also possible to create a "trick" multiple choice question. This is where the question looks like a multiple choice question with multiple correct answers, but there is only one correct answer. The "trick" question has checkboxes.

Create a Quiz Topic

To create a quiz in Paligo, you create a topic and add a role attribute with the value set to: quiz. Then you add a qandaset element to contain the quiz structure.

The qandaset element is a container for all of the questions and answers you include in your quiz. When you add a qandaset, Paligo automatically adds some extra structure for the first question and one potential answer. The structure consists of:

qandaentry - Each question has to be inside its own qandaentry element. For example, if you have a quiz with 5 questions, the quiz is represented by the qandaset element and inside that you will have 5 qandaentry elements (1 for each question).
question and para - The question element represents a question in the quiz and it has to be inside a qandaentry element. The para inside the question is where you enter the text for the question.
answer and para - The answer element represents a possible answer to the question. It has to be inside the same qandaentry element as the question. The para inside the answer is where you enter the text for the answer.

Quiz topic in the Paligo editor. It has a title and a question and answer.

XML tree view of a sample quiz topic. It has section at the top level, then title, then qandaset, then qandaentry, then question, para, answer, and para.

To the left the structure in the Editor. To the right the structure in the XML Tree View.

To create a quiz topic:

Create a Topic.
Select the topic or component in the Content Manager to open it in the Editor.

Alternatively, you can Create a Topic and edit that.
Select the section element in the Element Structure Menu.
Select Go to element.
Add the role attribute in the Element Attributes Panel and set the value to quiz.
Position the cursor where the quiz is to be inserted.
Press Alt + Enter ⏎ (Windows) or Command ⌘ + Enter ⏎ (Mac) to display the Element Context Menu.
Enter qandaset and select it from the menu.

Tip

You can add extra para elements inside a question or answer to create multi-paragraph questions and answers. Add any extra para elements after the previous para element, inside the question or answer.

If you have multiple para elements, the first one will be styled like a heading in the output. The other para elements will be styled as regular text.

You can also insert other content structures inside a question or answer, such as mediaobject for an image and programlisting for code.
Select Save.

You now have the basic structure for a quiz, with one question and a single answer. This will be a numerical question and answer unless you add additional answers to turn it into a multiple-choice question / answer.

Tip

To learn how to add more questions, see Add More Questions to a Quiz.

We have included Example Quiz Topic that contains multiple questions and answers. You can use this example to see how the question and answers need to be structured in your quiz topic.

Set Up a Numerical Question/Answer

Numerical question/answers are quiz questions that require the user to enter a number for the answer. There is a question in text and below it, a field for entering the answer.

Example of a numerical quiz question. It has a question in text and a field to enter the answer. The answer is a number.

To set up a numerical answer for a quiz:

Make sure your topic has the qandaset structure that is needed for a quiz (see Create a Quiz Topic). You also need to add the question structure for your numerical question (see Add More Questions to a Quiz).
Enter the body text of the question inside the para that is inside the question element.
Enter the correct answer (a number) inside the para element that is inside the answer element.
Select Save.

When you publish your eLearning, Paligo will detect that this is a numerical answer and make it a question with a text-entry field in the output.

Set Up a Multiple Choice Question/Answer

There are three types of multiple choice question that you can create:

A multiple choice question with one correct answer. The user is presented with a list of options and each one has a radio button.
A multiple choice question with more than one correct answer. The user is presented with a list of options and each one has a check box.
A trick multiple choice question. It presents the user with a list of options that have check boxes so it appears as if there are multiple correct answers. But there is only one correct answer.

The following instructions explain how to create all three types:

Make sure your topic has the qandaset structure that is needed for a quiz (see Create a Quiz Topic). You also need to add the question structure for your numerical question (see Add More Questions to a Quiz).
Enter the body text of the question inside the para that is inside the question element.
Enter the text for a possible answer inside the para element that is inside the answer element.
Position the cursor after the previous answer element but still inside the qandaentry element.
Press Alt + Enter ⏎ (Windows) or Command ⌘ + Enter ⏎ (Mac) to display the Element Context Menu.
Enter answer and select it from the menu.

Note

If the answer element is not available in the list, then the cursor is in an incorrect position. Check that it is after the question but inside the qandaentry element. The correct structure should look like this in the XML tree:
Enter the text for a possible answer in the para inside the answer element that you have added.

Tip

You can add extra para elements inside a question or answer to create multi-paragraph questions and answers. Add any extra para elements after the previous para element, inside the question or answer.

If you have multiple para elements, the first one will be styled like a heading in the output. The other para elements will be styled as regular text.

You can also insert other content structures inside a question or answer, such as mediaobject for an image and programlisting for code.
Repeat steps 5 and 6 to add more possible answers, including the correct answer(s). The completed structure should look something like this in the XML tree:

Notice how the question and the potential answers are all inside the qandaentry element. Each question should have its own qandaentry element, with the question and potential answers inside it.
Select the correct answer in the Editor.
Select its answer element in the Element Structure Menu at the top and choose Go to element from the menu.
Add the role attribute in the Element Attributes Panel and set the value to correct.

When you set an answer to correct, a green box and check mark appear for that answer in the Paligo editor.
If a question has multiple correct answers, repeat steps 9 and 10 for each correct answer.
This step only applies if you want to make your multiple choice question a "trick" question. A trick question is where it looks like there is more than one correct answer but actually only one answer is correct.

To turn a multiple choice question into a trick question:
1. Select the question element for the trick question.
2. Add the role attribute in the Element Attributes Panel and set the value to multi-choice.
Select Save.

When you publish your eLearning, Paligo uses the role attributes to determine what type of multiple-choice questions you have added. It then creates those in the published output.

Add More Questions to a Quiz

To add more questions to a quiz topic:

Make sure your topic contains the structure for a quiz (as described in Create a Quiz Topic).
Position the cursor so that it is after the previous qandaentry element but inside the qandaset element.

Note

If you cannot find the qandaentry element in the element context menu, it is because the cursor is in an incorrect position. Try repositioning the cursor so that the selection point is after the previous qandaentry element but still inside the qandaset element.

When the cursor is in the correct position, the Element Structure Menu shows section > qandaset. You will then be able to add qandaentry from the element context menu.
Press Alt + Enter ⏎ (Windows) or Command ⌘ + Enter ⏎ (Mac) to display the Element Context Menu.
Enter qandaentry and select it from the menu to add another question.

You have now added the structure for an additional question. By default, the structure contains one answer element. You can add more answer elements to turn it into a multiple-choice question. Alternatively, you can use a single answer for a numerical question.
Repeat step 2 to 4 for as many questions as you need.
Select Save.

Remove a Question from a Quiz

To remove a question and its answers from a quiz:

Open the quiz topic in the Editor.
Select the question that you want to remove.
Select the qandaentry element In the Element Structure Menu and choose Delete.

Paligo removes the structure for the question and its answers (qandaentry, question and para, and each answer and para pair).
Select Save.

Remove an Answer from a Quiz

To remove an answer from a question in a quiz:

Open the quiz topic in the Editor.
Select the answer that you want to remove.
Select the answer element in the Element Structure Menu and choose Delete.
Select Save.

Example Quiz Topic

This example shows the underlying structure of a Paligo quiz topic called "Quiz - Creating Content in Paligo". It contains multiple choice questions with single correct answers, multiple choice questions with several correct answers, a trick multiple choice question, and a numerical question too.

By looking at the code, you can see the valid structure for the quiz and the various question types. If you have problems setting up your own quiz, referring to this example may help you spot any structural problems.

Note

We have removed the database IDs to make the code simpler, but in your topics the IDs will be included in the code, for example, xinfo:text="1169436".

Example 44. Quiz structure

The following source code shows the structure for a valid quiz.

<?xml version="1.0"?>
<section xmlns="http://docbook.org/ns/docbook" xmlns:xinfo="http://ns.expertinfo.se/cms/xmlns/1.0" version="5.0" xinfo:resource="UUID-9921a762-7cd2-093a-3583-c1f8206fcf0d" xinfo:resource-id="1169399" xinfo:resource-type="component" xinfo:resource-title="Quiz - Creating Content in Paligo copy 1" xinfo:resource-titlelabel="" xinfo:version-major="1" xinfo:version-minor="0" role="quiz" xml:id="UUID-9921a762-7cd2-093a-3583-c1f8206fcf0d" xml:lang="en">
  <title>Quiz - Creating Content in Paligo</title>
  <qandaset>
    <qandaentry>
      <question>
        <para>When you check out a topic in Paligo, can another Author edit that topic at the same time?</para>
      </question>
      <answer>
        <para>Yes, Paligo supports simultaneous editing by multiple authors.</para>
      </answer>
      <answer role="correct">
        <para>No, the topic is locked for editing by others when it is checked out.</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>What is an informal topic?</para>
      </question>
      <answer>
        <para>A selection of content or images that must have a title</para>
      </answer>
      <answer role="correct">
        <para>A selection of content or images that do not need a title</para>
      </answer>
      <answer>
        <para>A special type of admonition that the user can select to ignore</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>What is a fork?</para>
      </question>
      <answer>
        <para>A container where you organize your topics into a table of contents</para>
      </answer>
      <answer role="correct">
        <para>A reference to a source topic, reused in a publication</para>
      </answer>
      <answer>
        <para>A building block for a section of content</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>What interface is shown when you open a publication?</para>
      </question>
      <answer>
        <para>The Editor View</para>
      </answer>
      <answer role="correct">
        <para>The Structure View</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>To open a topic and work on it, which interface would you use?</para>
      </question>
      <answer role="correct">
        <para>The Editor View</para>
      </answer>
      <answer>
        <para>The Structure View</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question role="multi-choice">
        <para>What is a topic?</para>
      </question>
      <answer>
        <para>A container where you organize your topics into a table of contents</para>
      </answer>
      <answer>
        <para>A reference to a source topic, reused in a publication</para>
      </answer>
      <answer role="correct">
        <para>A building block for a section of content</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>Which of the following statements are true?</para>
        <para>Topic-based authoring ...</para>
      </question>
      <answer>
        <para>... is similar to document writing and formatting in Microsoft Word</para>
      </answer>
      <answer role="correct">
        <para>... encourages breaking down documents into smaller pieces of content</para>
      </answer>
      <answer role="correct">
        <para>... makes it possible to reuse content as building blocks in multiple publications</para>
      </answer>
      <answer role="correct">
        <para>... enables you to update content in one place, and the update applies wherever the content is used</para>
      </answer>
      <answer>
        <para>... does NOT encourage the reuse of content</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>What is the correct order (from largest to smallest, left to right) of the following Paligo structures?</para>
      </question>
      <answer>
        <para>Topic, Publication, Element, Section</para>
      </answer>
      <answer>
        <para>Section, Publication, Element, Topic</para>
      </answer>
      <answer role="correct">
        <para>Publication, Topic, Section, Element</para>
      </answer>
      <answer>
        <para>Publication, Section, Topic, Element</para>
      </answer>
    </qandaentry>
    <qandaentry>
      <question>
        <para>How many floating content panels can you have open at once?</para>
      </question>
      <answer>
        <para>4</para>
      </answer>
    </qandaentry>
  </qandaset>
</section>

Notice that:

The entire quiz is inside one qandaset element
Each question is inside a qandaentry element
Each question has a question element with a para element for its text
Each answer is in an answer element with a para element for its text
role="correct" is added to the answer element for each correct answer. Paligo does this automatically when you give an answer element the role attribute and set its value to correct.
role="multi-choice" is added to the question element for a trick question. This tells Paligo to make this multiple choice question look like it has several correct answers (it presents the options as check boxes) but it actually only has one correct answer. Paligo applies this code when you give a question element the role attribute and set its value to multi-choice.
The answer element for a numerical question contains the answer in the para element. Paligo detects that this is a numerical question/answer automatically. When you publish, the question will have a text box for the user to enter a number. They will not see the correct answer.

Organize the eLearning Publication

When you have added your information topics and quiz topics to your publication, you can organize them to create the flow of your course. Typically, eLearning courses consist of several information topics followed by a quiz.

To organize your eLearning course:

Select the eLearning publication in the Content Manager.
Select a topic and drag and drop it into a new position in Structure View.

Alternatively, select a topic and use the directional arrows to move the topic in the structure.
To add other topics to your publication, drag and drop the topics from the Content Manager into the publication structure.
To remove a topic from the publication, select the topic and then select the cross icon X.
Use the arrow buttons to arrange your topics and reused publications into the order you want. You can set them to display as a flat structure or you can "nest" topics and publications so they have a more complex structure, with multiple levels of content, see Organize a Publication.
Select Save.

When you have finished organizing your eLearning course, and it contains all of the content you need, you can publish it.

Create an eLearning Layout

To publish content that you can import into a learning management system (LMS), you need to use an eLearning layout. The layout contains "publishing settings" that Paligo applies to your content when it builds your eLearning content.

Paligo has a built-in eLearning layout that you can use, but we recommend that you create your own layout. You can then make changes to the layout settings and use it as the basis for other layouts too.

Follow the steps in Create a Layout and make sure to select the appropriate eLearning option.

Currently, there is an eLearning option for SCORM, but other eLearning standards may be supported in future releases.
Style the layout, see eLearning Styling.
When you have set your layout preferences, you can use the layout to publish an output that you can upload to your LMS.

Create new layout dialog. It has a layout title field and an output format dropdown list. The output format is set to eLearning - SCORM

eLearning Layout Options

eLearning layouts have a single category:

CSS, JS, logos, and other assets

This category contains the following settings:

Category	Description
Logotype	Add your logotype to replace the Paligo logo in the output. Use CSS to style it. To learn more, see Add a Logo.
Logo link	Use to set the logo in the top corner of the eLearning output to act as a hyperlink. When a user selects the logo, the browser will display the webpage that you define here. Enter the URL of the web page that will be the target of the hyperlink, for example, the URL of your company's webpage. Leave this field empty if you do not want the logo to act as a hyperlink, see Set a Logo to Link to a Web Page.
CSS	Upload your own CSS to modify the default layout. To learn more, see Upload Custom CSS to an Elearning Layout.
Persistent custom CSS filename	By default, your custom CSS file will get a unique name, everytime you upload a new update. The unique name is generated when you publish. To keep the same CSS file name and prevent it from changing, set Persistent custom CSS filename to Enabled. The CSS file name will then be set to 'layout-custom-style.css' and it will not change. Default: disabled. To learn more, see Set Paligo to Keep the Same CSS Filename.
Custom javascript	You can upload your own javascript to add functionality to your eLearning output, see Upload Custom JavaScript to an eLearning Layout.

eLearning Styling

To change the styling of the eLearning content that Paligo creates, use a third-party code editor to create your own custom CSS and JavaScript (JS) files. You can then upload these to an eLearning layout in Paligo. When you publish with that layout, the CSS and JS are included in the output and applied to the HTML files.

To create your custom CSS and / or JS file(s) and add them to your Paligo publication, we recommend that you:

Publish your eLearning content in Paligo, using the default eLearning layout, see Publish the eLearning.
Unzip the output and open its index.html file in a browser.
Use the browser's inspect features to view the existing HTML and test any changes you want to make to the CSS and JS.
When you have the changes you want, use a third-party tool, such as BBEdit, to create a custom CSS and / or JS file.
In Paligo, create a new eLearning layout or edit an existing one, see Create an eLearning Layout.
Use the settings on the eLearning layout to:
Publish your eLearning content again, using the layout with your custom CSS / JS.
Upload the output to your Learning Management System (LMS).

We recommend you begin by publishing your eLearning content with the default layout. Then update the layout.

Tip

To learn more about using the browser's inspect tool, see Style with CSS. The article is written with HTML5 help center outputs in mind, but it also applies to the eLearning output.

Add a Logo

By default, the eLearning output includes the Paligo logo in the top corner, above the table of contents. To replace it, you can upload your own logo image to your eLearning layout. When you publish that layout, the output will use your custom logo instead.

Elearning output with custom logo in place.

To add a custom logo:

Select the Layout tab in the top menu.

Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.
Select the layout to be updated or Create a Layout.

Tip

You can copy the URL of the layout editor and paste it into a new tab in your browser. This can be useful if you frequently switch between your Paligo content and the layout settings.
Select CSS, JS, logos and other assets in the sidebar.
Use the Logotype field to upload a logo image. You can upload an image in any of these formats: ai, svg, pdf, png, tif, gif.
Select Save.

When you publish using this layout, Paligo will generate an eLearning layout that uses your uploaded image as the logo.

Note

You can set up the logo to act as a hyperlink to another web page such as your company homepage. To find out more, see Set a Logo to Link to a Web Page.

Set a Logo to Link to a Web Page

If you have added a custom logo, you can set it to work as a hyperlink in the published eLearning. When a user selects the logo, the browser will navigate to the web page of your choice, such as the home page for your organization. The linked web page will always open in a new tab or window.

To set up a logo so that it acts as a hyperlink and links to a particular web page:

Select the Layout tab in the top menu.

Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.
Select the layout to be updated or Create a Layout.

Tip

You can copy the URL of the layout editor and paste it into a new tab in your browser. This can be useful if you frequently switch between your Paligo content and the layout settings.
Select CSS, JS, logos and other assets in the sidebar.
Enter the URL for the target web page in the Logo Link field. (For example, http://paligo.net.)

Note

If you clear the field, the logo will not act as a hyperlink.
Select Save.

Upload Custom CSS to an Elearning Layout

You can use a third-party text or code editor to create a custom CSS file that alters your eLearning output. For example, you could use CSS to change the appearance of headings and the font styles used by regular text. You can then upload your CSS file to Paligo so that when you publish your content, the CSS is included (and referenced).

Tip

To create a custom CSS, we recommend that you publish an output with the default settings in place. Then open that content in a browser and use the browser's inspection tools to view the existing styles and experiment with new ones. When you have worked out what styles you want to use, use a code editor to write the CSS and then upload that file to Paligo and re-publish your content.

This is the same approach we recommend for HTML5 outputs. You can find out more about accessing the browser's inspect features in Style with CSS.

To upload a custom CSS file to a Paligo layout:

Make sure your custom CSS file is valid and has the .css file extension. There are many online tools for validating JavaScript, such as https://beautifytools.com/css-validator.php.
Select the Layout tab in the top menu.

Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.
Select the layout to be updated or Create a Layout.

Tip

You can copy the URL of the layout editor and paste it into a new tab in your browser. This can be useful if you frequently switch between your Paligo content and the layout settings.
Select CSS, JS, logos and other assets in the sidebar.
In the CSS section, select Upload to display a file upload dialog.
Drag your custom CSS file from your computer's file system onto the file upload dialog.

Paligo uploads the CSS file to the Paligo server.

Note

You should only upload validated CSS files that have the .css file extension.
Select Save.

When you publish with this layout, Paligo will include your custom CSS in the output. When your content is opened in a browser, the browser will use your custom styles in preference to any styles that are included in the default Paligo CSS.

Upload Custom JavaScript to an eLearning Layout

You can use a third-party text or code editor to create a custom JavaScript file that alters your eLearning output. For example, you could use JavaScript to manipulate the published HTML or to provide extra functionality. You can then upload your JavaScript file to Paligo so that when you publish your content, the JavaScript is included (and referenced).

To upload a custom JavaScript file to a Paligo layout:

Make sure your custom JavaScript file is valid and has the .js file extension. There are many online tools for validating JavaScript, such as https://beautifytools.com/javascript-validator.php.
Select the Layout tab in the top menu.

Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.
Select the layout to be updated or Create a Layout.

Tip

You can copy the URL of the layout editor and paste it into a new tab in your browser. This can be useful if you frequently switch between your Paligo content and the layout settings.
Select CSS, JS, logos and other assets in the sidebar.
In the Custom JavaScript section, select Upload to display a file upload dialog.
Drag your custom JavaScript file from your computer's file system onto the file upload dialog.

Paligo uploads the JavaScript file to the Paligo server.

Note

You should only upload validated JavaScript files that have the .js file extension.
Select Save.

When you use this layout to publish your eLearning, Paligo will include your JavaScript file in the published package and set the HTML pages to reference it. Note that in the published output, your JavaScript is renamed to:

layout-custom-script.js

Set Paligo to Keep the Same CSS Filename

If you upload a CSS file to your eLearning layout, Paligo gives it a unique ID. This happens each time you upload a CSS file. For example, let's say you upload a file and Paligo gives it a unique ID. You then decide you need to make more changes, so you update the file outside Paligo and upload it again. This second upload is given a completely different ID to the first upload, and so, when you publish, the CSS file will have a different name. If you prefer, you can set Paligo to use a consistent file name (layout-custom-style.css) so that the CSS file name does not change.

To set Paligo to keep using the same CSS file name:

Select the Layout tab in the top menu.

Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.
Select the layout to be updated or Create a Layout.

Tip

You can copy the URL of the layout editor and paste it into a new tab in your browser. This can be useful if you frequently switch between your Paligo content and the layout settings.
Select CSS, JS, logos and other assets in the sidebar.
Set Persistent custom CSS filename to:
- Enable - Sets Paligo to keep the same file name for the CSS file. Paligo uses this file name:
```
layout-custom-style.css
```
- Disable - Sets Paligo to generate a new ID and file name each time you add a CSS file to the layout. If you select Disable, the CSS file in the output will have a randomly generated file name. The file name will change each time you replace the CSS file in the layout.
Select Save.

When you publish, Paligo will apply the setting you have chosen. If there is a custom CSS file in your output, it will be called 'layout-custom-style.css' if you chose Enable or it will have a random file name if you chose Disable.

Style the Progress Indicator

If a quiz renders the questions one by one, a progress indicator is shown in the upper left corner of the slide. By default the progress indicator is shown in a language neutral way (1 / 3).

This instruction shows how to override the default setting with a textual content (Question 1 of 3) for English and Swedish. You can add more or other language variants to the CSS, if using other languages than Swedish and English.

Add the follwing code to the CSS:

html[lang='en'] #quiz .quiz-progress .progress-current:before {
    content : 'Question ';
}

html[lang='en'] #quiz .quiz-progress .progress-divider:before {
    content: ' of ';
}

html[lang='en'] #quiz .quiz-progress .progress-max:after {
    content: ' : ';
}

html[lang='sv'] #quiz .quiz-progress .progress-current:before {
    content : 'Fråga ';
}

html[lang='sv'] #quiz .quiz-progress .progress-divider:before {
    content: ' av ';
}

html[lang='sv'] #quiz .quiz-progress .progress-max:after {
    content: ' : ';
}

This will update the progress bar to show:
- English: "Question 1 of 3"
- Swedish: "Fråga 1 av 3"

Always Show Progress Indicator

By default only quizzes that renders the questions one by one, shows a progress indicator. To override the default setting and get a progress indicator in all types of quizzes, add this code to the CSS:

#quiz.show-all .quiz-progress {
    display: block;
}

Style the Question Rendering

The default layout setting for quizzes in Paligo is to show the questions one by one. It is also possible to show them all at once. This can be styled in the eLearning layout configuration.

Tip

You can override the default setting (or a LE configured setting) for an individual quiz topic, by adding the role quiz-show-all or quiz-show-single to the qandaset element.

Element attributes. The qandaset element is selected and it has a role attribute with a value of quiz-show-all

To style the eLearning layout:

Select the Layout tab in the top menu.

Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.
Select the layout to be updated or Create a Layout.

Tip

You can copy the URL of the layout editor and paste it into a new tab in your browser. This can be useful if you frequently switch between your Paligo content and the layout settings.
Select Quizzes in the sidebar.
Select One by one or All from the menu.
Select Save.

Publish the eLearning

When your eLearning content is ready for release, you can publish it. Paligo will then generate an eLearning output that downloads as a zip file in your browser. You can then upload that zip file to your Learning Management System (LMS).

There are two stages to complete:

Publish using an eLearning Layout.
Upload the eLearning Output to your LMS.

Example of a Paligo eLearning course in an LMS.

Publish using an eLearning Layout

Paligo includes an eLearning layout that you can use for publishing. The layout contains a variety of settings that affect how Paligo processes your content when it converts it from Paligo XML into the eLearning output. This can be the default eLearning layout or a custom Elearning layout that you have created in Paligo, see Create an eLearning Layout.

Tip

To prepare your eLearning, see

Create an eLearning Publication
Add Information Topics for eLearning
Create a Quiz Topic
Organize the eLearning Publication.

To publish your eLearning:

Prepare your content in Paligo and make sure you add your topics to a publication.
Select the Dotted menu (...) to the right of the eLearning or SCORM (Basic) publication in the Content Manager.
Select Publish.
Select Elearning as output.
Select a publishing layout from the menu
Adjust the publishing settings:
- Languages - Choose which languages to publish to SCORM. Paligo will create a separate zip file output for each language.
- Profiling attributes - If you have used profiling (filters), choose which filters and values to include in the output.
- Variables - If you have used variables in your content, choose which variable set to use and which variants (values) to include in the output.
- Upload output - If you have Paligo set up to use a publishing integration, choose the service that Paligo will upload the output to, for example, GitHub.
- Optional parameters - Use to choose whether Paligo saves the output, includes a log file and link report, and notifies you via email.
Tip

For more details on these settings, see General Publishing Process.

You can also save your Publishing Settings so that you can select the saved version instead of re-applying all the filters, variables each time. Any settings you save can also be used for Batch Publishing.
Select Publish Document.

Paligo will process thecontent and apply your layout and publishing settings. The time it takes can vary depending on how much content you are publishing (the more content, the longer time it takes).

When the publishing process is finished, Paligo creates a zip file that downloads in your browser. There is a separate zip file for each language.
The next step is to Upload the eLearning Output to your LMS.

Tip

You can open the Paligo output in a browser to get an idea of how your eLearning content will work in a Learning Management System (LMS). Unzip the file and browse to the index.html file (for example, if you have an English SCORM output, look in the out>scorm-en folder). Open the index.html file in a browser. You will be able to preview your content, including any quizzes, but your score is not recorded like it would be if you ran the course in an LMS.

Upload the eLearning Output to your LMS

The zip file that Paligo produces for eLearning outputs is designed to be uploaded to a learning management system (LMS). There are many different LMS applications available and the procedure for uploading course content to them can vary. We recommend that you refer to the documentation for your LMS for details on how to upload courses.

Note

If you are unable to find suitable information and need further assistance, please contact Paligo customer support.

Articles in this section

eLearning Workflow

Create an eLearning Publication

Set a Minimum Passing Score

Override Passing Score on Publication Level

Tip

Note

Override Passing Score on Layout Level

Add Information Topics for eLearning

Create new eLearning topics

Note

Reuse existing topics in the eLearning

Tip

Quiz Topic

Note

Question Types

Create a Quiz Topic

Tip

Tip

Set Up a Numerical Question/Answer

Set Up a Multiple Choice Question/Answer

Note

Tip

Add More Questions to a Quiz

Note

Remove a Question from a Quiz

Remove an Answer from a Quiz

Example Quiz Topic

Note

Organize the eLearning Publication

Create an eLearning Layout

eLearning Layout Options

eLearning Styling

Tip

Add a Logo

Tip

Note

Set a Logo to Link to a Web Page

Tip

Note

Upload Custom CSS to an Elearning Layout

Tip

Tip

Note

Upload Custom JavaScript to an eLearning Layout

Tip

Note

Set Paligo to Keep the Same CSS Filename

Tip

Style the Progress Indicator

Always Show Progress Indicator

Style the Question Rendering

Tip

Tip

Publish the eLearning

Publish using an eLearning Layout

Tip

Tip

Tip

Upload the eLearning Output to your LMS

Note

Related articles