Jump to main content
Oxygen XML Logo Publishing Engine
Oxygen Publishing Engine 27.1 User Guide
  • Getting Started
  • WebHelp Customization
  • PDF Customization
  • Zendesk Publishing
  • Dynamic Word, Excel, OpenAPI, HTML, Markdown to DITA Conversion
Index
  1. Home
  2. PDF Customization

    Numerous topics explaining how to customize CSS-based PDF output

  3. Customizing PDF Output Using CSS

    Numerous topics that provide instructions for how to customize your PDF output

  4. Styling the Content
  5. Links
  • Getting Started

    Information about installing, licensing, and running the Oxygen Publishing Engine

  • WebHelp Customization

    Numerous topics explaining how to customize WebHelp Responsive output

  • PDF Customization

    Numerous topics explaining how to customize CSS-based PDF output

    • Overview

      A basic overview, technical details, and additional resources to help you get started

    • Generating PDF Output

      Information about generating PDF output using a command line tool or integration server

    • Publishing Templates

      Explains how to use Oxygen Publishing Templates to define the layout and style of the output

    • Customizing PDF Output Using CSS

      Numerous topics that provide instructions for how to customize your PDF output

      • Debugging the CSS
      • Default Page Definitions
      • Page Size
      • Page Headers and Footers
      • Page Breaks
      • Cover (Title) Page
      • Metadata
      • Front Matter and Back Matter
      • Numbering
      • Table of Contents
      • Table of Contents on a Page (Mini TOC)
      • List of Tables/Figures
      • Double Side Pagination
      • Multiple Column Pages
      • Bookmarks
      • Index
      • Appendices
      • Footnotes
      • Hyphenation
      • Accessibility
      • Archiving
      • Fonts
      • Comments, Highlights, and Tracked Changes
      • Draft Watermarks
      • Flagging Content
      • Styling the Content
        • Reusing the Styling for WebHelp and PDF Output
        • Titles
        • Equations
        • Lists
        • Links
        • Images and Figures
        • Videos
        • Tables
        • Programming Elements
        • Notes
        • Hazard
        • Tasks
        • Abbreviated Forms
        • Trademarks
      • Styling Through Custom Parameters
    • Controlling the Publication Content

      Explains how to control the output using a bookmap or additional parameters

    • XSLT Extensions for PDF Transformations

      Information about using XSLT extensions to customize PDF output

    • DITA-OT Extension Points

      Information about expanding the functionality through DITA-OT Extensions

    • Localization

      Information about configuring the language for PDF output

    • Security

      Details about how to set security permissions to protect PDF files

    • Troubleshooting

      Information about fixing publishing issues

  • Zendesk Publishing

    Details about how to publish content to the Zendesk Help Center

  • Dynamic Word, Excel, OpenAPI, HTML, Markdown to DITA Conversion

    Information about how to convert various types of non-DITA resources to DITA during publishing

  • Glossary
  • Copyright

    Legal information

Edit online

Links

Links allow the users to navigate through the documentation.

Edit online

How to Change 'on page NNN' Link Label

For printed material, it is usually desirable for the links to display a label after the text content (such as "on page 54"). This makes it easier the user to identify the target page. However, if the produced PDF is not printed and is intended only for electronic use, this label may create clutter and make the document harder to read. To eliminate this label, you can simply disable the args.css.param.show-onpage-lbl parameter.

This can also be done by adding the following in your customization CSS:

*[class ~= "topic/xref"][href]:after,
*[class ~= "topic/link"][href]:after {
    content: none !important;
}
Note:
A variant is to remove the "on page" label only and keep the page number:
*[class ~= "topic/xref"][href]:after,
*[class ~= "topic/link"][href]:after {
    content: " (" target-counter(attr(href), page) ")" !important;
}

Another use-case is to remove the labels only from links shown in tables cells, and leave the others as they are. For this, you could use a more specific selector:

*[class ~= "topic/entry"] *[class ~= "topic/xref"][href]:after{
    content: none !important;
}
Edit online

How to Change Link Styles

Suppose you want the links to be bold and with an underline. In your customization CSS, add this snippet:

*[class ~= "topic/xref"][href]:after,
*[class ~= "topic/link"][href]:after {
    font-weight: bold;
    text-decoration: underline;
}
Edit online

How to Hide Descriptions in Related Links Sections

The link descriptions that come from DITA relationship tables or related link elements within topics, are structured in the merged map like this:

<related-links class="- topic/related-links ">
   <linkpool class="- topic/linkpool ">
        <link class="- topic/link " 
            ...
               role="friend" scope="local" type="topic">
                <linktext class="- topic/linktext ">Salvia</linktext>
                <desc class="- topic/desc ">The salvia plant</desc>
          </link>
    </linkpool>
    ...
</related-links>

If you need to hide these descriptions, add the following code in your customization CSS:

*[class ~= "topic/link"] > *[class ~= "topic/desc"] {
  display: none;
}
Edit online

How to Group Related Links by Type

By default, all links from DITA relationship tables or related link elements within topics are grouped under one "Related information" heading:
Related information
  Target Topic
  Target Concept
  Target Task
It is possible to group the links by target type (topic type) by setting the args.rellinks.group.mode=group-by-type parameter. The output will look like this:
Related concepts
  Target Concept
Related tasks
  Target Task
Related information
  Target Topic
On this page
  • How to Change 'on page NNN' Link Label
  • How to Change Link Styles
  • How to Hide Descriptions in Related Links Sections
  • How to Group Related Links by Type
Oxygen on Facebook Follow Oxygen on Twitter Oxygen Web Feed Oxygen Blog Oxygen Youtube Channel
© 2002-2025 SyncRO Soft SRL. All rights reserved.
Index Terms | Copyright | Glossary Terms of Use | Privacy Policy

This website was created & generated with <oXygen/>®XML Editor