22.9 Generating XHTML for Confluence 4.x

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-1. You can override these individually if necessary.

Table 22-1 Default options for Confluence 4.x XHTML

Configuration section

Setting

Value

Reference

[HTMLOptions]
ConfluenceLinks
Yes

22.9

RemoveANames
Yes

23.4

NoLocations
Yes

28.3.2

NoFonts
Yes

30.5.2

UseHash
No

23.4

AlignAttributes
No

30.2.3

UseXMLDeclaration
No

22.4.7

UseDOCTYPE
No

22.4.1

UseHeadAndBody
No

22.4.7

[CSS]
UseCSS
No

31.4.1

UseSpanAsDefault
No

31.7.3

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.

Previous Topic:  22.8 Providing hover text for links in HTML

Next Topic:  22.10 Exporting content for database input

Parent Topic:  22. Converting to HTML/XHTML

Sibling Topics:

22.1 Deciding which type of output to produce

22.2 Setting up an HTML project

22.3 Including starting code and entity references

22.4 Supplying values for the <head> element

22.5 Specifying HTML <body> attributes

22.6 Specifying document-wide properties for HTML

22.7 Importing HTML files as insets

22.8 Providing hover text for links in HTML

22.10 Exporting content for database input

22.11 Specifying a starting topic for HTML or XHTML

22.12 Using framesets

22.13 Passing W3C validation tests