13.12 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, Mif2Go provides a way to produce the required markup. See:

https://confluence.atlassian.com/display/DOC/Confluence+Storage+Format

To direct Mif2Go to produce XHTML for Confluence 4.x:

[HTMLOptions]

; Confluence = No (default, use normal linking)

; or Yes (make Confluence links)

Confluence = Yes

When Confluence=Yes, Mif2Go automatically sets the options listed in Table 13-5. You can override these individually if necessary.

Table 13-5 Default options for Confluence 4.x XHTML

Configuration section	Setting	Value	Reference
[HTMLOptions]	ConfluenceLinks	Yes	13.12
	RemoveANames	Yes	14.6
	NoLocations	Yes	19.3.2
	NoFonts	Yes	21.7.4
	UseHash	No	14.6
	AlignAttributes	No	21.5
	UseXMLDeclaration	No	13.4.7
	UseDOCTYPE	No	13.4.1
	UseHeadAndBody	No	13.4.7
[CSS]	UseCSS	No	22.4.2
	UseSpanAsDefault	No	22.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 Mif2Go must be imported into Confluence one at a time. As of this writing, no batch import utility is available.

---

> 13 Converting to HTML/XHTML > 13.12 Generating XHTML for Confluence 4.x