XHTML output that will work as input to Confluence requires a different syntax for links, and several special settings. Thanks to research by Robert Lauriston, DITA2Go provides a way to produce the required markup. See:
https://confluence.atlassian.com/display/DOC/Confluence+Storage+Format
To direct DITA2Go to produce XHTML for Confluence 4.x:
[HTMLOptions] ; Confluence = No (default, use normal linking) ; or Yes (make Confluence links) Confluence = Yes
When Confluence=Yes, DITA2Go automatically sets the options listed in Table 22-2. You can override these individually if necessary.
[HTMLOptions] |
ConfluenceLinks |
Yes |
|
RemoveANames |
Yes |
||
NoLocations |
Yes |
||
NoFonts |
Yes |
||
UseHash |
No |
||
AlignAttributes |
No |
||
UseXMLDeclaration |
No |
||
UseDOCTYPE |
No |
||
UseHeadAndBody |
No |
||
[CSS] |
UseCSS |
No |
|
UseSpanAsDefault |
No |
To configure Confluence links:
[HTMLOptions] ; ConfluenceLinks = No (default, use normal links) ; or Yes (use the link parts specified below) ConfluenceLinks = Yes ; These are the default parts for Confluence links: ConfluenceLinkStart = <ac:link> ConfluenceLinkPage = <ri:page ri:content-title=" ConfluenceLinkPageEnd = "/> ConfluenceLinkText = <ac:link-body> ConfluenceLinkTextEnd = </ac:link-body> ConfluenceLinkEnd = </ac:link>
When ConfluenceLinks=Yes, the remaining ConfluenceLink* settings are in effect.
Note: The XHTML files you produce with DITA2Go must be imported into Confluence one at a time. As of this writing, no batch import utility is available.