### 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