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

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

Configuration section

Setting

Value

Reference

[HTMLOptions]

ConfluenceLinks

Yes

22.10

RemoveANames

Yes

23.4

NoLocations

Yes

28.3.2

NoFonts

Yes

30.6.3

UseHash

No

23.4

AlignAttributes

No

30.4

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.

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.

Previous Topic:  22.9 Providing hover text for links in HTML

Next Topic:  22.11 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 Defining text colors for HTML

22.8 Importing HTML files as insets

22.9 Providing hover text for links in HTML

22.11 Exporting content for database input

22.12 Specifying a starting topic for HTML or XHTML

22.13 Using framesets

22.14 Passing W3C validation tests

Table of ContentsIndex