Create fancy wiki home pages with Confluence, Lozenge and Nuvola icons

I think that it’s important to have nice looking wiki pages, especially for those high level pages that are viewed by a large audience. I’ve put this post together to explain how to setup Atlassian’s Confluence wiki with some freely available macros and icons to make fancy wiki pages to impress.

Prerequisites

1) Atlassian Confluence

You need a running instance of Atlassian’s Confluence Wiki – you can get a free 30 day trial or free personal server license for personal use.

2) Content Formatting Macro

You need to have the free Content formatting macros installed. This can be easily done in Confluence under Administration->Plugin Repository.

3) Nuvola Icon sets attached to Confluence

You need to download the Nuvola icon set locally and attach these to your Confluence instance. Nuvola is a elegant looking icon set released free under LGPL.

Download this file, then unpack it (on Windows use something like 7-Zip), then upload all the 48×48 icons to new wiki pages in Confluence using the Confluence File Uploader that conviently runs directly from your browser.

I created five separate wiki pages under a master page called ‘Icons‘. I called these icons pages: ‘Icons Actions‘, ‘Icons Apps‘, ‘Icons Devices‘, ‘Icons Filesystems‘ and ‘Icons Mimetypes‘. You can create these pages under any space, so if you have an admin type space you’re probably best to use that.

You should put {gallery:columns=8} in each icon wiki page so the icons appear as thumbnails. You can put {children} in your Icons page to display the other child icon page names.

Creating the Actual Page

Creating the actual page is pretty easy once you have all the icons uploaded. The page uses three macros: columns, sections and lozenges. It’s a matter of reading the doco for each and experimenting with what looks best. I’ve posted my wiki source below.

You can then easily create a page template with some icons and blank labels so that others who use your wiki can easily create pages that look like this.

The Result

The final result
The final result - click to enlarge

Source code is posted below.

Source Code

{section}
{column}
{lozenge:title=Welcome to Watir|width=100%|icon=!watirlogo3.png!|color=bronze}
*_Automated testing that doesn't hurt._* \\Watir is a simple open-source library for automating web browsers. It allows you to write tests that are easy to read and easy to maintain. It is optimized for simplicity and flexibility.
{lozenge}
{column}
{section}
{section}
{column:width=50%}
{lozenge:title=Cross Platform|width=100%|icon=!firefox.png!}
Works on Windows, Linux and Mac using FireWatir.
{lozenge}
{column}
{column:width=50%}
{lozenge:title=Open Source|width=100%|icon=!open_source.png!}
Free as in freedom, free as in beer!
{lozenge}
{column}
{section}
{section}
{column:width=50%}
{lozenge:title=Watir Examples|width=100%|icon=!Icons Apps^edu_miscellaneous.png!|link=Watir Examples}
There are several simple examples available. Many people also find our unit tests to be useful examples of the different Watir commands.
{lozenge}
{column}
{column:width=50%}
{lozenge:title=Praise for Watir|width=100%|icon=!Icons Apps^amor.png!|link=Praise}
Don't just take our word for it, read what our users are saying.
{lozenge}
{column}
{section}
{section}
{column:width=50%}
{lozenge:title=Installation|width=100%|icon=!Icons Actions^wizard.png!|link=Installation}
Installation is easy! Follow these easy steps.
{lozenge}
{column}
{column:width=50%}
{lozenge:title=Documentation|width=100%|icon=!Icons Actions^messagebox_info.png!|link=Documentation}
There's heaps of information available.
{lozenge}
{column}
{section}
{section}
{column:width=50%}
{lozenge:title=Platforms|width=100%|icon=!Icons Apps^background.png!|link=Platforms}
Windows, Linux and Mac. There's a version of Watir to support you.
{lozenge}
{column}
{column:width=50%}
{lozenge:title=Source|width=100%|icon=!Icons Mimetypes^binary.png!|link=Source}
The Watir source code is hosted in an Subversion repository on OpenQA. You can browse the code or you can check out the source.
{lozenge}
{column}
{section}
{section}
{column:width=50%}
{lozenge:title=Community|width=100%|icon=!Icons Apps^package_network.png!|link=Users}
People all over the world are using Watir and loving it.
{lozenge}
{column}
{column:width=50%}
{lozenge:title=Get Involved!|width=100%|icon=!Icons Apps^edu_languages.png!|link=GetInvolved}
Watir can only get better if you're involved!
{lozenge}
{column}
{section}

Author: Alister Scott

Alister is an Excellence Wrangler for Automattic.

4 thoughts on “Create fancy wiki home pages with Confluence, Lozenge and Nuvola icons”

  1. That is a very pretty page :) Great idea to post the wiki markup too, so people can just copy and paste it onto their own Confluence page. (BTW I think the content formatting macros are shipped with the later Confluence releases by default.)

    Like

  2. Thanks, after using the Lozenge macro I wanted to include some fancy icons.
    Your post is a real time saver for configuration and management of the icons.

    Like

Comments are closed.