20.9 Linking to destinations within topics

After you convert a DITA document, you might find that anchors are missing for links to destinations located within topic files. By default, for JavaHelp these anchors are suppressed, as a workaround for a JavaHelp 1 defect: very bad things happen in the JavaHelp viewer if you try to use destination anchors within topic files. In JavaHelp 1, you can safely use references only to the start of a topic file.

Internal references are not a problem in JavaHelp 2, nor in Oracle Help for Java. On the other hand, in JavaHelp, every anchor causes an extra space in text when you view output with the JavaHelp viewer.

To allow internal references for JavaHelp 1:

[JavaHelpOptions] or [OracleHelpOptions]
; RemoveInternalAnchors = Yes (JavaHelp 1 default, avoid JavaHelp bug)
;  or No (Oracle Help and JavaHelp 2 default)
RemoveInternalAnchors = No

Previous Topic:  20.8.3 Jumping to secondary windows in JavaHelp or Oracle Help

Next Topic:  20.10 Creating ALinks for Oracle Help

Parent Topic:  20. Generating JavaHelp or Oracle Help

Sibling Topics:

20.1 Deciding which Java Help system to use

20.2 Obtaining tools for a Java-based Help system

20.3 Setting up a JavaHelp or Oracle Help project

20.4 Generating contents and index

20.5 Providing full-text search for JavaHelp / Oracle Help

20.6 Creating and viewing a Java Archive (JAR) file

20.7 Converting a glossary to JavaHelp 2

20.8 Defining windows for JavaHelp or Oracle Help

20.10 Creating ALinks for Oracle Help

20.11 Merging JavaHelp or Oracle Help systems

20.12 Setting up CSH for JavaHelp or Oracle Help

Table of ContentsIndex