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.
- EOL DSM Component Tracker: Landing Page
- Add anchor links to jump within page
- Anchors test
- Animations and Movies
- ASCL Testing Page
- attachment test
- Balsamiq GUI Mockup Plugin
- Bonfire
- Children Test
- CISL CPG Power Down Documentation
- Code with curly brackets
- Composition plugin
- Cross referencing
- Demo for EO Retreat
- Demo Page
- Embedded PDF test
- Excel spreadsheet viewer macro
- Home Test
- index
- IWRF
- Link macro test
- NCSS subset parameters table
- NWSC Need
- Page 1
- Page 2
- Page Access Restrictions
- pagetitle
- PDF Viewer Macro
- Plugin Examples
- Project Home Page
- Proposals and Awards Test
- RSS Feeds
- Scaffolding Test
- Templates
- test for inserting files
- test-table
- UOP Test
- USCO test page
- word table test
- wrfda_esmf
- Lampe Test Page
- Product requirements
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.
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 **)
- numbered list (use # symbol)
- numbered
- 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}
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.
- EDIT THE CALENDAR
Customize the different types of events you'd like to manage in this calendar.
#legIndex/#totalLegs - RESTRICT THE CALENDAR
Optionally, restrict who can view or add events to the team calendar.
#legIndex/#totalLegs - 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 - 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 - 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}
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.
newsbulletin1
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!
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.
// 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
Markus Stobbs
Add a running commentary to any page using the Add Comment link in the footer.