Jump to main content
Oxygen XML Logo DITA-OT CSS Publishing to PDF Plugin
Oxygen DITA-OT CSS-based PDF Publishing plugin 27.1 User Guide
  • Overview
  • Generating PDF Output
  • Publishing Templates
  • Customizing PDF Output Using CSS
  • Controlling the Publication Content
  • XSLT Extensions for PDF Transformations
  • DITA-OT Extension Points
  • Localization
  • Security
  • Troubleshooting
Index
  1. Home
  2. Customizing PDF Output Using CSS

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

  3. Styling the Content
  4. Links
  • 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

  • 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