Website Frequently Asked Questions
This document contains frequently asked questions about the content on this website and the software used to manage it.
What software do you use to host the website?
We are using Confluence from Atlassian. We are very grateful to Atlassian for their support of Open Source and the Open Source licenses Atlassian offers to us.
We also make extensive use of Confluence extensions from Adaptavist. In particular, the Theme Builder plugins from Adaptavist allow us to design the Confluence themes to create a look and feel for the entire website.
Should I use rich text editor or wiki markup to create content?
The choice is up to you but you most likely will want to learn the wiki markup, especially for any serious content creation, and even for simple forum posts. It is worth the effort.
How do I create links?
Easiest way to get started is to use either the "Insert/Edit Link" button in the toolbar. The button will provide you with an user interface that helps you locate the document you want to link to.
Important thing to understand with linking is that the website is divided into what is called "spaces" (groups of pages). So in order to link effectively, you need to have an "alias" (the name that is used in your document to represent the link), the name of the "space" you want to link to and finally the name of the document page.
When you click on the "Insert Link" button, the popup page asks you for the above-mentioned information. You can then search for the page you want to link to by choosing a space name and keywords for your search. You can search "All Spaces" which means all of the website, or if you know which "space" (area) the document you are looking for is, simply select the correct space from the list.
If you want to see all the documents in the space you've chosen, just enter '*' as the search term.
Once you find the page you were looking for, click on it to select it. You can now type in the alias for it which will appear as text in your document. Optionally you can also add a tooltip which will be shown when a user hovers the mouse pointer over the link you've created.
Wiki Markup
For full treatise, please refer to the Confluence Documentation.
How do I add "info" section into my page?
When editing content, switch to /Wiki Markup/ tab. There, you can add {info} tag around content you want rendered as info block:
The above results in:
Pay attention to this information!
How do I create a "notice" section in my page?
When editing content, switch to /Wiki Markup/ tab. There, you can add {note} tag around content you want rendered as notice block:
The above results in:
Notice! You should read this!
How do I escape special characters such as '{' in my page?
Use backslash to escape, e.g. \ { produces the '{' sign.
When I add a PNG image as thumbnail an ugly black box is shown around it!
This appears to be a Confluence bug. The original PNG image transparency is preserved fine but not honored with the generated thumbnail image.
At the moment the solution is to avoid using transparent PNG images for thumbnails. Displaying them in original size works fine.
