Articles in this section

See more

Cross-Reference Settings

Avatar
Anders
  • Updated
Follow

In the Layout Editor there are some layout options for cross-references for both HTML5 and PDF output. You can customize the information included in auto-titles, make external links open in a separate tab and more. An auto-title is the text that appears when a cross-reference is added.

To customize cross-references for HTML5 output:

  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 Cross-references in the sidebar.

    Cross-references_menu_Layout_options.png

  4. In Enable cross-reference auto-title customization select:

    • Enable to activate auto-title customization.

    • Disable to deactivate the possibility to customize auto-titles. Default

    Enable_cross-reference_auto-title_customization.png

  5. Add keywords in Cross-reference auto-title to customize cross-references for topics.

    Default is title page.

    Cross-reference_auto-title.jpg

  6. Add keywords in Cross-reference auto-title for formal elements to customize the cross-references for lists, figures, tables, equations and examples.

    Default is label quotedtitle nopage.

    Cross-reference_auto-title_for_formal_elements.jpg

  7. Add keywords in Cross-reference auto-title for appendices to customize the cross-references for appendices.

    Default is label title page.

    Cross-reference_auto-title_for_appendices.jpg

  8. Enter a character (or a combination of characters) in Cross-reference label / title separator to customize the separator.

    Default is :s which adds a colon and a space between the label and title.

    Cross-reference_label_title_separator.jpg

    The separator is the character between the label and title.

    Tip

    Examples of characters that can be used:

    • Hyphen -

    • Space s

    • Colon :

  9. Choose how to open external links in Open external website links in new tab or window.

    • _blank - The link will open in a new tab (or on older browsers a new window). Default

    • _self - The link will be opened in current tab or window.

    • _parent - The link will be opened in the parent frame. Frames are deprecated in HTML5.

    • _top - The link breaks out of all frames and opens in the current tab or window. Frames are deprecated in HTML5.

    Open_external_website_links_in_new_tab_or_window.jpg

  10. Set Add rel = noopener to external links that open in new tab or window to:

    • Enable to force external links to open in a new tab. Default.

    • Disable to stop external links to open a new tab and instead open the link in current tab.

    Add_rel_noopener_to_external_links_that_open_in_new_tab_or_window.jpg

    Warning

    Due to security reasons this option is always enabled when "Open external website links in new tab or window" is set to _blank .

  11. Set Use angle bracket delimiters around email to:

    • Enable to use delimiters around email addresses. Default

    • Disable if delimiters are not be used.

    Use_angel_bracket_delimiters_around_email.jpg

  12. Select Save.

Keywords for Auto-title Customization

By using the keywords below, you can customize the auto-titles for cross-references. As with all auto-text, the keywords will be translated automatically when you publish to another language.

An auto-title can consist of one or more keywords. Add a space between each keyword. The order of the keywords does not matter. Paligo will automatically rearrange the components as follows (depending on which you use):

  1. label

  2. title

  3. page (only for PDF output)

Example 4. Quoted text with page number and label

labelname quotedtitle page

Result: Section "My Topic Title" (page 15).


Tip

You can override the format for individual cross-references by using the xrefstyle attribute. In that case, use the same values, but start with "select: ". For example, select: quotedtitle nopage.

Component

Keyword

Example

Description

label

label

Table 3

Complete label name and number.

labelname

Table

Only the label name.

labelnumber

3

Only the label number.

title

title

My Topic Title

Title without quotes.

quotedtitle

"My Topic Title"

Title in quotes.

page

unspecified

[12]

Standard page citation if no value is given for the page component.

page

(page 12)

Page number in parentheses.

pagecomma

, page 12

Page number after a comma.

Note that this format may be unsuitable for some languages. Some languages use commas in a different way.

Page

Page 12

Capitalized page label.

pageabbrev

(p. 12)

Abbreviated label in parentheses.

pageabbrevcomma

, p. 12

Page number after a comma and page abbreviated.

This option does not work with all languages. Make sure you check for languages you translate to.

In many cases, languages can be added with a request to support.

pagenumber

12

Only the page number.

nopage

 Turn off the page number for the cross-reference.

Comments

0 comments

Article is closed for comments.

Powered by Zendesk