Jump to main content
Oxygen XML Logo DITA-OT CSS Publishing to PDF Plugin
Oxygen DITA-OT CSS-based PDF Publishing plugin 21.0 User Guide
  • Overview
  • Publishing Templates
  • DITA-OT Extension Points
  • Customization CSS
  • Controlling the Publication Content
  • Troubleshooting
Index
  1. Home
  2. Customization 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

  • Publishing Templates

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

  • DITA-OT Extension Points

    Information about expanding the functionality through DITA-OT Extensions

  • Customization CSS

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

    • Debugging the CSS
    • Default Page Definitions
    • Page Size
    • Metadata
    • Cover (Title) Page
    • Front Matter and Back Matter
    • Numbering
    • Double Side Pagination
    • Multiple Column Pages
    • Table of Contents
    • PDF Bookmarks
    • Page Headers and Footers
    • Index
    • Footnotes
    • Page Breaks
    • Hyphenation
    • Accessibility
    • Fonts
    • Localization
    • Comments and Tracked Changes
    • Draft Watermarks
    • Styling the Content
      • Reusing the Styling for WebHelp and PDF Output
      • Lists
      • Links
      • Images and Figures
      • Tables
      • Code Blocks
      • Notes
      • Abbreviated Forms
    • Styling Through Custom Parameters
  • Controlling the Publication Content

    Explains how using a bookmap offers more control over the output

  • Troubleshooting

    Information about fixing publishing issues

  • Glossary
  • Copyright

    Legal information

Links
Edit online

Links allow the users to navigate through the documentation.

How to Remove 'on page NNN' Link Label
Edit online

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, add the following in your customization CSS:

*[class ~= "topic/xref"][href]:after,
*[class ~= "topic/link"][href]:after {
    content: none;
}

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;
}

How to Change Link Styles
Edit online

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;
}

How to Hide Descriptions in Related Links Sections
Edit online

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;
}
On this page
  • How to Remove 'on page NNN' Link Label
  • How to Change Link Styles
  • How to Hide Descriptions in Related Links Sections