Articles in this section

See more

Highlight Unapproved Translations (PDF)

Avatar
Anders
  • Updated
Follow

Paligo has a color-marking feature for PDF output that shows unapproved translations as blue text. This is useful for spotting:

color-non-approved.png

To set your PDF output to show unapproved translations as blue text:

  1. Select Layout in the top menu.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.

  2. Select the Layout you want to update 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.

  3. Select General in the sidebar. New_Layout.jpg

    Select_General_PDF_small.jpg

  4. Select Language tabs.

  5. Use the Highlight non-approved translations setting to control whether unapproved translations are to be marked or not.

    • Enabled to highlight the non-approved translations with blue text.

    • Disabled to turn off the blue text color marking,

    • Default to inherit the value for this setting from the base Layout. The base Layout is either a built-in Layout provided by Paligo or another custom Layout, see Layout Relationships - Base, New, Duplicate.

    color-mark-non-approved-setting.png

  6. Select Save.

When you publish a document with this PDF layout, Paligo will apply the color marking, if you enabled it in the layout.

Example 13. Mark unapproved translations

Let's say you have content that is written in English and you publish to German. For the first release, you fully translate the content, enable color marking in the PDF layout, and then publish the content in both languages.

After the release, you make some updates to the English content. You do not translate the changes to German. You then publish to English and German without translating the changed content.

Result:

  • English version contains the old unchanged content + the new changed content.

  • German version contains translations of the old content. There are no translations for the new changes, so it uses the German translation for the old version of that content instead. At this point, the information in the English version is different to the information in the German version.

    In the PDF, content that is different in the German version compared to the English version is shown with blue text.

    color-non-approved.png

So if you see blue text in a translation, it means that the translation is unapproved or is out-of-date. You need to either approve the translation or get the content re-translated to include the updates.


Display Single Language Titles (PDF)

When publishing a multi-language PDF the front cover will by default repeat the title and subtitle for all included languages. You can set the layout to limit it to the first language in the language order.

For example, if you publish a multi-language PDF with English and German, the title and subtitle will show on the front cover in both languages.

Front_Cover_Translations.jpg

This PDF includes two languages, but the publication title is limited to only show one language. No subtitle is used.

Tip

To adjust the language order, see Set Language Order (PDF).

To adjust how your PDF layout display titles and subtitles on the front cover:

  1. Select Layout in the top menu.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.

  2. Select the Layout you want to update 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.

  3. Select Front page in the sidebar. New_Layout.jpg

    Front_Page_LE_small.jpg

  4. Select Title.

  5. Set Display a single language title to:

    • Enabled - The front cover will only show the publication name translated to the first language in the language order, see Set Language Order (PDF). The title is the name of the publication in the Publication Topic.

    • Disabled - The front cover will show multiple titles (one for each language).

    • Default to inherit the value for this setting from the base Layout. The base Layout is either a built-in Layout provided by Paligo or another custom Layout, see Layout Relationships - Base, New, Duplicate.

    Display_Single_Language_Title_small.jpg

  6. Select Subtitle.

  7. Set Display a single language subtitle to:

    • Enabled - The front cover will only show the subtitle translated to the first language in the language order, see Set Language Order (PDF). This is only used if a subtitle has been added to the Publication Topic.

    • Disabled - Sets the PDF to have multiple subtitles on the front cover (one for each language).

    • Default to inherit the value for this setting from the base Layout. The base Layout is either a built-in Layout provided by Paligo or another custom Layout, see Layout Relationships - Base, New, Duplicate.

    Display_Single_Language_Subtitle_small.jpg

  8. Select Save.

When you publish a multi-language document using this layout, the resulting PDF will use the title and subtitle settings you have chosen.

Include or Exclude Missing Translations (PDF)

By default, if you publish a document to PDF with missing translations, those parts are prefixed with the source language ISO code within square brackets, and the untranslated content is highlighted in red with a light pink background. You can set Paligo to exclude the missing translations and the readers will only see translated content.

For example, if you have a document written in English and translated into German. You write the content, get it translated, and then publish it in both languages. Later you decide to add a "Customer support" topic to the document, so you write that in English, and publish it in both languages, even though it has not been translated.

A page from a PDF output. It has German text in the header and Deutsch in a language sidebar. The title and content on the page is in English and each element has an [en] prefix. The English content is shown as red text with a light red background.

This results in the German version containing the "Customer support" topic in English and the elements on that page are prefixed with [en] and are highlighted in red with a light pink background.

To include or exclude missing translations from your PDF:

  1. Select Layout in the top menu.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.

  2. Select the Layout you want to update 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.

  3. Select General in the sidebar. New_Layout.jpg

    Select_General_PDF_small.jpg

  4. Select Language tabs.

  5. Use Hide missing translations to control whether to exclude or include the missing translations from the PDF. Choose either:

    • Disabled if you want Paligo to include the missing translations prefixed with the source language ISO code within square brackets and the untranslated content highlighted in red with a light pink background.

    • Enabled if you want Paligo to exclude the missing translations from the PDF.

    • Default to inherit the value for this setting from the base Layout. The base Layout is either a built-in Layout provided by Paligo or another custom Layout, see Layout Relationships - Base, New, Duplicate.

    Hide missing translations setting. It is set to default but also has enabled and disabled options.

  6. Select Save.

When you publish a document with this PDF layout, Paligo will include or exclude the missing translations, depending on your choice in the layout.

Set Up a Language List (PDF)

With a language list, you can show all of a document's languages on your front cover. You choose which languages to include when you apply the publishing settings and Paligo automatically updates the list to match.

Use the PDF Layout to control the positioning, order and style of the languages list.

  • For a multi-language PDF, a list of the included languages is arranged according to the language order, see Set Language Order (PDF).

  • For a single-language PDF, there is one entry in the language list.

Front cover for a PDF output. It has a list of languages in the top-right of the content area.
Language_List_Single_small.jpg

The images above show how the language list look both for a multi-language PDF and for a single-language PDF.

Tip

When publishing a multi-language PDF the front cover will by default repeat the translated elements for all included languages. You can limit it to only show the first language in the language order, see Display Single Language Titles (PDF).

To set up your language list:

  1. Select Layout in the top menu.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.

  2. Select the Layout you want to update 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.

  3. Select Front page in the sidebar. New_Layout.jpg

    Front_Page_LE_small.jpg

  4. Select Language list.

  5. Use the Generate language list setting to choose whether the languages are listed on the front cover.

    • Enabled - Adds the list of languages to the front cover. They are positioned in the top-right of the content area.

    • Disabled - The list of languages is not shown. This is the default setting.

    • Default to inherit the value for this setting from the base Layout. The base Layout is either a built-in Layout provided by Paligo or another custom Layout, see Layout Relationships - Base, New, Duplicate.

  6. Use the Language name format setting to choose how the languages are presented.

    • Language code - Each language is shown as the ISO 639-1 standard language code, for example, en for English, de for German, sv for Swedish.

    • Language local name - Each language is named, using the local spelling, for example, Deutsch for German and Svenska for Swedish.

    • Language name in English - Each language is named using the English spelling, for example, German, Swedish.

    • Language name in English - local name - Each language is named using the English spelling first, followed by a hyphen and then the local spelling, for example, German - Deutsch, Swedish - Svenska.

    • Language local name - name in English - Each language is named using the local spelling first, followed by a hyphen and then the English spelling, for example, Deutsch - German, Svenska - Swedish.

    Alternatively, choose Default to inherit the value for this setting from the parent Layout. To learn how a Layout can use values from another Layout, see Layout Relationships - Base, New, Duplicate.

  7. Use the Letter case for language names on the front cover setting to control the capitalization on the language names:

    • Upper case - Show language name in capital letters, for example, ENGLISH

    • Lower case - Show language name in lower case letters, for example, english

    • Capitalize first letter - Show language name with capital first letter, lower case for other letters, for example, English.

    • Default to inherit the value for this setting from the base Layout. The base Layout is either a built-in Layout provided by Paligo or another custom Layout, see Layout Relationships - Base, New, Duplicate.

  8. Set the Font size for language names.

    Enter either:

    • An absolute value with the units of measurement, for example, 14pt.

    • A relative value, such as 125%. This will size the text in relation to the size of the main body font.

  9. Set the Line height for language names. The line height is the amount of space between the language names.

    Enter one of these:

    • An absolute value with the units of measurement, for example, 14pt

    • A decimal value without a unit, for example 2.1 (this value is multiplied by the selected font size)

    • A relative value, such as 0.8em or 80%

    • normal. Sets the distance between the baselines of adjacent lines in the same paragraph to 120% of the font size.

    Leave the field blank to inherit this value from the base Layout (see Layout Relationships - Base, New, Duplicate).

  10. Set the Font weight for language names.

    Choose from the list of weight options. For example, extra light will produce characters drawn with a fine line and bold with produce characters drawn with a thicker line. To have effect the choice must be supported by the selected font family.

  11. Use Font style for language names to add or remove emphasis styling from the language name text. Choose Normal for regular text, Italic for forward leaning text, or Backslant for backwards-leaning text. To have effect the choice must be supported by the selected font family.

    Alternatively, select Default to inherit the value from the Layout's "base" Layout (see Layout Relationships - Base, New, Duplicate).

    Note

    Using Backslant can produce poor results, as many fonts do not support it as a separate outline.

  12. Set the Font color for language names.

  13. Clear the Use default color checkbox to select a color of your own choice.

  14. Set the color either by:

    • Entering an RGBA code for the color you want (1).

    • Selecting the Color square to display the color selector (2).

      1. Choose the color with the spectrum bar (3).

      2. Control the transparency with the opacity bar (4).

      3. Choose the color shade with the main color panel (5).

      Color selector. There is a field for entering an rgba value. It is labelled 1. There is a black square labelled 2. There is a popup dialog that contains three sections. The sections are labelled with numbers. Label 3 points to a narrow bar that shows the colors of the spectrum. Label 4 points towards an opacity bar ranging from black to transparent. Label 5 points to a color selector with various shades of a single color.

  15. Set the Alignment for language names.

    Choose from:

    • Left - Aligns the language names to the left.

    • Right - Aligns the language names to the right.

    • Start - Aligns the language names to the start side for the primary language of the document. This is left alignment for left-to-right languages such as English. For right-to-left languages, such as Arabic, the start alignment is to the right side.

    • End - Aligns the language names to the end side for the primary language of the document. This is right alignment for left-to-right languages such as English. For right-to-left languages, such as Arabic, the end alignment is to the left side.

  16. Set the Margin for language names. This is an indent from the edge of the main body area to the language name list.

    Enter an amount and its units of measurement, for example, 50pt.

    The indent is applied to the left or right margin that is closest to the text. For example, if you have the language list set to align to the left and you set a margin of 3em, Paligo will apply the 3em margin as an indent from the left side. If you set the language list to align to the right, Paligo will apply the 3em indent from the right side.

    Language list shown near to the right edge of the main body area. The body area edge is symbolised by a blue dotted line. There is a gap between the margin and the language list. A callout arrow points at the space.

  17. Select Save.

When you publish, Paligo will create a PDF with the language settings applied to the front cover.

Set Up Language Tabs (PDF)

If you are to publish a multi-language PDF, it can be a good idea to set up a sidebar with language tabs. The language tabs appear at the side edge of the page and show the name of the language used in that part of the PDF. This makes it easier for the user to find the part of the document that is in their language.

The Language local name and Language name in English are set when you Activate Languages or Create Additional Languages.

For example, let's say you have a multi-language PDF for English, German, French and Italian. When you publish, the English pages will have a tab marked "English", the German pages will have a tab marked "Deutsch" and so on.

language-tab-on-side.png

In this image, the language tabs are set to show the language local name in Uppercase.

Note

By default, the language tabs reuse the Language List settings until you select another option than Default. Then the setting becomes unique for the language tabs.

However, two of the language list options for the Language name format cannot be applied to language tabs:

  • Language name in English - local name

  • Language local name - name in English

If any of these two options is selected as the Language name format for language lists, it will automatically be converted to Language local name for the language tabs. This is because these options become too big for the language tabs.

Tip

By default Paligo uses the two-letter ISO language codes. If you want to use a four-letter code, see Create Additional Languages.

To set up your language tabs:

  1. Select Layout in the top menu.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.

  2. Select the Layout you want to update 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.

  3. Select General in the sidebar. New_Layout.jpg

    Select_General_PDF_small.jpg

  4. Select Language tabs.

  5. Use the Display language tabs setting to turn the feature on or off. Choose between:

    • Enabled to add language tabs on the reverse side of pages (verso side).

    • Disabled to remove the language tabs from the reverse side of pages.

    • Default to inherit the value for this setting from the base Layout. The base Layout is either a built-in Layout provided by Paligo or another custom Layout, see Layout Relationships - Base, New, Duplicate.

    Display_Language_Tabs_small.jpg

    Note

    For a double-sided PDF, you may need to add the language tabs to the reverse side of the pages, see step 6.

  6. Use the Display language tabs on verso pages to control if the tabs are shown on verso pages, when double-sided. Choose between:

    • Enabled to add language tabs on the reverse side of pages (verso side).

    • Disabled to remove the language tabs from the reverse side of pages.

    • Default to inherit the value for this setting from the base Layout. The base Layout is either a built-in Layout provided by Paligo or another custom Layout, see Layout Relationships - Base, New, Duplicate.

    Display_Language_Tabs_Verso_small.jpg

  7. Set the Language name format to control the way the language is displayed.

    • Language code according to the ISO language codes.

    • Language local name uses the native name of the language. For example, Deutsch for German and Svenska for Swedish.

    • Language name in English is the English name of the language.

    • Default to inherit the value from the Language List setting.

    Language_Name_Format_small.jpg

  8. Set the Letter case for language name in tabs. You can choose from:

    • Upper case - The language name is shown in capital letters in the language tabs (for example DEUTSCH).

    • Lower case - The language name is shown in lower case letters in the language tabs (for example deutsch).

    • Capitalize - The first letter of the language name is shown in capital letter and the other letters are shown in lower case (for example Deutsch).

    • Default to inherit the value from the Language List setting.

    Letter_Case_Language_Name_In_Tabs_small.jpg

  9. Use the Distance from the top of the topmost language tab to the top of the page setting to control the topmost vertical position. Enter the amount in inches and do not include the units of measurement, for example, 1.85.

    Distance from the top of the topmost language tab to the top of the page setting. Enter the amount in inches.

  10. Set the Height of a language tab amount to define the vertical size of the language sidebar. Enter the amount in inches and do not include the units of measurement.

    Height of a language tab setting. Enter the amount in inches.

  11. Set the Gap between language tabs in inches.

    Gap between language tabs setting. Enter the spacing in inches.

    For example, if you set the gap to 1 inch for a multi-language PDF with German, English, Spanish and French:

    • The German tab appears at the topmost position.

    • The English tab appears 1 inch lower than the German tab.

    • The Spanish tab appears 1 inch lower than the English tab.

    • The French tab appears 1 inch lower than the Spanish tab.

    Diagram showing the page edges from a PDF output. There are sidebars for German, English, Spanish, and French. German is highest, English is 1 inch lower, Spanish is another inch lower, and French is another inch lower.

    In a printed version of the content, this "cascading" effect makes it easier for users to find the language they need.

  12. Use the Width of a language tab setting to define the horizontal size of the language tabs. Enter an amount in inches, for example, 0.45. Do not enter the units of measurement.

    Width of a language tab setting. Enter the amount in inches.

  13. Use the Rounded corners for language tabs: radius setting to control the inner corners of the language sidebar. By default, the inner corners are straight-edged but you can set them to be rounded instead.

    PDF layout, Rounded corners for language tabs: radius setting. It has a value of 10pt.

    • To use rounded corners, enter an amount and include the units of measurement, for example, 10pt.

    • To disable rounded corners, clear the field so that it uses the default of 0pt.

    Two language tabs. One is a rectangle with 90 degree corners. The other is a rectangle with curved left corners (top and bottom).

  14. Use the Background color for language tabs to control the color of the tab. The default color is black.

    The text in the language tab is white, so choose a darker background color to get a suitable amount of contrast.

    bg-color-for-language-tabs.png

  15. Clear the Use default color checkbox to select a color of your own choice.

  16. Set the color either by:

    • Entering an RGBA code for the color you want (1).

    • Selecting the Color square to display the color selector (2).

      1. Choose the color with the spectrum bar (3).

      2. Control the transparency with the opacity bar (4).

      3. Choose the color shade with the main color panel (5).

      Color selector. There is a field for entering an rgba value. It is labelled 1. There is a black square labelled 2. There is a popup dialog that contains three sections. The sections are labelled with numbers. Label 3 points to a narrow bar that shows the colors of the spectrum. Label 4 points towards an opacity bar ranging from black to transparent. Label 5 points to a color selector with various shades of a single color.

  17. Select Save.

When you publish multi-language content with this PDF layout, the resulting PDF will use the language sidebar settings you have chosen.

Set Language Order (PDF)

Use the layout setting Language order to control how the languages are arranged in your multi-language PDF. It determines:

  • The way the publication title and subtitle translations are arranged on the front cover. By default, all translations are shown. However, you can set the layout to limit it to the first language in the language order, see Display Single Language Titles (PDF).

  • The way the language list is arranged on the front cover (top-right corner).

  • The way the translated content appears in the multi-language PDF.

Front_Cover_Translations.jpg

This PDF includes two languages, but the publication title is limited to only show one language. No subtitle is used.

To set the language order for your multi-language PDF:

  1. Select Layout in the top menu.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.

  2. Select the Layout you want to update 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.

  3. Select General in the sidebar. New_Layout.jpg

    Select_General_PDF_small.jpg

  4. Select Language tabs.

  5. Define the Language order by entering the two-letter ISO language code for each language. Use spaces to separate the languages.

    For example: de en es fr will result in German first, English second, Spanish third and French fourth.

    Language order setting. It is a field and the value has been set as de en es fr. These are the ISO codes for German, English, Spanish, and French.

  6. Select Save.

When you publish a combined language output with this layout, the resulting PDF will have the languages in the order you specified.

Related articles

Comments

0 comments

Article is closed for comments.

Powered by Zendesk