-
Document generated by Confluence on Aug 07, 2008 22:47 Page
1
Space DetailsKey: DOC
Name: Confluence 2.9
Description: Documentation for latest version of Confluence
wiki: InstallationGuide, User Guide, Admin Guide and other
technical documentation
Creator (Creation Date): [email protected] (Dec 17, 2003)
Last Modifier (Mod. Date): smaddox (Aug 06, 2008)
Available Pages• Confluence User Guide
• Archiving Mail Overview• Adding a Mail Account
• Deleting Mail
• Fetching Mail
• Importing Mail
• Linking to Mail
• Managing Mail Accounts
• Restoring Mail
• Viewing Mail
• Confluence Glossary
• Confluence Icons
• Confluence Notation Guide Overview• Confluence Emoticons
• Form Field Markup for Templates
• Working with Headings
• Working with Lists
• Working with Tables
• Working with Text Breaks
• Working with Text Effects
• Customising Look and Feel• Applying A Theme To A Space
• Change Confluence Browser Icon
• Changing a Space's Logo
• Customising Homepage
• Editing a Space's Colour Scheme
• Modifying Confluence Layouts Using Custom Decorators
• Dashboard• Customising the Dashboard
• Displaying an Image• Image File Formats
• Exporting a Space• Confluence to HTML
• Confluence to PDF• Create PDF in another language
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
2
• Confluence to XML
• Exporting to a Word document
• Importing Content Into Confluence• Importing Pages from
Disk
• Keyboard Shortcuts
• Rich Text Editor Overview• Enabling Rich Text Editing
• Rich Text-Creating a new link
• Rich Text-Inserting an image
• Rich Text-Inserting emoticons
• Rich Text-Inserting Symbols
• Rich Text-Linking to an Attachment
• Rich Text-Linking to an Image
• Rich Text-Linking to a Page
• Rich Text-Working with Tables
• Rich Text-Working with Text Effects
• Searching Confluence• Confluence Search Fields
• Confluence Search Syntax
• Ranking of Search Results
• Searching the People Directory
• Text Tokenisation and Filtering
• Security Overview• Page Restrictions
• Setting a Page's Restrictions• The User Search Window
• Viewing a Page's Restrictions
• Site Administrators and their permissions
• Space Administrators and their permissions
• Space Permissions Overview• Assigning Space Permissions
• Revoking Space Permissions
• Viewing Space Permissions
• Users and Groups
• Viewing Restricted Pages
• Site Backup and Restore
• Space Backup and Restore
• Tracking Updates Overview• Managing Watches
• Subscribing to Daily Email Reports
• Subscribing to RSS Feeds within Confluence• Using
pre-specified RSS feeds
• Using the RSS Feed Builder
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
3
• Watching a Page
• Watching a Space
• Working with RSS Feeds• Adding a username and password to
Confluence RSS feeds
• User Profile Overview• Changing Password
• Editing User Preferences
• Editing User Profile
• Email Address Privacy
• Linking to Personal Spaces and User Profiles
• Updating Email Address
• Uploading a Profile Picture
• Viewing User Profile
• Using the Confluence Screens
• Working with Attachments Overview• Attaching Files to a
Page
• Attachment Versions
• Deleting an Attachment
• Displaying List of Attachments in a Page
• Downloading Attachments
• Editing Attachment Details
• Embedding Multimedia Content
• Embedding PowerPoint Presentations in a Page
• Finding an Attachment
• Linking to Attachments
• Viewing Attachment Details
• Working with Bookmarks• Adding a bookmark
• Adding a Bookmark Icon to your Browser• Adding a Bookmark Link
to your Browser's Favorites
• Dragging a Bookmark Link to your Browser
• Editing or Commenting on a Bookmark
• Removing a Bookmark
• Subscribing to a Bookmarks RSS Feed
• Viewing Bookmarks
• Working with Favourites Overview• Adding Favourites
• Removing Favourites
• Viewing Favourites
• Working with Images• Viewing Images as a Slide Show
• Working with Labels Overview• Adding a Global Label
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
4
• Adding a Personal Label
• Adding a Space Label
• Adding a Team Label
• Categorising Wiki Content Using Labels
• Label Macros• Content by Label Macro
• Navmap Macro
• Recently Used Labels Macro
• Related Labels Macro
• Navigating Pages by Label
• Removing a label from a page
• Removing a space label
• Removing a team label
• Viewing Global Labels
• Viewing labelled pages
• Viewing personal labels
• Viewing Popular Labels
• Working with Links Overview• CamelCase linking
• CamelCasePage
• Changing the Title of a Link• Sample Release Notes
• Linking an Image
• Linking to Confluence Pages from Outside Confluence
• Linking to Pages in Another Space
• Linking to Pages Within the Same Space
• Linking to Web Pages
• Trackback
• Using a link to create a new mail message
• Working with Anchors
• Working with Macros• Attachments Macro
• Blog Posts Macro
• Bookmarks Macro
• Change-History Macro
• Chart Macro
• Cheese Macro
• Children Display Macro• Child Page 1
• Grandchild
• Child Page 2
• Code Block Macro
• Color Text Macro
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
5
• Column Macro
• Create Space Button Macro
• Excerpt Include Macro
• Excerpt Macro
• Favourite Pages Macro
• Flowchart Macro
• Gallery Macro
• Global Reports Macro
• HTML Macro
• IM Presence Macro
• Include Page Macro• Sample Include Page
• Info Macro
• JIRA Issues Macro
• JIRA Portlet Macro
• JUnit Report Macro
• Livesearch Macro
• Loremipsum macro
• Noformat Macro
• Nolink and nl Macros
• Note Macro
• Pagetree Macro• Sample Page Tree
• Another Sample Page Tree
• Sample Page Tree 2
• Pagetree Search Macro
• Panel Macro
• Recently Updated Content Macro
• RSS Feed Macro
• Search Macro
• Section Macro
• Space Details Macro
• Spacegraph Macro
• Spaces List Macro
• Tasklist Macro
• Thumbnail Macro• Thumbnail and Gallery Example
• Tip Macro
• Userlister Macro
• Warning Macro
• Welcome Message macro
• Working with News Overview
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
6
• Adding News
• Deleting News
• Editing News
• Linking to News
• Viewing News
• Working with Page Families• What is a Page Family?
• Breadcrumbs
• Viewing a Page's Family
• Viewing Children of a Page
• Viewing Hierarchy of Pages within a Space
• Viewing a Page's Location within a Space
• Changing Parent of a Page
• Creating a Child Page
• Setting a Page Family to Alphabetical Order
• Working with Pages Overview• Commenting on a Page
• Adding a Comment
• Deleting Comments
• Editing a Comment
• Linking to Comments• Sample Page
• child page
• Viewing Comments
• Copying a Page
• Creating a New Page• Choose a Page
• Deleting a page• Purging Deleted Pages
• Restoring a Deleted Page
• Display an older version of a page
• Editing an Existing Page• Concurrent Editing and Merging
Changes
• Making Rich Text or Wiki Markup Editing Default
• Recording Change Comments
• E-mailing a Page
• Linking pages
• Moving a Page
• Sequential Order of Pages
• Page Layout in Edit Mode (Rich Text)
• Page Layout in Edit Mode (Wiki Markup)
• Page Layout in View Mode
• Renaming a Page
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
7
• Viewing Page Information• Viewing History of a Page
• Comparing Two Different Versions of a Page
• Restoring an Older Version of a Page
• Viewing Recent changes
• Working with Drafts Overview• Working with Drafts FAQ
• Writing Confluence pages
• Working with Spaces Overview• Administering Spaces
• Browsing a space• Editing Space Details
• Managing Orphaned Pages
• Managing Undefined Pages
• Tree View of Pages
• Viewing Pages Alphabetically
• Viewing Recently Updated Content
• Viewing Space Details
• Converting a Global Space to a Personal Space
• Deleting a Space
• Guidelines For Partitioning Content Into Spaces &
Pages
• Moving Content from one Space to Another• Moving a family of
pages from one space to another
• Moving an Attachment
• Moving a Page from one Space to Another
• Moving Pages within a Space
• Setting up a New Global Space
• Setting up your Personal Space
• Viewing all Spaces
• Viewing Space Activity
• Working with Templates Overview• Adding a Template
• Creating a Page using a Template
• Editing a template
• Removing a Template
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
8
Confluence User Guide
This page last changed on Aug 06, 2008 by smaddox.
Confluence 2.9 User Guide
Get Familiar with the Confluence WorkspaceWorking with
SpacesWorking with PagesWorking with AttachmentsWorking with
ImagesWorking with LinksWorking with LabelsWorking with NewsWorking
with BookmarksWorking with MacrosTracking UpdatesSearchingWorking
with FavouritesWorking with User ProfilesCustomising
ConfluenceWorking with Page TemplatesArchiving MailExporting and
ImportingSecurityAppendix A - Confluence Notation Guide
(WikiMarkup)Appendix B - Rich Text EditorAppendix C - Keyboard
ShortcutsAppendix D - Glossary
Download
You can download the Confluence documentationin PDF, HTML or XML
formats.
About
The Confluence User Guide provides an overviewof the key
features of Confluence and explainsboth its basic and more advanced
usage as aknowledge management tool, and a
collaborativeenvironment. If you still have a question thathasn't
been answered, write and tell us about it.
If you are using Confluence Team Hosted,please note that a few
Confluence features arelimited in or excluded from the Confluence
TeamHosted edition. See the feature comparison. Alsoplease see
Confluence Team Hosted Resources.
For more documentation please visit ConfluenceDocumentation
Home.
Get Familiar with the Confluence Workspace
The DashboardUsing the Confluence ScreensCustomising the
DashboardPage Layout in View ModePage Layout in Edit Mode (Wiki
Markup)Page Layout in Edit Mode (Rich Text)Confluence Icons
Working with Spaces
Working with Spaces OverviewSetting up a New Global SpaceSetting
up your Personal SpaceViewing all SpacesViewing Space
DetailsEditing Space DetailsBrowsing a space
http://confluence.atlassian.com/display/ALLDOC/Download+the+Confluence+User+Guidehttp://confluence.atlassian.com/display/ALLDOC/Download+the+Confluence+documentationhttp://www.atlassian.com/software/confluencemailto:[email protected]://www.atlassian.com/software/confluence/comparison.jsphttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hostedhttp://confluence.atlassian.com/display/DOChttp://confluence.atlassian.com/display/DOC
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
9
Viewing Space ActivityMoving Content from one Space to
AnotherDeleting a SpaceConverting a Global Space to a Personal
SpaceAdministering Spaces
Working with Pages
Working with Pages OverviewCreating a New PageWriting Confluence
pagesEditing an Existing PageRenaming a PageConcurrent Editing and
Merging ChangesWorking with Drafts OverviewWorking with Drafts
FAQCopying a PageDeleting a pageMoving a PageRestoring a Deleted
PagePurging Deleted PagesCommenting on a PageAttaching Files to a
PageE-mailing a PageWorking with Page FamiliesLinking
PagesRecording Change CommentsViewing History of a PageViewing Page
InformationPage Restrictions
Working with Attachments
Working with Attachments OverviewAttaching Files to a
PageLinking to AttachmentsFinding an AttachmentViewing Attachment
DetailsEditing Attachment DetailsDownloading AttachmentsDeleting an
AttachmentMoving an AttachmentDisplaying List of Attachments in a
PageEmbedding Multimedia Content
Working with Images
Overview of Working with ImagesDisplaying an ImageRich
Text-Inserting an imageImage File FormatsThumbnail MacroGallery
Macro
Working with Links
Working with Links OverviewLinking to Pages Within the Same
SpaceLinking to Pages in Another SpaceLinking to Web PagesLinking
to Confluence Pages from Outside ConfluenceChanging the Title of a
Link
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
10
Linking an ImageLinking to CommentsLinking to NewsLinking to
Personal Spaces and User ProfilesLinking to MailLinking to
AttachmentsWorking with AnchorsCamelCase linkingTrackback
Working with Labels
Working with Labels OverviewAdding a Global LabelAdding a
Personal LabelAdding a Space LabelAdding a Team LabelViewing
labelled pagesViewing Global LabelsViewing personal labelsViewing
Popular LabelsRemoving a label from a pageRemoving a space
labelRemoving a team labelLabel Macros
Working with News
Working with News OverviewViewing NewsAdding NewsEditing
NewsLinking to News
Working with Bookmarks
Working with BookmarksAdding a bookmarkAdding a bookmark icon to
your browserViewing bookmarksSubscribing to a bookmarks feedEditing
a bookmarkCommenting on a bookmarkRemoving a bookmarkDisplaying
bookmarks on a Confluence page
Tracking Updates
Tracking Updates OverviewWatching a PageWatching a
SpaceSubscribing to Daily Email ReportsManaging WatchesWorking with
RSS FeedsSubscribing to RSS Feeds within ConfluenceUsing the RSS
Feed BuilderUsing pre-specified RSS feedsAdding a username and
password to Confluence RSS feedsSubscribing to External RSS
feeds
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
11
Searching
Searching ConfluenceSearching the People Directory Confluence
Search SyntaxConfluence Search Fields
Working with Favourites
Working with Favourites OverviewAdding FavouritesViewing
FavouritesAdding a Personal LabelRemoving Favourites
Working with User Profiles
User Profile OverviewEditing User ProfileUploading a Profile
Picture Updating Email AddressChanging PasswordEmail Address
PrivacyEditing User PreferencesLinking to Personal Spaces and User
ProfilesSetting up your Personal Space
Customising Confluence
Customising HomepageCustomising Look and FeelApplying A Theme To
A SpaceModifying Confluence Layouts Using Custom DecoratorsEditing
a Space's Colour SchemeChanging a Space's Logo
Working with Page Templates
Working with Templates OverviewAdding a TemplateForm Field
Markup for TemplatesCreating a Page using a TemplateEditing a
templateRemoving a Template
Archiving Mail
Archiving Mail OverviewAdding a Mail AccountManaging Mail
AccountsImporting MailViewing MailFetching MailDeleting
MailRestoring MailLinking to Mail
Exporting and Importing
Space Backup and RestoreSite Backup and Restore
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
12
Confluence to HTMLConfluence to PDFConfluence to PDF in another
languageConfluence to XMLConfluence to WordImporting Content Into
Confluence
Security
Security OverviewUsers and GroupsSite Administrators and their
permissionsSpace Administrators and their permissionsSpace
Permissions OverviewViewing Space PermissionsAssigning Space
PermissionsPage Restrictions
Appendix A - Confluence Notation Guide (Wiki Markup)
Confluence Notation Guide OverviewWorking with HeadingsWorking
with Text EffectsWorking with Text BreaksWorking with LinksWorking
with AnchorsWorking with ImagesWorking with ListsWorking with
TablesWorking with MacrosWorking with AttachmentsFull Notation
Guide (Wiki Markup)
Appendix B - Rich Text Editor
Rich Text Editor OverviewEnabling Rich Text EditingMaking Rich
Text or Wiki Markup Editing DefaultRich Text-Working with Text
EffectsRich Text-Working with TablesRich Text-Inserting an
imageRich Text-Creating a new linkRich Text-Linking to an ImageRich
Text-Linking to an AttachmentRich Text-Linking to a PageRich
Text-Inserting emoticonsRich Text-Inserting Symbols
Appendix C - Keyboard Shortcuts
Keyboard Shortcuts
Appendix D - Glossary
Confluence Glossary
http://confluence.atlassian.com/renderer/notationhelp.action?section=all
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
13
Archiving Mail Overview
This page last changed on Apr 17, 2008 by edawson.
Not applicable to Confluence Team Hosted
This page does not apply if you are using Confluence Team
Hosted. Read more about the featurelimitations in Confluence Team
Hosted.
Confluence allows you to collect and archive mail within each
space individually. This is a useful facilitythat allows you to
archive all emails pertaining to a particular project on Confluence
alongside it in thesame space.
You can download mail from one or more pop-accounts. You can
also import mail from mbox files eitheron your local system or on
the Confluence server.
Mail is contained in the 'Mail' tab under the 'Browse Space'
view of a space. You may need SpaceAdministrator rights to access
this view.
Go to the 'Browse Space' view. There are two ways to browse a
space:
• Go to a page in the space and select the option you want from
the 'Browse' menu. Thecorresponding tab of the 'Browse Space' view
will open.
• Or click the icon next tothe space name on the Dashboard. The
'Pages' tab of the 'Browse Space' view will open.
(If you are not a space administrator for the target space,
contact your Confluence administrator torequest Space Admin
permission.)
From here, you can navigate mail easily and also use the 'Quick
Search' to search mail and theattachments it contains.
What would you like to do?
Add a Mail AccountManage Mail accountsImport MailView MailFetch
MailDelete MailRestore MailLink to Mail
The ability to archive mail applies only to global spaces, not
personal spaces. Please seeWorking with Spaces Overview for
information about the differences between global spacesand personal
spaces.
RELATED TOPICS
Take me back to Confluence User Guide
http://www.atlassian.com/software/confluence/hosted.jsphttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hostedhttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hosted
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
14
Adding a Mail Account
This page last changed on Apr 17, 2008 by edawson.
Not applicable to Confluence Team Hosted
This page does not apply if you are using Confluence Team
Hosted. Read more about the featurelimitations in Confluence Team
Hosted.
When you add a mail account, you are configuring Confluence to
download mail from that account andarchive it within the space.
Since Confluence removes emails from an email account as it is
added to theMail Archive, Confluence must be setup to poll a clone
email account rather than the actual account. Forexample, to
archive the actual account [email protected] to your Confluence
Sales space, you mustfirst create a clone account such as
[email protected] that contains the same email content.
Stage 1 - Creating A Clone Email Account
1. Add a new email account on the mail server with the clone
email address.2. Copy all existing emails from the actual account
to the clone account.3. Set up the actual account to bcc sent
emails to the clone account.4. Set up the actual account to forward
received emails to the clone account.
Stage 2 - Archive Clone Account To Mail Archive
1. If you are not a space administrator for the target space,
contact your Confluence administrator torequest Space Admin
permission. You need to be a space administrator before you can add
a mailaccount to the space.
2. Go to the 'Browse Space' view.
Go to the 'Browse Space' view. There are two ways to browse a
space:
• Go to a page in the space and select the option you want from
the 'Browse' menu. Thecorresponding tab of the 'Browse Space' view
will open.
• Or click the icon nextto the space name on the Dashboard. The
'Pages' tab of the 'Browse Space' view will open.
Now click on 'Mail Accounts' under the heading 'Mail' in the
left panel. This will bring up a newscreen listing the existing
mail accounts and displaying a link to add a new pop-account.
3. Click 'Add mail account' located at the top of the page. This
will bring up a form into which you needto enter your account
configuration details.
4. Enter the details, (Protocol may be POP/S or IMAP/S) (See
below) and click 'Create'. Configuredaccounts will have their mail
downloaded and removed from the server, so make sure you
aredownloading from a clone account.
Screenshot Of Adding A POP Account
• Account Name: Enter a name for this account by which it will
be known inConfluence.
http://www.atlassian.com/software/confluence/hosted.jsphttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hostedhttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hosted
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
15
• Description: Provide a description for this account
(Optional).• Protocol: Choose from POP, IMAP, POPS or IMAPS•
Hostname: Enter the account mail server host name.• Port: The mail
server's port number will be displayed by default. Do not edit
this
field.• Username: Enter a username for this account.• Password:
The account's password.
Note: The ability to import mail applies only to global spaces,
so the 'Import' section in the abovescreenshot does not appear in
the 'Space Admin' tab for personal spaces. Please see Working
withSpaces Overview for information about the differences between
global spaces and personal spaces.
RELATED TOPICS
Archiving Mail OverviewManaging Mail AccountsImporting
MailViewing MailFetching MailDeleting MailLinking to Mail
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
16
Deleting Mail
This page last changed on Apr 17, 2008 by edawson.
Not applicable to Confluence Team Hosted
This page does not apply if you are using Confluence Team
Hosted. Read more about the featurelimitations in Confluence Team
Hosted.
To delete mail for a space, you require 'Remove Mail' permission
which is assigned by a spaceadministrator from the Space
Administration screens. See Space Permissions or contact a
spaceadministrator for more information.Only a space administrator
can delete all email messages for the space simultaneously.To
delete mail for a space,
1. Go to the 'Browse Space' view.
Go to the 'Browse Space' view. There are two ways to browse a
space:
• Go to a page in the space and select the option you want from
the 'Browse' menu. Thecorresponding tab of the 'Browse Space' view
will open.
• Or click the icon nextto the space name on the Dashboard. The
'Pages' tab of the 'Browse Space' view will open.
2. Go to the 'Mail' tab. A list of messages in the space is
displayed in reverse chronological order.3. Delete an individual
email by clicking the trash
icon beside it.If you are a space adminstrator, you can delete
all email messages within a space simultaneously byclicking on the
'Delete All' link at the top of the mail view. Deleted mail is
stored under 'Trash' andcan be restored by a space administrator
from the 'Space Admin' tab.
Warning
Email messages deleted using the 'Delete All' option cannot be
restored.
RELATED TOPICS
Restoring MailArchiving Mail OverviewBrowsing a space
Take me back to Confluence User Guide
http://www.atlassian.com/software/confluence/hosted.jsphttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hostedhttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hosted
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
17
Fetching Mail
This page last changed on Apr 17, 2008 by edawson.
Not applicable to Confluence Team Hosted
This page does not apply if you are using Confluence Team
Hosted. Read more about the featurelimitations in Confluence Team
Hosted.
Confluence fetches mail from the server once every 30
minutes.
You need to be a space administrator to manually retrieve new
mail from mail accounts. To manually retrieve mail,
1. Go to the 'Space Administration' view.
Go to the 'Space Admin' tab of the Browse Space view. To do
this:
• Go to a page in the space, open the 'Browse' menu and select
'Space Admin'. The 'SpaceAdministration' view will open.
'Space Admin' is only displayed if you are a space
administrator.2. Go to the 'Mail' tab.3. Go to the 'Mail' tab. A
list of messages for the space is displayed in reverse
chronological order.4. Click on the 'Fetch new mail' link located
above the list of messages. Any new messages will be
displayed in order of most recent first.
NoteOnce mail is fetched, it will be removed from the
server.
RELATED TOPICS
Viewing MailArchiving Mail OverviewDeleting Mail
Take me back to Confluence User Guide
http://www.atlassian.com/software/confluence/hosted.jsphttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hostedhttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hosted
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
18
Importing Mail
This page last changed on Apr 17, 2008 by edawson.
Not applicable to Confluence Team Hosted
This page does not apply if you are using Confluence Team
Hosted. Read more about the featurelimitations in Confluence Team
Hosted.
Confluence allows you to import mail from mbox files located
either on your local system or on theConfluence server and archive
it within the space.
You need to be a space administrator to import mail for a space.
To import mail from an mbox file,
1. Go to the 'Space Admin' in the 'Browse Space' view.
Go to the 'Browse Space' view. There are two ways to browse a
space:
• Go to a page in the space and select the option you want from
the 'Browse' menu. Thecorresponding tab of the 'Browse Space' view
will open.
• Or click the icon nextto the space name on the Dashboard. The
'Pages' tab of the 'Browse Space' view will open.
2. Click on 'Mail Import' under the heading 'Mail' in the left
panel. This will bring up a new screen.• To import from a Local
system, click 'Browse' to select the mbox file. Then click
'Import'.• To import from the Server, enter the location of the
mbox file on the server in the 'Server' text
field and click 'Import'.
Screenshot : Importing mail
The ability to import mail applies only to global spaces, so the
'Import' section in theabove screenshot does not appear in the
'Space Admin' tab for personal spaces. Please seeWorking with
Spaces Overview for information about the differences between
global spacesand personal spaces.
RELATED TOPICS
Archiving Mail OverviewAdding a Mail AccountImporting Mail
http://www.atlassian.com/software/confluence/hosted.jsphttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hostedhttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hostedhttp:/
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
19
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
20
Linking to Mail
This page last changed on Apr 17, 2008 by edawson.
Not applicable to Confluence Team Hosted
This page does not apply if you are using Confluence Team
Hosted. Read more about the featurelimitations in Confluence Team
Hosted.
Currently in Confluence, while it is possible to link to a mail
message, the method is a little cumbersome.
You need to edit in 'Wiki Markup' mode to create a link to an
email. To link to an email,
1. Go to the 'Browse Space' view.
Go to the 'Browse Space' view. There are two ways to browse a
space:
• Go to a page in the space and select the option you want from
the 'Browse' menu. Thecorresponding tab of the 'Browse Space' view
will open.
• Or click the icon nextto the space name on the Dashboard. The
'Pages' tab of the 'Browse Space' view will open.
2. Go to the 'Mail' tab. The mail is displayed in reverse
chronological order with a default of 30 emailmessages per page.
Move between pages to locate the message you want to link to.
3. Click on the mail message. You will notice in the address bar
of your browser that the URL displayedends in a series of
numerals.
4. Copy only the numerals.5. Click on the 'edit' tab of the page
from which you want to link to the message.6. Paste the numerals
between square brackets (as you would when you create any link
in
Confluence), and then include the dollar sign '$' in front of
the numerals.
Here's an example:
|
Clicking on the link will open up the mail message.
RELATED TOPICS
Working with Links OverviewArchiving Mail Overview
Take me back to Confluence User Guide
http://www.atlassian.com/software/confluence/hosted.jsphttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hostedhttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hosted
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
21
Managing Mail Accounts
This page last changed on Apr 17, 2008 by edawson.
Not applicable to Confluence Team Hosted
This page does not apply if you are using Confluence Team
Hosted. Read more about the featurelimitations in Confluence Team
Hosted.
You need to be a space administrator to manage mail accounts for
a space. To manage mail accounts,
1. Go to the 'Space Admin' tab in the 'Browse Space' view.
Go to the 'Browse Space' view. There are two ways to browse a
space:
• Go to a page in the space and select the option you want from
the 'Browse' menu. Thecorresponding tab of the 'Browse Space' view
will open.
• Or click the icon nextto the space name on the Dashboard. The
'Pages' tab of the 'Browse Space' view will open.
2. Click on 'Mail Accounts' under the heading 'Mail' in the left
panel. This will bring up a new screenlisting the existing mail
accounts each with a link to 'Edit', 'Remove' or 'Disable' the
account.
• Edit : This link allows you to change the configuration
settings for the mail account.• Remove: This link lets you remove
the account permanently.• Disable: This link allows you to
temporarily disable the account.
Screenshot : Managing mail accounts
RELATED TOPICS
Archiving Mail OverviewAdding a Mail AccountImporting
MailViewing MailFetching MailDeleting MailRestoring MailLinking to
Mail
Take me back to Confluence User Guide
http://www.atlassian.com/software/confluence/hosted.jsphttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hostedhttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hosted
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
22
Restoring Mail
This page last changed on Apr 17, 2008 by edawson.
Not applicable to Confluence Team Hosted
This page does not apply if you are using Confluence Team
Hosted. Read more about the featurelimitations in Confluence Team
Hosted.
Deleted email messages are stored under 'Trash' and can be
restored by a space administrator from theSpace Administration
screens.
You can only restore an email from trash if it was deleted
individually and not using the 'Remove All'operation. To restore
mail,
1. Go to the 'Space Admin' tab in the 'Browse Space' view.
Go to the 'Browse Space' view. There are two ways to browse a
space:
• Go to a page in the space and select the option you want from
the 'Browse' menu. Thecorresponding tab of the 'Browse Space' view
will open.
• Or click the icon nextto the space name on the Dashboard. The
'Pages' tab of the 'Browse Space' view will open.
2. Click on 'Trash' in the left panel. A list of pages and
emails deleted from the space is displayed.3. Click on 'Restore'
beside the email you want to restore.
To view this email, you will have to go to the 'Mail' tab in the
'Browse Space' view.
RELATED TOPICS
Viewing MailFetching MailDeleting MailBrowsing a space
Take me back to Confluence User Guide
http://www.atlassian.com/software/confluence/hosted.jsphttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hostedhttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hosted
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
23
Viewing Mail
This page last changed on Apr 17, 2008 by edawson.
Not applicable to Confluence Team Hosted
This page does not apply if you are using Confluence Team
Hosted. Read more about the featurelimitations in Confluence Team
Hosted.
In Confluence, each global space can be set up to archive mail.
To view mail messages archived within a particular space,
1. Go to the 'Mail' tab in the 'Browse Space' view.
Go to the 'Browse Space' view. There are two ways to browse a
space:
• Go to a page in the space and select the option you want from
the 'Browse' menu. Thecorresponding tab of the 'Browse Space' view
will open.
• Or click the icon nextto the space name on the Dashboard. The
'Pages' tab of the 'Browse Space' view will open.
2. The mail is displayed in reverse chronological order with a
defaultof 30 mails per page. You can move between pages by clicking
the
and
links or by selecting aparticular page number.
3. Click on a mail message to view its contents.
Screenshot : Mail Archive
If you are a space administrator, or have been given permission
to delete mail messages, you can alsodelete emails from here.
Navigating Mail
'Find More': These links links at the top of an email message
let you search for other emails from thesame author or on the same
subject.'Attachments': This link located below the email body
allows you to view mail attachments. The link isonly displayed if
any attachments exist.'Entire Thread': This link allows you to view
the mail's thread, if one exists.
The 'Mail Operations' panel is located to the right of the mail
view and displays links to:
• Entire Thread: View the thread that this mail belongs to. This
option is only available when the mailbelongs to a thread.
• Next By Date: Navigate to the next message.
http://www.atlassian.com/software/confluence/hosted.jsphttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hostedhttp://confluence.atlassian.com/display/CSH/Limited+features+in+Confluence+Team+Hosted
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
24
• Previous By Date: Navigate to the previous message.• Remove
Mail: Remove the current mail from the space.• Mail Archive: Go to
the mail archive view for this space.
Screenshot : Navigating mail
Handy HintUse the Quick Search facility to quickly locate a
mail
RELATED TOPICS
Archiving Mail OverviewViewing MailFetching MailDeleting
Mail
Take me back to Confluence User Guide
http:/
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
25
Confluence Glossary
This page last changed on Dec 18, 2007 by smaddox.
Administration Console
The Administration Console is the interface for the global
administration of Confluence.
Only administrators can access the Administration Console.
Administrators
The Confluence permission scheme allows two levels of
administrator permissions:
• System Administrator – full administrative access to
Confluence.• Confluence Administrator – access to most of the
Confluence administrative functions, but excluding
those which could compromise the security of the Confluence
system.
Please refer to the overview of global permissions for details
of the functions which each level ofadministrator can perform.
Breadcrumbs
The breadcrumbs trace the path from the current page to the
dashboard along the space's page-hierarchy.
The breadcrumbs in Confluence are listed at the top of every
page.
CamelCase
CamelCase is a form of markup commonly used in wikis where words
compounded together LikeThiswithout spaces are used to create
links.
In Confluence, Camelcasing can be turned on from the
Administration Console.
Change Comment
A change comment is a short description entered during the edit
of a page to record the changes beingmade in the edit.
Child Pages
Creating child and parent pages is a means by which you can
organize content on the site. A child page isa page that has a
parent in any of the Confluence spaces.
A child can only have one parent.
Comments
A comment may be a remark, question, or any other additional
information you wish to add to a pagepertaining to the topic the
page covers. You can comment on any page or news item in
Confluence.
Confluence Administrators
The Confluence permission scheme allows two levels of
administrator permissions:
• System Administrator – full administrative access to
Confluence.• Confluence Administrator – access to most of the
Confluence administrative functions, but excluding
those which could compromise the security of the Confluence
system.
Please refer to the overview of global permissions for details
of the functions which each level ofadministrator can perform.
http://confluence.atlassian.com/display/DOC/Global+Permissions+Overviewhttp://confluence.atlassian.com/display/DOC/Global+Permissions+Overview
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
26
Confluence Markup
This is the markup used to write and edit pages in Confluence.
Based on Textile, the markup, when youbecome familiar with it,
makes creating pages as easy as writing email.
Custom Decorators
Decorator files are used to define layouts in Confluence. They
are vmd files and require knowledge of thelanguage, Velocity, to
edit.
Dashboard
The dashboard is the front page of a Confluence site. It
provides an overview of the site, access to allspaces, and displays
a list of the most recently updated content within them.
Form Field Markup
Form field markup is a specialised markup for creating form
fields and is used when creating pagetemplates.
Global Administrators
A global administrator is the same as a system
administrator.
Global Spaces
Global spaces contain content on any theme or topic of your
choice.
For more information about global spaces and personal spaces,
see Working with Spaces Overview.
JIRA
JIRA is Atlassian's award winning Issue tracking and project
management application.
Visit Atlassian's website to learn more about JIRA.
Labels
Labels are user-defined tag words assigned to pages to
categorise content in Confluence.
Macros
A macro is a command wrapped inside curly braces {...} used to
perform programmatic functions andgenerate more complex content
structures in Confluence.
News Items
A news item may be a journal entry, status report or any other
timely information pertaining to a space.
Notifications
A notification is an email message sent to you updating you of
changes to pages and spaces you chooseto 'watch'.
Orphaned Pages
http://textism.com/tools/textile/http://jakarta.apache.org/velocity/user-guide.htmlhttp://www.atlassian.com/software/jira/
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
27
An orphaned page is a page without any incoming links.
Pages
Pages are the primary means of storing information in
Confluence. They are the building blocks of spacesand are written
in Confluence markup.
Page Family
Pages in Confluence can be organised into a hierarchy of parent
and child pages. A parent and all itschildren comprise a page
family.
Confluence permits nested page families.
Parent Page
A parent page is a page that has one or more child pages. It may
itself be a child of another page.
People Directory
The People Directory contains a list of all users in your
Confluence site. Each user's name links to theirpersonal space.
Permalink
A permalink is the url used to link to specific content items
like comments.
Personal Spaces
Personal spaces belong to particular users, and rather than
being listed on the Dashboard, are availablefrom the People
Directory.
For more information about global spaces and personal spaces,
see Working with Spaces Overview.
RSS Feeds
An RSS feed is a format for delivering summaries of regularly
changing web content. RSS is read by RSSnewsreader programs.
You will need an RSS reader to subscribe to feeds within
Confluence.
Confluence acts as an RSS reader for feeds from sites outside of
Confluence.
RSS Reader
An RSS reader is a specialised RSS program (also called
aggregator) that displays the contents of RSSfeeds for you. To
subscribe to RSS feeds within Confluence, you will need an RSS
reader.
Site Administrators
The Confluence permission scheme allows two levels of
administrator permissions:
• System Administrator – full administrative access to
Confluence.• Confluence Administrator – access to most of the
Confluence administrative functions, but excluding
those which could compromise the security of the Confluence
system.
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
28
Please refer to the overview of global permissions for details
of the functions which each level ofadministrator can perform.
System Administrators
The Confluence permission scheme allows two levels of
administrator permissions:
• System Administrator – full administrative access to
Confluence.• Confluence Administrator – access to most of the
Confluence administrative functions, but excluding
those which could compromise the security of the Confluence
system.
Please refer to the overview of global permissions for details
of the functions which each level ofadministrator can perform.
----Space Administrators
A space administrator is a user with the 'Space Admin'
permission for the space. A user with thispermission can perform a
host of functions relating to the management of a space and has
completeaccess to the space regardless of any other control
settings or permissions.
Permissions for a space are only assigned and modified by space
administrators.
Spaces
A space is an area on your site into which you can group
different content items together based on anytheme of your choice.
All content in Confluence is organised into spaces.
There are two types of spaces: global spaces and personal
spaces.
Templates
A template is a pre-defined page that can be used as a prototype
when creating pages. Templates areuseful for giving pages a common
style or format.
Themes
Themes are pre-defined 'look and feel' styles which are
configured from the administration menu and canbe applied across
Confluence or to a single space.
Tiny links
A tiny link is the shortened url of a page which is useful when
sending links to the page, for example, viaemail.
Trackback
Trackback is a mechanism by which two sites can stay informed
each time one site refers to the other bymeans of trackback
'pings'.
In Confluence, Trackback is enabled from the Administration
Console.
Trackback Autodiscovery
Trackback autodiscovery is a block of code that can be placed in
a web-page to describe where trackbackpings should be sent for that
page. You can read the technical specification for autodiscovery
here.
When Trackback is enabled, Confluence uses Trackback
Autodiscovery to ping pages that are linked to,and to advertise its
own pages as being able to receive pings.
http://confluence.atlassian.com/display/DOC/Global+Permissions+Overviewhttp://confluence.atlassian.com/display/DOC/Global+Permissions+Overviewhttp://www.sixapart.com/pronet/docs/trackback_spec
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
29
Undefined Links
An undefined link is a link to a page that has not yet been
created. Clicking on the page link allows youcreate the page.
User Profile
Every user account in Confluence is linked to a profile that
contains user related information and optionsto configuring user
preferences.
Watching a Page
When you watch a page, you are sent an email notification
whenever that page has been modified.
Watching a Space
When you watch a space, you are sent an email notification
whenever content has been added ormodified in that space.
Wiki
Pioneered by Ward Cunningham, and named after the Hawaiian word
for 'quick', a wiki is a website thatmakes it easy for anyone to
contribute pages, and link them together.
RELATED TOPICS
Confluence Icons
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
30
Confluence Icons
This page last changed on Jun 16, 2008 by smaddox.
Icons are used throughout Confluence to provide quick links and
indicators. The most frequently usedicons are:
Icon Description
Go to the people directory.
View a user profile.
Go to a personal space.
Go to a global space.
View a space's homepage.
View a page.
Add a page.
Add a child page to the current page.
View a piece of news.
Add a piece of news.
This page has been edited since you last viewedit. Click to view
the page.
View a comment.
Add a comment.
View a piece of archived mail that has beenimported into
Confluence.
View a page that has been imported intoConfluence.
View an attachment.
This link goes to an attachment.
This link goes to a destination outside Confluence.
This page/space/person is currently a favourite.Click to remove
from your favourites.
Add this page, space or person to your favourites.
You are currently watching this page or space.Click to stop
watching.
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
31
Start watching this page or space.
Go to the RSS feed builder.
Subscribe to a pre-defined RSS feed.
View a printable version of this page.Note: From Confluence 2.8,
most pages do notshow this icon. You can print a Confluence pagevia
your browser's print option.
Export the contents of this space.
Define labels.
Choose a space's theme.
Choose a space's colour scheme.
Define a layout for a space, its pages and/or newsitems.
View space permissions.
View page permissions.
Icons next to links
Your Confluence administrator can configure Confluence to
display or hide the icons next tolinks on the wiki page,
distinguishing external links, user links and email links.
RELATED TOPICS
Showing Link IconsDashboardConfluence Glossary
Take me back to Confluence User Guide
http://confluence.atlassian.com/display/DOC/Showing+Link+Iconshttp://confluence.atlassian.com/display/DOC/Showing+Link+Icons
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
32
Confluence Notation Guide Overview
This page last changed on Jul 12, 2007 by smaddox.
Confluence pages are stored internally in a simple
content-formatting language called Wiki Markup, basedon
Textile.
The Wiki Markup Editor allows you to edit Confluence pages
directly in wiki markup language. This hasthe advantage of being
faster than the Rich Text Editor for some formatting tasks.
A quick notation guide, Notation Help, appears beside the edit
screen when you choose the Wiki Markupedit tab. You can then click
the full notation guide link in the help window to view the full
Notation Guide.This shows you the entire list of formatting and
other complex operations that Confluence's notationpermits, along
with the markup detailing how to perform them.
Try it now
Because wiki markup is designed to be simple to learn, the
quickest way to learn wikimarkup is to edit an existing page,
switch to the wiki markup editor and experiment.
Below are some links to more information on wiki markup
editing:Full Notation GuideWorking with HeadingsWorking with Text
EffectsWorking with Text BreaksWorking with LinksWorking with
AnchorsWorking with ImagesWorking with ListsWorking with
TablesWorking with MacrosConfluence Emoticons
What does the Notation Guide contain and why is it not part of
theConfluence User Guide?
The Confluence Notation Guide is included as part of the
Confluence code and is dynamically generatedwhen you view it. Its
contents depend upon:
• the macro plugins available in the Confluence installation•
the documentation included by the plugin developer for the
installed version of the plugin.
If you view the Full Notation Guide from the Atlassian
Confluence site, you will see the information forthe macro plugins
currently installed on this site. If you view the Full Notation
Guide from your ownConfluence instance, you will see information
for the macro plugins installed on your site.
The plugin developer writes the help file and includes it in the
macro code.
Examples of Markup
Here's a short example of some typical markup:
What you type What you get
h4. Confluence Markup
Ideally, the markup should be _readable_ and even *clearly
understandable* when you are
Confluence Markup
Ideally, the markup should be readable and evenclearly
understandable when you areediting it. Inserting formatting should
require fewkeystrokes, and little thought.
http://textism.com/tools/textile/http://confluence.atlassian.com/renderer/notationhelp.action?section=allhttp://confluence.atlassian.com/renderer/notationhelp.action?section=allhttp://confluence.atlassian.comhttp://confluence.atlassian.com/display/DOC/Documenting+Macros
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
33
editing it. Inserting formatting should require few keystrokes,
and little thought.
After all, we want people to be concentrating on the words, not
on where the angle-bracketsshould go.
* Kinds of Markup** Text Effects** Headings** Text Breaks**
Links** Other
After all, we want people to be concentrating onthe words, not
on where the angle-bracketsshould go.
• Kinds of Markup° Text Effects° Headings° Text Breaks° Links°
Other
Here, in comparison, is how that would look if you had to edit
the page in HTML:
Confluence Markup
Ideally, the markup should be readable and even clearly
understandablewhen you are editing it. Inserting formatting should
require few keystrokes, and little thought
After all, we want people to be concentrating on the words, not
on where the angle-brackets shouldgo.
Kinds of Markup Text Effects Headings Text Breaks Links
Other
RELATED TOPICS
Full Notation GuideRich Text Editor OverviewWriting Confluence
pagesCreating a New PageWorking with Macros
Take me back to Confluence User Guide
http://confluence.atlassian.com/renderer/notationhelp.action?section=all
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
34
Confluence Emoticons
This page last changed on Jun 17, 2007 by
[email protected].
Emoticons are little images you can easily use in a Confluence
page. They use a simple wiki markup asshown below, or you can
insert them using the Rich Text editor.
Graphical emoticons (smileys).
Notation Image
:)
:(
:P
:D
;)
(y)
(n)
(i)
(/)
(x)
(!)
(+)
(-)
(?)
(on)
(off)
(*)
(*r)
(*g)
(*b)
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
35
(*y)
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
36
Form Field Markup for Templates
This page last changed on Jun 26, 2008 by smaddox.
Templates are written in the same notation as other pages in
Confluence with special markup to insertform fields. When a user
creates a page using a template that contains form fields, the user
will beprompted to key in data. The data will be captured and
stored in the new page.
Here are the three kinds of form fields supported and the markup
to create them:
Text field @VAR@ Creates a text input field for avariable called
VAR.
Text area @VAR|textarea(5,10)@ Creates a 5 x 10 text-area for
avariable called VAR.
Drop down menu @VAR|list(one,two,three,four)@ Creates a
drop-down boxcontaining the values "one","two", "three" and
"four".Note: The values in thedrop-down list can onlycontain
letters, numbers andunderscores.The dropdown list values
cannotinclude:
• special characters, such as'&'
• punctuation marks, such as':'
• brackets, such as ')'
Every input field must have a unique name. If you have more than
one text input field in the sametemplate with the same name,
Confluence will make sure that they all end up with the same value
(Thisis useful if you need the same information in more than one
place in the page).
For an example, please see Adding a Template.
WarningThere must be no spaces between the @-signs in the
markup. This means you can't haveitems in your drop-down lists that
contain spaces.
Improved Markup
The above formatting is the basic markup bundled with
Confluence, but two plugins expand on thismarkup to provide greater
functionality. Links to these plugins and a comparison can be found
in theWorking with Templates Overview.
RELATED TOPICS
Working with Templates OverviewScaffolding PluginZones
PluginAdding a TemplateEditing a templateCreating a Page using a
Template
Take me back to Confluence User Guide
http://confluence.atlassian.com/display/CONFEXT/Scaffolding+Pluginhttp://confluence.atlassian.com/display/CONFEXT/Zones+Plugin
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
37
Working with Headings
This page last changed on Aug 06, 2007 by
[email protected].
You can use Confluence Notation or the Rich Text editor to
create headers.
Creating a header is easy. Simply place "hn." at the start of
your line (where n can be a number from1-6).
What you need to type What you will get
h1. Biggest heading Biggest heading
h2. Bigger heading Bigger heading
h3. Big heading Big heading
h4. Normal headingNormal heading
h5. Small headingSmall heading
h6. Smallest headingSmallest heading
Note that Confluence treats all headings as anchors.
RELATED TOPICS
Rich Text-Working with Text EffectsWorking with Text
EffectsWorking with Macros
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
38
Working with Lists
This page last changed on Oct 24, 2007 by smaddox.
Confluence allows you to create bulleted or numbered lists, and
is flexible enough to allow a combinationof the two lists.
If you need to separate the text within lists using line breaks,
make sure you do so using a doubleslash (//). Empty lines may
disrupt the list.
Simple lists
Use the hyphen (-) to create simple lists.Make sure there is a
space between the hyphen and your text.
What you need to type What you will get
- some- bullet- points
• some• bullet• points
Bulleted lists
Use the asterisk (*) to create bullets. For each subsequent
level, add an extra asterisk.Make sure there is a space between the
asterisk and your text.
What you need to type What you will get
* some* bullet** indented** bullets* points
• some• bullet
° indented° bullets
• points
Numbered lists
Use the hash (#) to create numbered lists.Make sure there is a
space between the hash and your text.
What you need to type What you will get
# a# numbered
1. a2. numbered3. list
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
39
# list
A second level of hashes will produce a sub-list, such as the
alphabetical sub-list shown below.
What you need to type What you will get
# Here's a sentence.## This is a sub-list point.## And a second
sub-list point.# Here's another sentence.
1. Here's a sentence.a. This is a sub-list point.b. And a second
sub-list point.
2. Here's another sentence.
Try a third level of hashes to produce a sub-sub-list.
What you need to type What you will get
# Here's a sentence.## This is a sub-list point.### Third list
level.### Another point at the third level.## And a second sub-list
point.# Here's another sentence.
1. Here's a sentence.a. This is a sub-list point.
i. Third list level.ii. Another point at the third level.
b. And a second sub-list point.2. Here's another sentence.
In numbered lists as described above, the format of the 'number'
displayed at each listlevel may be different, depending upon your
browser and the style sheets installed on yourConfluence instance.
So in some cases, you may see letters (A, B, C, etc; or a, b, c,
etc) orRoman numerals (i, ii, iii, etc) at different list
levels.
Mixed lists
What you need to type What you will get
# Here#* is#* an# example#* of#* a# mixed# list
1. Here• is• an
2. example• of• a
3. mixed4. list
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
40
RELATED TOPICS
Working with Text BreaksConfluence Notation Guide Overview
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
41
Working with Tables
This page last changed on Oct 17, 2007 by smaddox.
You can use Confluence wiki markup or the Rich Text editor to
create tables. Below are some guidelineson using wiki markup to
create tables.
Confluence allows you to create two types of tables.
Table Type 1
Allows you to create a simple table with an optional header row.
You cannot set the width of the columnsin this table.Use double
bars for a table heading row.
What you need to type:
||heading 1||heading 2||heading 3|||cell A1|cell A2|cell
A3||cell B1|cell B2|cell B3|
What you will get:
heading 1 heading 2 heading 3
cell A1 cell A2 cell A3
cell B1 cell B2 cell B3
Currently, Confluence does not support nested tables.
You can also use a vertical header.
What you need to type:
||heading 1|col A1|col A2|col A3| ||heading 2|col B1|col B2|col
B3|
What you will get:
heading 1 col A1 col A2 col A3
heading 2 col B1 col B2 col B3
Table Type 2
This method allows you to specify the width of the columns in
the table.
What you need to type
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
42
{section:border=true}
{column:width=30%}Text for this column goes here. This is the
smaller column with a width of only 30%.{column}
{column:width=70%}Text for this column goes here. This is the
larger column with a width of 70%.{column}
{section}
What you will get
Text for this column goes here. This is the smallercolumn with a
width of only 30%.
Text for this column goes here. This is the largercolumn with a
width of 70%.
For more details please see the Column Macro and the Section
Macro.
Advanced Formatting
Colour and Other Formatting
To add colour and other formatting to your tables, you can use
the Panel Macro within columns.More table-formatting options may be
available if your Confluence administrator has installed
additionalmacros.
Lists
Here's an example of how to embed lists in a table:
What you need to type
||Heading 1||Heading 2|||* Item 1* Item 2* Item 3|# Item 1# Item
2# Item 3|
What you will get
Heading 1 Heading 2
• Item 1• Item 2• Item 3
1. Item 12. Item 23. Item 3
RELATED TOPICS
Rich Text-Working with TablesWorking with Macros
http://confluence.atlassian.com/display/CONFEXT/Macros
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
43
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
44
Working with Text Breaks
This page last changed on Mar 31, 2008 by mseager.
Paragraph break
An empty line produces a new paragraph. Most of the time,
explicit paragraph breaks are not required -Confluence will be able
to paginate your paragraphs properly.
Line break
Use two backslashes
(\\)
to create a line break.
What you need to type What you will get
here is some text\\divided\\using line\\breaks
here is some textdividedusing linebreaks
Horizontal ruler
Use four dashes (----) to create a horizontal ruler.
Make sure that the dashes are in a separate line from the
text.
What you need to type What you will get
here is some text----dividedby a horizontal ruler
here is some text
dividedby a horizontal ruler
RELATED TOPICS
Working with ListsConfluence Notation Guide Overview
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
45
Working with Text Effects
This page last changed on Jul 02, 2007 by smaddox.
Use the markup shown in the examples below to format the text in
your pages.
What you need to type What you will get
*strong* strong
_emphasis_ emphasis
??citation?? citation
-deleted- deleted
+inserted+ inserted
^superscript^ superscript
~subscript~ subscript
{{monospaced}} monospaced
bq. Here's how you make text in a paragraph intoa block
quotation
Here's how you make text in aparagraph into a block
quotation
{color:red}look ma, red text!{color} look ma, red text!
RELATED TOPICS
Working with Headings
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
46
Customising Look and Feel
This page last changed on Jul 09, 2007 by smaddox.
Confluence allows you to customise the 'look and feel' of an
individual space on the Confluence instancethrough options
available in the Space Administration menu. By default, the look
and feel of a space isbased on global settings configured from the
Administration Console.
You need to be a space administrator to edit the look and feel
of a space.
• Applying A Theme To A Space• Change Confluence Browser Icon•
Changing a Space's Logo• Customising Homepage• Editing a Space's
Colour Scheme• Modifying Confluence Layouts Using Custom
Decorators
RELATED TOPICS
Browsing a spaceAdministrator's Guide - Design and Layout
Take me back to Confluence User Guide
http://confluence.atlassian.com/display/DOC/Design+and+Layout
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
47
Applying A Theme To A Space
This page last changed on May 07, 2008 by edawson.
Themes allow you to personalise the 'look and feel' of
Confluence. Themes can can be applied acrossConfluence or to
individual spaces. Use themes if you want to add a new
functionality or significantly alterthe appearance of
Confluence.
Themes are created and installed from the Administration Console
by site administrators. Once a themehas been installed, a space
administrator can then apply it to the space.
By default, no themes are applied and the look and feel of a
space conforms to global look and feelsettings.
To apply a theme to a space,
1. Go to the 'Space Admin' tab of the Browse Space view. To do
this:
• Go to a page in the space, open the 'Browse' menu and select
'Space Admin'. The 'SpaceAdministration' view will open.
'Space Admin' is only displayed if you are a space
administrator.
2. Now click 'Themes' in the left panel under the heading 'Look
and Feel'. This will bring up a newscreen. Any themes installed
will be listed here. See screenshot below.
3. Click a radio button to select a theme.4. Click
'Confirm'.
Screenshot : Applying a theme
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
48
RELATED TOPICS
Editing a Space's Colour SchemeCustomising Look and Feel
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
49
Change Confluence Browser Icon
This page last changed on Jun 17, 2007 by
[email protected].
The Confluence logo 'Cannot resolve external resource into
attachment.' is displayed in the user's browserto identify the
Confluence browser tab. To use a custom image for your Confluence
site:
1. Obtain or create am image in PNG file format. For browser
compatibility, it must be 32x32 pixel,71x71 DPI and have 8 bit
colour depth
2. In your Confluence install, find the
...\confluence\images\icons subdirectory3. Backup the file
favicon.png4. Replace the favicon.png with your custom PNG image5.
Restart your application server
Users may need to clear their browser cache to view the new
image.
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
50
Changing a Space's Logo
This page last changed on May 07, 2008 by edawson.
In Confluence, you can replace the default logo for a space with
a logo of your own choice.
You need to be a space administrator to replace a space's
logo.
The instructions below refer to global spaces. For your personal
space, your profile picture is used asthe space icon.
To change a space's logo,
1. Go to the 'Space Admin' tab of the Browse Space view. To do
this:
• Go to a page in the space, open the 'Browse' menu and select
'Space Admin'. The 'SpaceAdministration' view will open.
'Space Admin' is only displayed if you are a space
administrator.
2. Click on 'Change Space Logo' in the left panel under the
heading 'Look and Feel'. This will bring up anew screen. See
screenshot below.
3. Use the browse option to locate the new logo and click
'Upload'.
Screenshot : Change space's logo
RELATED TOPICS
Customising Look and Feel
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
51
Customising Homepage
This page last changed on May 07, 2008 by edawson.
Registered users of the site can choose the page to which they
are directed after they log in toConfluence. By default, users are
directed to the Dashboard after logging in.
To set the site home page,
1. Open the 'General Preferences' view. The page Navigating to
the General Preferences View does notexist.
2. Click the 'Edit Profile' tab.3. Click 'General', under
'Preferences' on the left navigation bar.4. From the drop-down menu
beside Site Homepage, select a space. Note that only the list of
spaces
to which you have 'view' access is displayed here. Selecting a
space will direct you to its home pagewhen you log in.
5. Click 'Save'.
Screenshot: General Preferences Settings
RELATED TOPICS
User Profile OverviewSpace Homepage
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
52
Editing a Space's Colour Scheme
This page last changed on May 07, 2008 by edawson.
Confluence allows you to customise the colour scheme of a space.
By default, a space's colour scheme isbased on global settings
configured from the Administration Console.
You need to be a space administrator to edit a space's colour
scheme.
To change the colour scheme for a space,
1. Go to the 'Space Admin' tab of the Browse Space view. To do
this:
• Go to a page in the space, open the 'Browse' menu and select
'Space Admin'. The 'SpaceAdministration' view will open.
'Space Admin' is only displayed if you are a space
administrator.
2. Click 'Colour Scheme' in the left-hand panel under the
heading 'Look and Feel'. This will bring up anew screen.
3. Click the 'Select' button next to a colour scheme under
'Custom Colour Scheme' (if not alreadyselected).
4. Click the 'Edit' link. This will bring up a new screen. See
screenshot below.5. Enter standard HTML/CSS2 colour codes, or use
the colour-picker
to choose a new colourfrom the palette provided. Any changes you
make will immediately be reflected in this space.
The colour scheme applies to the following UI elements:
• Top Bar - the bar across the top of the page that contains the
breadcrumbs• Tab Navigation Background - the background colour of
the tab navigation menus• Tab Navigation Text - the text of the tab
navigation menus• Breadcrumbs Text - the breadcrumbs text in the
top bar of the page• Space Name Text - the text of the current
space name located above the page title• Heading Text - all heading
tags throughout the space• Links - all links throughout the space•
Borders and Dividers - table borders and dividing lines• Tab
Navigation Background Highlight - the background colour of the tab
navigation menu when
highlighted• Tab Navigation Text Highlight - the text of the tab
navigation menu when highlighted• Top Bar Menu Selected Background
- the background colour of the top bar drop down menu when
selected• Top Bar Menu Item - the text colour of the menu items
in the top bar drop down menu• Page Menu Selected Background - the
background colour of the drop down page menu when
selected• Page Menu Item Text - the text of the menu items in
the drop down page menu• Menu Item Selected Background - the
background colour of the menu item when selected (applies
to both the top bar and page drop down menus)• Menu Item
Selected Text - the text colour of the menu item when selected
(applies to both the top
bar and page drop down menus)
Please note that some UI elements are specific to the default
theme and may not take affect for otherthemes.
Screenshot : Editing a space's colour scheme
http://confluence.atlassian.com/display/DOC/Customising+Colour+Schemes
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
53
Handy HintIf you mess things up, just click the 'Reset' button
and then try again.
RELATED TOPICS
Customising Look and Feel
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
54
Modifying Confluence Layouts Using Custom Decorators
This page last changed on Jul 06, 2008 by mryall.
If you modify the look and feel of Confluence by following these
instructions, you willneed to update your customisations when
upgrading Confluence. The more dramatic thecustomisations are, the
harder it will be to reapply your changes when upgrading.
Pleasetake this into account before proceeding with your
customisation.
Confluence is built on top of the Open Source SiteMesh library,
a web-page layout system that provides aconsistent look and feel
across a site. SiteMesh works through 'decorators' that define a
page's layout andstructure.
To edit the layout of Confluence, you will need to modify these
decorator files. A decorator file is a vmdfile and is written in a
very simple programming language called Velocity. Learn more about
Velocity.Once you become familiar with Velocity, you can edit the
decorator files to personalise the appearance ofConfluence.
You need to have System Administrator permissions in order to
perform this function.
• You can customise the layouts for a particular space or for
the whole site. This pagetells you how to customise layouts for a
space. To customise the global layouts, usethe 'Layout' menu on the
'Administration' page.
• When you upgrade Confluence, you must reapply your custom
layouts to the newdefault layouts.
These files are grouped into:
Site layouts : These are used to define the controls that
surround each page in the site. For example, ifyou want to make
changes to the header and the footer, you will need to modify these
layouts.
Content layouts : These control the appearance of content such
as pages and news items: they don'tchange the way the pages
themselves are displayed, but they allow you to alter the way the
surroundingcomments or attachments are shown.
Export Layouts: These control the appearance of spaces and pages
when they are exported to HTML.If you are using Confluence to
generate a static website, for example, you will need to modify
theselayouts.
Learn more about using decorators.
To edit a decorator file,
1. Go to the 'Space Admin' tab of the Browse Space view. To do
this:
• Go to a page in the space, open the 'Browse' menu and select
'Space Admin'. The 'SpaceAdministration' view will open.
'Space Admin' is only displayed if you are a space
administrator.
2. Click the 'Layout' link in the left panel under the heading
'Look and Feel'. A list of the layouts for thespace is listed.
• Click 'View Default' to view the vmd file.• Click 'Create
Custom' to edit the default vmd file. This will open up the vmd
file in edit mode.
Make changes and click 'Update'.
Screenshot : Edit Layouts Example
http://jakarta.apache.org/velocity/user-guide.htmlhttp://confluence.atlassian.com/display/DOC/Global+Permissions+Overviewhttp://confluence.atlassian.com/display/DOC/Upgrading+Custom+Layoutshttp://www.opensymphony.com/sitemesh
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
55
Click thumbnail to view an example of a vmd file:
RELATED TOPICS
Customising Look and FeelApplying A Theme To A
SpaceAdministrator's Guide - Design and Layout
Take me back to Confluence User Guide
http://confluence.atlassian.com/download/attachments/145958/vmdfile.PNGhttp://confluence.atlassian.com/display/DOC/Design+and+Layout
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
56
Dashboard
This page last changed on Jun 17, 2007 by
[email protected].
The Dashboard is the front page of a Confluence site. It
provides an overview of the site, access to allspaces to which you
have 'view' permission, and displays a list of the most recently
updated contentwithin them.
You can go to the Dashboard from any page on your site by
clicking on the logo beside the page title orvia the Breadcrumbs
(the "You are here" path) located at the top of every page.
The dashboard is divided into five sections:
1. The Welcome Message for the site, which is configured from
the Administration Console.2. A list of the spaces within the site
to which you have access, presented via convenient tabs: 'My',
'Team', 'New' or 'All' spaces. See Customising the Dashboard.3.
A list of the most Recently Updated documents on the site from the
spaces listed. For example, if
you click on the tab 'Team', the recently updated content from
your team spaces will be listed here.4. A list of your Favourite
Pages. See Working with Favourites.5. Useful links:
a.
— see Setting up aNew Global Space
b.
— see Using the RSSFeed Builder
c. — see Searching the
People Directory
The Dashboard is the only place in Confluence from where you
can:
• access all existing spaces on the site.• add a new space to
the site.
By default, the Dashboard is also the site homepage. However,
you can set any other page in Confluenceas the homepage via the
Space Admin tab or your User Profile settings.
Screenshot : Dashboard
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
57
RELATED TOPICS
Confluence GlossaryConfluence IconsWorking with Spaces
Overview
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
58
Customising the Dashboard
This page last changed on Sep 26, 2007 by smaddox.
You can customise the Dashboard to provide access to the content
on the site that is most relevant toyou.
Here's how:
1. Add spaces as your favourites.
Once you add spaces as your favourites, you can click on the
'My' tab in the spaces section of theDashboard to view a list of
only your favourite spaces. The 'Recently updated' section in this
view will alsodisplay content only from these spaces.
2. Provide spaces with Team labels.
Team labels are used to group together related spaces. For
example, you may want to group togetherall spaces relating to a
project team. Once you add team labels, you can click on the 'Team'
tab in thespaces section, select a team from the drop down menu,
and have only the list of spaces pertaining tothat team displayed.
The 'Recently updated' section in this view will also display
content only from thesespaces.
The Dashboard remembers which one of the views, 'My', 'Team',
'All' or 'New' you were most recentlyviewing. So if you clicked the
'My' tab on this visit, next time around, as soon as you log in to
Confluence,only the list of your favourite spaces and the recently
modified content within them will be displayed toyou.
3. Add pages as your favourites.
Whichever view you are in, the Dashboard will display a list of
your five most recently added favouritepages, so you can access
those pages easily.
Screenshot : The Dashboard
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
59
RELATED TOPICS
Working with Labels OverviewWorking with Favourites Overview
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
60
Displaying an Image
This page last changed on May 07, 2008 by edawson.
You can display an image from either a file attached to the
Confluence page, or from another location.
This page shows you how to display an image using Confluence
Notation, also known as Wiki Markup.
Using the 'Insert Image' icon
Instead of Wiki Markup, you can use the 'Insert Image' icon.
This behaves in a similar wayfor both the Wiki Markup and the Rich
Text editor, as described in Inserting an image.
To follow the instructions below, you need to edit in 'Wiki
Markup' mode. Put an exclamation point beforeand after the image
link.
Displaying an image from a remote location
You need to know the URL from which the image can be linked.
What you need to type What you will get
!http://www.atlassian.com/images/confluence_feature.gif!
Cannot resolve external resource into attachment.
Displaying an image attached to a page
• First, attach the image to the page.• Now you can display the
attached image:
What you need to type What you will get
!fish.gif!
Displaying an image attached to another Confluence page
What you need to type What you will get
!Space attachments directory^fish.gif!
Where 'Space Attachments Directory' is the name of the page
containing the attachment.
Usage example
What if you want to upload an image only once, but display it on
many pages?
• Attach the image to a page, such as our page called the 'Space
attachments directory'.• Link to the uploaded image using the
syntax described above.
To view the image, the user needs to have view permission for
the page to which it is attached.
http://confluence.atlassian.com/display/DOC/Space+Attachments+Directory
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
61
Displaying an image attached to page in a difference space
!SPACE:my page^myimg.jpg!
Formatting an image
What you need to type What you will get
!fish.gif|align=right,border=2,bordercolor=blue!
Displaying alternative text
Use the HTML title attribute to specify text which is displayed
when the pointer is hovering over animage. Use the alt attribute to
specify alternative text to be included in the HTML code.
What you need to type What you will get
!fish.gif|title="I am a fish"!
!fish.gif|alt="I am a fish"!
HTML image attributes
For any image, you can also specify attributes of the HTML image
tag as a comma-separated list ofname=value pairs. Available image
tags include:
• align — available values are 'left', 'right', 'bottom',
'center', 'top'.• border — specify the width of the border (in
pixels).• bordercolor — use this with the above 'border' tag to
specify the colour of the image border. Specify
the colours by name or by hex value. See more information about
web colours. (Available withConfluence 2.6.2 and later.)
• hspace — specify the amount of whitespace to be inserted to
the left and right of the image (inpixels).
• vspace — specify the amount of whitespace to be inserted above
and below the image (in pixels).• width — specify the width of the
image (in pixels). This will override the natural width of the
image.• height — specify the height of the image (in pixels). This
will override the natural height of the
image.• title — specify alternative text for the image, which is
displayed when the pointer hovers over the
image• alt — specify alternative text, which is included in the
HTML code. This text is retrievable via search,
and contributes to accessibility of the page for text-only
viewing.
RELATED TOPICS
Linking an image to another page or URLRich Text-Inserting an
imageAttaching Files to a PageImage File Formats
http://www.answers.com/web+colors?cat=technology
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
62
Thumbnail MacroGallery Macro
Take a look at some plugins too.
First read the warning on support of third-party plugins.
• ImageMap Plugin• Other image and visualisation plugins
Take me back to Confluence User Guide
http://confluence.atlassian.com/display/DEVNET/Atlassian+Supported+Pluginshttp://confluence.atlassian.com/display/CONFEXT/ImageMap+Pluginhttp://confluence.atlassian.com/display/CONFEXT/Image+and+Visualisation
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
63
Image File Formats
This page last changed on Jun 17, 2007 by
[email protected].
Confluence allows you to attach image files of any format to a
page. However, your ability to display themdepends on the image
file formats supported by the browser you are using.
Confluence supports the following image formats for its
Thumbnail and Gallery macros :
• gif• jpeg• png
The bmp format is not supported.
RELATED TOPICS
Displaying an ImageThumbnail MacroGallery Macro
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
64
Exporting a Space
This page last changed on Jun 17, 2007 by
[email protected].
Confluence allows you to export a part of, or the entire
contents of a space to HTML, PDF or XML.
What would you like to do?
Export from Confluence to PDFExport from Confluence to
HTMLExport from Confluence to XML
RELATED TOPICS
Browsing a space
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
65
Confluence to HTML
This page last changed on May 11, 2008 by edawson.
Confluence allows you to export a part of, or the entire
contents of a space into a zipped archive of HTMLfiles. This is
useful if you want convert your space into a static web site.
To export to HTML, you will need 'Export Space' permission which
is assigned by a space administratorfrom the Space Administration
screens. See Space Permissions or contact a space administrator for
moreinformation.
To export to HTML,
1. Go to the 'Advanced' view for the page. To do this:
• Go to a page in the space, open the 'Browse' menu and select
'Advanced'. The 'Advanced' viewwill open.
2. Click on 'Export Space' in the left panel.3. Click the radio
button to select HTML from the list of export options.4. Check the
box 'Include Comments' if you want to include comments for the
pages you are
exporting.5. Select the pages you want to export by checking the
boxes in the tree view of pages displayed.
By default, all pages are selected. You have the option to
'Check All' or 'Clear All' pages. Seescreenshot.
6. Click 'Export'. This will create a zipped archive of html
files.7. Extract the files into a folder.
• Page attachments are placed in individual folders named using
the format :'nameofpage_attachments'.
• By default, the 'Space Details' page is exported as index.html
and displays the space's details aswell as a list of all available
pages within it.
Screenshot : Select Pages
RELATED TOPICS
Confluence to PDFConfluence to XML
Take me back to Confluence User Guide
-
Document generated by Confluence on Aug 07, 2008 22:47 Page
66
Confluence to PDF
This page last changed on May 11, 2008 by edawson.Confluence
allows you to export a single page, a part of a space, or an entire
space into a single PDF file.
Exporting Single Pages
You can export a single page in Confluence to PDF simply by
doing the following.
The page Navigating to the Export PDF Option does not exist.
If you wish to export multiple particular pages or the entire
space, follow the instructions below.
Exporting Multiple Pages or the Entire Space
To export to PDF, you will need 'Export Space' permission which
is assigned by a space administratorfrom the Space Administration
screens. See Space Permissions or contact a space administrator for
morei