Atlassian Confluence: Difference between revisions

The educational technology and digital learning wiki
Jump to navigation Jump to search
Line 7: Line 7:
'''Atlassian Confluence''' is an "enterprise" [[wiki]].
'''Atlassian Confluence''' is an "enterprise" [[wiki]].


Notice: I created this page because I need to know how the [[http://wiki.lamsfoundation.org/ LAMS wiki works]] in order to help with [[software localization]]. At some point, contents may be made more generic - [[User:Daniel K. Schneider|Daniel K. Schneider]] 10:43, 25 February 2010 (UTC)
Notice: I created this page because I need to know how the [http://wiki.lamsfoundation.org/ LAMS wiki works] in order to help with [[software localization]]. At some point, contents may be made more generic - [[User:Daniel K. Schneider|Daniel K. Schneider]] 10:57, 25 February 2010 (UTC)


== Structure of a confluence wiki ==
== Structure of a confluence wiki ==


Confluence is organised in spaces (i.e. some kind of sub-wikis)
Confluence is organised in spaces (i.e. some kind of sub-wikis)
Each space contains a hierarchically organised set of pages. Links between pages are possible
Each space contains a hierarchically organised set of pages. Links between pages are possible.
 
{{quotationbox|Pages are the primary means of storing and sharing information in Confluence. Pages are contained within spaces.
* Use spaces to organise your wiki content into your primary logical groups. For example, you could have a space per team, per product or per department.
* Use pages to organise your content into lower-level groups. For example, you could have a page for a particular team activity, or for a feature in a product, or for a chapter in a book. Then add more child pages to contain lower-level details if necessary. ([http://confluence.atlassian.com/display/DOC/Working+with+Pages+Overview Working with Pages Overview], retrieved 10:57, 25 February 2010 (UTC)).
}}


=== Navigation and page headers and footers ===
=== Navigation and page headers and footers ===
Line 18: Line 23:
Top left: Hierarchial navigation menu:
Top left: Hierarchial navigation menu:
  Dashboard > Space > Page > Subpage > ...
  Dashboard > Space > Page > Subpage > ...
Top right: Various user actions like user settings and search
Top right: User menu and search
Top right: Add page and Add Blog Post
Top right: Add page and Add Blog Post


Line 25: Line 30:
=== The Dashboard ===
=== The Dashboard ===


{{quotation|The Dashboard is the front page of a Confluence site. It provides an overview of the site, access to all spaces to which you have 'view' permission, and displays a list of the most recently updated content within them.}} ([http://confluence.atlassian.com/display/DOC/Dashboard Dashboard], retrieved 10:43, 25 February 2010 (UTC)).
{{quotation|The Dashboard is the front page of a Confluence site. It provides an overview of the site, access to all spaces to which you have 'view' permission, and displays a list of the most recently updated content within them.}} ([http://confluence.atlassian.com/display/DOC/Dashboard Dashboard], retrieved 10:57, 25 February 2010 (UTC)).


The Dashboard includes:
The Dashboard includes:
Line 42: Line 47:


Confluence page can be edited either through a Wysiwyg editor or with Wiki markup.
Confluence page can be edited either through a Wysiwyg editor or with Wiki markup.
=== Page creation ===
; Page creation
By default, Confluence will add the page as a child of the page you are viewing !
There are two methods:
* Add Page (top right) will add a page to the current space
* Creating an undefined Link (the traditional wiki way)
[Link to new page] (single brackets)
; Space creation
* To create a new personal space (permission is needed): In the User menu (pull-down menu with your name): Create Personal Space
; Moving pages in the hierarchy
* A page can be moved in a hierarchy by editing its '''Location'''.


=== Wiki Markup Syntax ===
=== Wiki Markup Syntax ===
Line 52: Line 73:
(I will remove this section once I am done with a draft ...)
(I will remove this section once I am done with a draft ...)


; General
* Include an obvious help button
* Include an obvious help button
; Translators
* Should get Personal Space permission (for trying out)


== Links ==
== Links ==

Revision as of 12:57, 25 February 2010

Draft

This article or section is currently under construction

In principle, someone is working on it and there should be a better version in a not so distant future.
If you want to modify this page, please discuss it with the person working on it (see the "history")

<pageby nominor="false" comments="false"/>

Introduction

Atlassian Confluence is an "enterprise" wiki.

Notice: I created this page because I need to know how the LAMS wiki works in order to help with software localization. At some point, contents may be made more generic - Daniel K. Schneider 10:57, 25 February 2010 (UTC)

Structure of a confluence wiki

Confluence is organised in spaces (i.e. some kind of sub-wikis) Each space contains a hierarchically organised set of pages. Links between pages are possible.


Pages are the primary means of storing and sharing information in Confluence. Pages are contained within spaces.

  • Use spaces to organise your wiki content into your primary logical groups. For example, you could have a space per team, per product or per department.
  • Use pages to organise your content into lower-level groups. For example, you could have a page for a particular team activity, or for a feature in a product, or for a chapter in a book. Then add more child pages to contain lower-level details if necessary. (Working with Pages Overview, retrieved 10:57, 25 February 2010 (UTC)).

Navigation and page headers and footers

Top left: Hierarchial navigation menu:

Dashboard > Space > Page > Subpage > ...

Top right: User menu and search Top right: Add page and Add Blog Post

Footer: List of subpages ("children")

The Dashboard

“The Dashboard is the front page of a Confluence site. It provides an overview of the site, access to all spaces to which you have 'view' permission, and displays a list of the most recently updated content within them.” (Dashboard, retrieved 10:57, 25 February 2010 (UTC)).

The Dashboard includes:

  • The usual page header (see above)
  • Left column:
    • A list of all the viewable spaces or private space
    • At the bottom: Create space (for those who can), Feed builder, people directory.
  • Right column:
    • Recently updated pages (from all spaces)
    • Favorite pages

Typical page structure

Page editing

Confluence page can be edited either through a Wysiwyg editor or with Wiki markup.

Page creation

Page creation

By default, Confluence will add the page as a child of the page you are viewing !

There are two methods:

  • Add Page (top right) will add a page to the current space
  • Creating an undefined Link (the traditional wiki way)
[Link to new page] (single brackets)
Space creation
  • To create a new personal space (permission is needed): In the User menu (pull-down menu with your name): Create Personal Space
Moving pages in the hierarchy
  • A page can be moved in a hierarchy by editing its Location.

Wiki Markup Syntax

Confluence Wiki Markup is complex

LAMS Wiki, to do list

(I will remove this section once I am done with a draft ...)

General
  • Include an obvious help button
Translators
  • Should get Personal Space permission (for trying out)

Links

Official
Examples