Creating the stationery in ePublisher for Confluence wiki
Previous: Preparing FrameMaker source files
After having ePublisher scan the source files, we did the following to create the stationery for Confluence wiki output:
Configured settings in the Style Designer for existing FrameMaker tags.
- Modified Target cross-reference rules to remove page number and chapter references.
Modified Target settings. We excluded external CSS so we could use CSS in Confluence layouts. In version 2010.2, we did this manually, but in version 2010.4, you can go to Wiki > Exclude all external CSS includes and select Enable. See Using Confluence plugins in our documentation site for details on how we use layouts in Confluence.
Made XSL changes. We made some small changes ourselves, but some overrides required the help of Webworks (thanks to Study Hall sessions!).
Added custom elements to FrameMaker as needed, and then let ePublisher scan files to find them. The table below shows the elements we created specifically for publishing to Confluence.
Custom element |
Why we created it |
Stationery settings |
FigureWiki paragraph tag |
To replace the Figure tag, which has the format 'FIGURE <n+>:' (e.g., "Figure 3: Running services"). We felt that numbered graphics would not be appropriate for the wiki. |
Wiki heading level=3 |
SampleURL paragraph tag |
Use it for examples of links that we don't want to be active hyperlinks. For example, a URL (e.g., http://<IP address>:<port>) should not appear to be a clickable link. Links must be on separate lines for this tag to work. |
Wiki parser block=Enabled; Wiki parser block format=HTML Markup; Wiki parser block options (Confluence)=borderStyle=hidden |
WikiCategory marker |
Confluence labels cannot contain spaces, so we separate multi-word labels using hyphens, e.g., product-updates. To keep the markers consistent and prevent duplicates, we keep a list of the ones in use in our own Confluence space (in a separate instance, on another server). |
Marker type=Wiki Category/label |
WikiOnly condition |
We use this for any content that we want to appear only in Confluence. |
Visibility=Visible |