If you are going to publish content in multiple languages to PDF, you can use the PDF layout to:
We also explain what it means if you have:
If you see blue text in your PDF output, it may be because you have the color mark non-approved translations setting enabled in your PDF layout. This feature sets Paligo to use blue text for translated content that has not been approved. For more details, see Color Mark Unapproved Translations for PDF.
Paligo has a color-marking feature for PDF outputs that shows unapproved translations as blue text. This is useful for spotting unapproved translations that may be out-of-date as the source language content has been updated.
Note
Typically, blue text in a translation means that the translation is out-of-date and needs to be re-translated. But it could also be that the translation is up-to-date but has not been approved before publishing. We recommend that you approve translations when they are complete and then publish after they are approved (see Workflow for Translation Service).
To set your PDF output to show unapproved translations as blue text:
-
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 you want to update or Create a Layout.
-
Select General > Languages.
-
If you want to color mark the non-approved translations, set Color mark non-approved transitions to Enabled. To turn off the blue text color marking, set it to Disabled.
-
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 80. 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.
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.
By default, if you publish a document to PDF and that document has missing translations, those parts are included in the source language. If you prefer, you can set Paligo to exclude the missing translations so that readers only see the content that has been translated.
For example, let's say you have a document that is written in English and translated into German. You write the content, get it translated and then publish it to both languages. Later you decide to add a "Customer support" topic to the document, so you write that in English, and publish it to both languages, even though it has not been translated.
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 shown in red with a pale red highlight.
If you prefer to hide untranslated content, you can choose to exclude it in the PDF layout settings:
-
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 you want to update or Create a Layout.
-
Select General > Languages.
-
Set Hide missing translations to Enabled if you want Paligo to exclude the missing translations from the PDF.
Set it to Disabled if you want Paligo to include the missing translations, so that they appear in the source language. If you select Disabled, missing translations will have the source language ISO code in square brackets as a prefix and the untranslated content is in red with a light red background.
-
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.
If you have content in multiple languages, you can create a "combined language" PDF. A combined language PDF has your content in multiple languages all in the same PDF file.
For example, If the single PDF includes English, German and Spanish translations, you can choose to add the languages on the front cover.
If you choose to add the languages, you can get the front cover to show:
-
A list of the included languages (for combined language PDFs)
-
The name of the language (for single language PDFs).
Tip
Paligo also have settings that let you add the title and subtitle in multiple languages, see Set Multi-Language Preferences (PDF).
To add a language list to the front cover of a PDF:
-
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 you want to update or Create a Layout.
-
Select Front Page and then select Languages.
-
Use the Display 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.
-
-
Use the Language 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.
-
-
Use the Letter case for language names 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.
-
-
Select Save.
When you publish, Paligo will create a PDF with the language settings applied to the front cover.
If you see red text with a pale red background in your PDF outputs, it may be due to the Hide missing translations setting in the PDF layout.
If you have it disabled, Paligo will insert the source language content in place of any missing translations. The source language content is red with a pale red background and has the ISO language code in square brackets as a prefix.
For more details, see Include or Exclude Missing Translations (PDF).
Use the PDF layout's Language order setting to control the order of languages in a PDF output. The language order applies to:
-
The order of the languages in a multi-language PDF
-
The order of the named languages and translated elements such as subtitles on the front cover.
To set the language order:
-
Select Layout and then edit the PDF layout you are going to use for publishing. Alternatively, you can create a new PDF layout and edit that.
-
Select General > Languages.
-
Define the Language order. Enter the ISO code letters for each language and use spaces to separate the languages. For example, de en es fr will result in German first, English second, Spanish third, and French fourth.
-
Select Save.
When you publish a combined language output with this layout, the resulting PDF will have the languages in the order you specified.
By default, when you publish a combined-language PDF, the front cover includes the subtitle in each language. For example, if you publish a single PDF to include English, German, and French, the subtitle will be shown on the front cover in all three languages. If you prefer, you can set Paligo to include the subtitle only once, in the first language included in the PDF.
To set the subtitle to appear on the front cover once, in the first language of the document:
-
Select Layout and then edit the PDF layout you are going to use for publishing. Alternatively, you can create a new PDF layout and edit that.
-
Select General > Languages.
-
Set the Display single language subtitle on the front cover in combined language PDF to:
-
Enabled
Sets the PDF to have one subtitle on the front cover. It will be in the first language for the document.
-
Disabled
Sets the PDF to have multiple subtitles on the front cover (one for each language).
Tip
You can control the order of the languages in a PDF, see Set the Order of Languages in PDF.
-
-
Select Save.
When you publish a multi-language document using this layout, the resulting PDF will use the subtitle settings you have chosen.
Tip
You can also Set the Title to Appear in One Language (PDF).
By default, when you publish a combined-language PDF, the front cover includes the title in each language. For example, if you publish a single PDF to include English, German, and French, the title will be shown on the front cover in all three languages. If you prefer, you can set Paligo to include the title only once, in the first language included in the PDF.
To set the title to appear on the front cover once, in the first language of the document:
-
Select Layout and then edit the PDF layout you are going to use for publishing. Alternatively, you can create a new PDF layout and edit that.
-
Select General > Languages.
-
Set the Display single language title on the front cover in combined language PDF to:
-
Enabled
Sets the PDF to have one title on the front cover. It will be in the first language for the document.
-
Disabled
Sets the PDF to have multiple titles on the front cover (one for each language).
Tip
You can control the order of the languages in a PDF, see Set the Order of Languages in PDF.
-
-
Select Save.
When you publish a multi-language document using this layout, the resulting PDF will use the title settings you have chosen.
Tip
You can also Set the Subtitle to Appear in One Language (PDF).
If you are going to publish a combined language PDF, it can be a good idea to set up a language sidebar. The sidebar is a block that appears at the side edge of the page and it shows the name of the language used in that part of the PDF. For example, let's say you have a combined 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. The main benefit of language sidebars is that they make it easier for users to find the section of the document that is in their language.
To set up a language sidebar:
-
Select Layout and then edit the PDF layout you are going to use for publishing. Alternatively, you can create a new PDF layout and edit that.
-
Select General > Languages.
-
Use the Display language name on sidebar setting to add or remove a language sidebar.
-
Select Enabled to add a language sidebar.
-
Select Disabled to remove a language sidebar.
-
-
Use the Display language name on sidebar on verso (left) pages setting to add a language sidebar to the reverse side of pages (left side). This applies for double-sided PDFs.
-
Select Enabled to add a language sidebar.
-
Select Disabled to remove a language sidebar.
-
-
Set the Letter case for language names. You can choose from:
-
Upper case
The language name is shown in capital letters in the language sidebar, for example, DEUTSCH.
-
Lower case
The language name is shown in lower case letters in the language sidebar, for example, deutsch.
-
Capitalize first letter
The first letter of the language name is shown in capital letters and the other letters are shown in lower case, for example, Deutsch.
-
-
Use the Distance from the top of the topmost language tab to the top of the page setting to control the vertical position of the sidebar. Enter the amount in inches and do not include the units of measurement, for example, 1.85.
-
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.
-
Set the Gap between language tabs amount in inches to stagger the position of the language sidebar for each language.
For example, let's say you have a document that contains German, English, Spanish, and French. You set the gap to 1 inch. In the output, the German section has a German sidebar and it appears near the top. In the English section, there is an English language sidebar and it appears 1 inch lower than the German language sidebar. Similarly, the Spanish sidebar appears 1 inch lower than the English sidebar, and the French sidebar is 1 inch lower than the Spanish sidebar. In a printed version of the content, this "cascading" effect makes it easier for users to find the language they need.
-
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.
-
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.
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.
-
Use the Background color for language tabs setting to set the background color. The default is black. To choose a different color, clear the Use default color checkbox. You can then either enter an rgba value in the field or select the color block to display a color selector and use that to choose the color.
-
Select Save.
When you publish multi-language content with this PDF layout, the resulting PDF will use the language sidebar settings you have chosen.
Comments
0 comments
Article is closed for comments.