Introduction
Welcome to the User Manual of Oxygen XML Author Eclipse plugin 27.1
Getting Started
Information and resources to help you get started using Oxygen XML Author 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 Author Eclipse plugin
Perspectives
The Editor and Database perspectives
Editing Modes
The Text, Grid, and Author 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 Author Eclipse plugin
Additional XML Editing Frameworks (Document Types)
The custom frameworks that are supported in Oxygen XML Author Eclipse plugin
Publishing
Details about transformation scenarios and customizing various types of output
Working with XPath Expressions
Information about using XPath Expressions in Oxygen XML Author 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 Author Eclipse plugin with SharePoint
Importing Data
Information about how to import data from external sources into XML documents
Framework and Author Mode Customization
Tutorials and details about customizing frameworks and the visual Author editing mode
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 Author Eclipse plugin
Troubleshooting
A compilation of common problems and their solutions
- Performance Problems and Solutions
- Misc Problems and Solutions
DITA Authoring
A guide to help content authors who create and publish DITA content
Scripting Oxygen
Details about the scripting possibilities that are available with Oxygen XML Author Eclipse plugin
Glossary
Copyright
Legal information

DITA Map WebHelp Transformation Fails (Duplicate Topic References Found)

Problem

DITA Map WebHelp transformation fails with a message that indicates duplicate topic references were found.

Cause

By default the WebHelp transformation uses the force-unique parameter set to true to force the transformation to create unique output files for each instance of a resource when a map contains multiple references to a single topic. However, there are cases when this feature does not work as expected and the duplicate topic references are not handled properly.

Solution

To solve this issue, you should manually set a unique @copy-to attribute on any duplicate topic reference that was not handled automatically by DITA-OT:

<map>
...
  <topicref href="../topics/MyTopic.dita"/>
...
  <topicref href="../topics/MyTopic.dita" copy-to="../topics/MyTopic-2.dita"/>
</map>