This Playground wiki is a space to showcase Confluence features and for UCAR staff to try out Confluence for themselves. Editing on this page is restricted but feel free to add your own pages. 

Tip: Login to Edit

 In order to add or edit wiki pages, you need to login first using your UCAS password. The login link is in the upper right of the screen. 

Please be aware that this wiki is viewable (not editable) by the public so use appropriate testing content.

Wiki Markup

When editing wiki pages, you can use the default Rich Text Editor which gives you a toolbar and shows you pages roughly as they will appear or you can use the wiki markup mode. Wiki markup is the real code behind the scenes and Confluence includes powerful tags and macros that enable you to do cool things. In the examples below, wherever you see...

a dotted line around some code...

that's the wiki markup that generated what you see on the page.

Automatic Table of Contents:

The toc tag creates a table of contents for the current wiki page based on the heading tags you used. In this example, all the h2 tagged lines are displayed as a link that jumps you to that heading on the page.

{toc:type=flat|separator=pipe|maxLevel=2}

Editing

Select Add > Page to create your own page for trying out Confluence editing. You will see that you have a choice between using a Rich Text or Wiki Markup editor. Rich Text provides you with a word processor-like interface and Wiki Markup enables you to get under the hood and use the full power of Confluence's wiki notation syntax. A link to the full notation guide is available in the Wiki Markup screen under Help Tips. You can "steal" code from other pages by clicking their Edit tab, copying Wiki markup you want to emulate and pressing Cancel. Then just paste what you copied into a page you added.

Add News creates a blog entry for a page, which is just a running list of news items or journal entries.

An Edit button will appear after you login for pages you have permissions to edit.

The Tools and Space dropdown menus make more wiki features and views available to you.

Linking

Link to New Wiki Page
To create a new page, simply type it's name between brackets like...

[newpagetitle]

which gets rendered as a red linklike this newpagetitle ...which you click to create the page. Alternatively, you can click the Add Page link in the top right of the screen and then add a link to that page from any page you want.

Link to an Existing Wiki Page
To link to an existing wiki page, simply type...

[pagetitle]

...which gets rendered as a link like this pagetitle.

Link to External Site
Type the name of the site followed by the | character and the URL like this...

[NSF|http://www.nsf.gov]

...which renders like this NSF.

Link to User
Link to a Confluence user's profile or home page by typing...

[~username]

...which renders like this Markus Stobbs.

Link to Child Pages
To link to all the children of a page, type...

{children:all=true}

...which renders like this.

Show Attachments
You can always click the Attachments tab to see all attachments to a page, but if you want to list them inline in your page, use the attachments tag...

{attachments}

...which renders like this.

  File Modified
PNG File Picture 1.png Feb 20, 2009 by Markus Stobbs
Multimedia File fire_whirls_256k_S.mov Sep 05, 2008 by Markus Stobbs
JPEG File MesaAurora.jpg Aurora over the Mesa building Sep 05, 2008 by Markus Stobbs
PNG File admin-permissions.png Permissions Administration May 27, 2008 by Markus Stobbs

Link to an attached file
You can also link to a specific file attached to a page.

[^admin-permissions.png]

...which renders like this admin-permissions.png.
Automatic Index
To create an automatic index of links to pages in your wiki that are alphabetical and cross-referenced, type...

{index}

...which renders like this index.

Lists

Confluence supports a variety of lists. The following code...

- simple list (use -- symbol)
- item 2

* bulleted list (use * symbol)
** bullet indent (use **)

# numbered list (use # symbol)
# numbered
## numbered indented (use ##)

...renders as this.

  • simple list (use - symbol)
  • item 2
  • bulleted list (use * symbol)
    • bullet indent (use **)
  1. numbered list (use # symbol)
  2. numbered
    1. numbered indented (use ##)

Images, Galleries, and Animations

Use images and other media inline on your pages by attaching them to the page and then referencing them using proper Confluence notation. The tags below are organized into a table for layout purposes.

Inline thumbnail image

!MesaAurora.jpg|thumbnail!

Photo Gallery

{gallery:|title=Photo Gallery}

Video

{widget:url=http://www.youtube.com/watch?v=jtuW327oKOQ&feature=topvideos_sports}

Animations and Movies

Plugins

Confluence has a very active community of developers who extend Confluence's functionality with plugins. Here are a few that we have installed.

  • Team Calendars - see macro example below
  • Excel and PDF Viewers
  • Chart - see macro example below
  • Latex - see macro example below
  • Scaffolding
  • Gliffy - Click Add button on a page you can edit and select "Add Gliffy Diagram"
  • Balsamiq - Click Add button on a page you can edit and select "UI Mockup"

Team Calendars

To add a calendar, select Calendar from the menu item that is your name in the upper right. Once you create a calendar, you can add it to any page with the Team Calendars macro via the Macro Browser.

  1. EDIT THE CALENDAR

    Customize the different types of events you'd like to manage in this calendar.

    #legIndex/#totalLegs
  2. RESTRICT THE CALENDAR

    Optionally, restrict who can view or add events to the team calendar.

    #legIndex/#totalLegs
  3. SHARE WITH YOUR TEAM

    Grab the calendar's URL and email it to your team, or paste it on a page to embed the calendar.

    #legIndex/#totalLegs
  4. ADD AN EVENT

    The calendar is ready to go! Click any day on the calendar to add an event or use the Add event button.

    #legIndex/#totalLegs
  5. SUBSCRIBE

    Subscribe to calendars using your favorite calendar client.

    #legIndex/#totalLegs

Chart

{chart:type=line|title=Chart of Temperatures in Brisbane|yLabel=Celcius
|dataDisplay=true|dataOrientation=vertical}
|| Month || Min || Max ||
| January | 31.3 | 37.5 |
| February | 26.8 | 32.7 |
| March | 25.1 | 28 |
| April | 18.7 | 25.3 |
{chart}
Line chart for Chart of Temperatures in Brisbane

Month

Min

Max

January

31.3

37.5

February

26.8

32.7

March

25.1

28

April

18.7

25.3

Latex

{latex}
\( F = G \frac{m_1 m_2}{r^2} \)
{latex}

Templates

Templates enable Space Administrators to define structured pages so that when editors add a new page, they will be presented with a form to fill out the content of the page. To try a template, click Add Page and click the link to create a page from a template. Select the template you want and proceed to fill out its variables. To create templates, click Browse Space and select Advanced. If you have Space Admin privileges you will see a Space Templates link.

Template Examples

The Scaffolding Plugin provides even more powerful templating including live templates which update pages when the template is changed.


Blogs

Confluence has a blog built into each wiki. To create a blog entry, click the Add News link in the upper right of the screen. Click Browse Space and then click the News tab to see blog entries. If you prefer, you can show blog entries inline on any page using the blog tag...

{blog-posts:5|content=titles}

...which renders like this.

MDS News

newsbulletin1



Session One News

session one news

The Web Advisory Group (WAG) will be hosting brown bag talks on a monthly basis starting on Wednesday, November 14th, 2007 at noon (location TBD).

The first topic is "Using Wikis for Project Team Web Sites" presented by Markus Stobbs.

You'll learn:

  • Introduction to how wikis work
  • How to set up a project team home page
  • How to edit pages
  • Using advanced Confluence tags to enhance your wiki

Hope to see you there.

Notes

Confluence supports numerous macros for easily making notes stand out to users. Here are some examples. Edit this page to see the simple code behind them.

Handy Hint

The tip tag is handy for giving users hints

Useful Information

The info tag is helpful for providing information in your Confluence pages

Be Careful

The body of the note here

Warning

Insert warning message here!

Panel

Panels are useful for sidebars or related information

Code Examples

Code examples are a snap with the {code} tag. Java is the default code type, but you can specify JavaScript, ActionScript, XML, HTML and SQL too, and source code formatters will color and properly indent your code.

Bar.java
// Some comments here
public String getFoo()
{
    return foo;
}
<item>
  <parameter tag="attribute"/>
</item>

Administration

For security reasons, this playground wiki does not provide access to Confluence's administration features. At your request, we can make you a space administrator so that you can set permissions and other parameters for a space you manage. Below are screenshots (click thumbnail image to expand) of space administrator screens as well as a global Confluence administration screen (which only the WEG team has access to) so that you can get a feel for how configurable Confluence is. Here, layout is accomplished using sections and columns which is an alternative to tables.

{section}

{column}
!Picture 1.png|thumbnail!
Space Administration screen (Space owner)
{column}

{column}
!Picture 2.png|thumbnail!
Confluence Administration screen (WEG staff)
{column}

{section}

!Picture 1.png|thumbnail,width=32,height=32!Space Administration screen (Space owner)

!Picture 2.png|thumbnail,width=32,height=32!Confluence Administration screen (WEG staff)

Import & Export

Import text files

If you choose to initially populate your space with existing text files, you will need to zip or tar your files and send them to webmaster@ucar.edu for import into your space. The files need to reside on the Confluence server in order to be imported.

HTML files

Confluence will render HTML on a page if it is surrounded by {html} tags. Please limit your HTML code to simple HTML and CSS display of content and avoid cross-site scripting.

{html}
<table>
  <tr>
    <td>Firstname</td>
    <td>Lasname</td>
  </tr>
</table>
{html}

Import other wikis

Confluence has a Universal Wiki Converter which supports conversion of numerous other wikis into Confluence. The WEG is currently extending the UWC codebase to support Swiki conversion.

Export as PDF, HTML or XML

Confluence can export your entire space as a PDF, HTML website, or in XML. This feature is available by clicking Browse Space and then the Advanced tab.

!importFiles.png|thumbnail,width=32,height=32!Import text files

!exportSpace.png|thumbnail,width=32,height=32!Export space as PDF, HTML or XML

1 Comment

  1. Add a running commentary to any page using the Add Comment link in the footer.