Omni Systems, Inc. Mif2Go User's Guide, Version 55

<< Prev | Next >>

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

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