Jump to main content
Oxygen XML Logo XML Developer Eclipse Plugin
Oxygen XML Developer Eclipse Plugin 27.1 User Guide
  • Getting Started
  • Editing Supported Document Types
  • Working with XPath Expressions
  • XSLT/XQuery Debugging
  • Tools
  • Scripting Oxygen
Index
  1. Home
  2. Publishing

    Details about transformation scenarios and customizing various types of output

  3. DITA to PDF Output Customization
  4. CSS-based PDF Customization
  5. Customizing PDF Output Using CSS

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

  6. Styling the Content
  7. Links
  • Introduction

    Welcome to the User Manual of Oxygen XML Developer Eclipse plugin 27.1

  • Getting Started

    Information and resources to help you get started using Oxygen XML Developer Eclipse plugin as quickly as possible

  • Installation

    The requirements and installation instructions for each platform

  • Configuration

    Description of all of the options that allow you to configure Oxygen XML Developer Eclipse plugin

  • Perspectives

    The Editor, XSLT Debugger, XQuery Debugger, and Database perspectives

  • Editing Modes

    The Text, Grid, , and Schema Design editing modes

  • Working With Documents

    General information about features available when working with documents

  • Editing Supported Document Types

    Details about the various types of supported documents and their unique editing features

  • Built-in Frameworks (Document Types)

    The editing frameworks that are supported in Oxygen XML Developer Eclipse plugin

  • Additional XML Editing Frameworks (Document Types)

    The custom frameworks that are supported in Oxygen XML Developer Eclipse plugin

  • Publishing

    Details about transformation scenarios and customizing various types of output

    • Transformation Scenarios
    • WebHelp Output Customization
    • DITA to PDF Output Customization
      • CSS-based PDF Customization
        • 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

      • XSL-FO to PDF Customization
    • DocBook to PDF Output Customization
  • Working with XPath Expressions

    Information about using XPath Expressions in Oxygen XML Developer Eclipse plugin

  • Working with Archives

    Describes how to use the Archive Browser to work with various type of archives

  • Databases and SharePoint

    Connecting to supported databases and integrating Oxygen XML Developer Eclipse plugin with SharePoint

  • Importing Data

    Information about how to import data from external sources into XML documents

  • XSLT/XQuery Debugging

    The debugging interface that detects problems with XSLT and XQuery transformations

  • Extension Points for the Oxygen Eclipse Plugin

    A list of extension points available for the Oxygen Eclipse plugin

  • Tools

    Specifics about the various tools that are included in Oxygen XML Developer Eclipse plugin

  • Troubleshooting

    A compilation of common problems and their solutions

  • Scripting Oxygen

    Details about the scripting possibilities that are available with Oxygen XML Developer Eclipse plugin

  • 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