Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added Tasks instructions

Table of Contents

Expand

Table of Contents
outlinetrue

Livesearch
spaceKeyAT
placeholderSearch within this page
typepage

Introduction

Welcome to the Confluence Basic Training page, designed to help you quickly get up to speed with Confluence Data Center Environment.
Confluence is a collaboration wiki tool used to help teams to collaborate and share knowledge efficiently.  Dynamic pages gives a team a place to create, capture, and collaborate on any project or idea.

...

Whether you’re a new contributor, a space administrator, or part of a team, this training reference will help you work productively and maintain the quality and consistency of our knowledge base.

Info
Looking for more training material? Visit the Atlassian Confluence Data Center documentation.

Confluence access, permissions and restrictions

...

Use the site navigation menu to find people, pages, and apps no matter where you are in your Confluence site:  
Image RemovedImage Added

  • Tap Home or the Confluence logo (  ) to return to your Confluence  dashboard. Tap Recent to see a list of pages and blog posts you’ve visited or worked on, plus drafts and starred content.
  • Tap Spaces to move between your starred or recently visited spaces, or to access the space directory.
  • Tap People to visit the people directory, where you can find information about the people you work with and create teams.
  • Tap Apps to see a list of the apps that are installed on your site or visit an app’s dashboard.
  • Tap Create to create a new page from anywhere on your site.

...


More more information about Word document import read the following Atlassian page: Import a Word Document into Confluence

Video instructions (Video is in German, but the screenshots are clear).: https://www.youtube.com/watch?v=QUB9lB9EtA 

Page comments and inline comments

...

After you save your comment, the text on the page will be highlighted in yellow. To view comments, click any yellow highlighted text on the page. Just like page comments, your teammates can reply to or 'like' your inline comments.

Macro's 

...

You can use macros to:

  • change the format and layout of your page
  • display media like video, audio, and social media content
  • collate and organize Confluence pages, blogs, and files
  • perform actions from a page, such as creating a page from a template. 

Take your Confluence space to the next level using macros. 

...

create links to pages, blog posts, anchors, attachments, external websites, Jira issues and more.  Links can be text or images, and can be added in many different ways.

Links to pages within your Confluence site are relative, which means that you can move pages and rename pages without breaking links. 

Below paragraph explains the most common ways to create links. 

To create an association between a Jira issue and a Confluence page use the Jira issue/filter option, read Jira Issues Macro for instructions.

To insert a link on a page:

  1. In the editor, select some text or position your cursor where you want to insert the link.
  2. Select Link on the toolbar or use the keyboard shortcut Ctrl+K.
  3. Select a page, blog post or attachment, or enter an external URL (see below for how to link to particular types of content).
  4. Enter or modify the link text (this is the text that will appear on the page. If this field is left blank, the page name or URL will be used as the link text.)
  5. Select Insert.
  1. Select an image on your page.
  2. Select Link on the Image Properties toolbar.
  3. Select a page, blog post or attachment, or enter an external URL (see below for how to link to particular types of content).
  4. Select Insert.

Image Added

  1. Select the link text or image.
  2. Select Edit from the link properties toolbar.
  3. Modify the link and select Save.
  1. Select the link text or image.
  2. Select Unlink from the properties toolbar.

Image Added

Link to specific types of content

Confluence supports many methods like below for creating links, for more detailed documentations read the following Atlassian page: Links

  • Link to a page
  • Link a page in another space
  • Link to a blog post
  • Link to an attachment or image on this page
  • Link to an attachment on another page
  • Link to an external website
  • Link to an anchor on a page
  • Link to a heading on a page
  • Link to a comment on a page
  • Link to an undefined page (a page that does not exist yet)
  • Link to a personal space or user profile

Tables

With Confluence tables  you can use  the familiar table formatting options like resizing columns, coloring cells, rows and columns, aligning content, and table sorting by clicking the column headers to view the information the way you like it.

Insert a table

To create a table:

  1. Hit the Table button in the toolbar
  2. Click a cell in the drop-down to set the number of columns and rows in your table

Image Added

Edit your table

To resize table columns, just click and drag the column's border. To make other changes to your table, click inside it to reveal the table toolbar.

Here's a summary of the table tools:

Screenshot of a dropdown menu in the Table toolbar showing the options Responsive and Fixed width.Image Added

Column width modes

  • Responsive – choose this mode if you want the table to expand as you add content. You can drag to resize the columns. It'll also resize itself to fit the page-viewer's window size (within reason).
  • Fixed width – choose this mode if you want to drag column borders to set width. Columns appear at your set size, regardless of content and window size.

Screenshot showing the various icons relating to table rows in the tables toolbarImage Added

Rows

  • Insert rows before or after the current row
  • Delete the current row
  • Cut, copy and paste the current row
  • Mark a row as a header row (shaded with bold text)

Image Added

Columns

  • Insert columns before or after the current column
  • Delete the current column
  • Cut, copy and paste the current column
  • Mark a column as a header column (shaded with bold text)
  • Add a numbering column to automatically number each row

Image Added

Image Added

Cells

  • Merge selected cells
  • Split selected cells
  • Change cell color

Image Added

Alignment

  • Align content to top
  • Align content to middle
  • Align content to bottom 

Screenshot of the Delete Table icon on the tables toolbarImage Added

Table

  • Delete entire table

 

Sort the table

You can sort the contents of your table by selecting the sort icon in the table header row.

To preserve the order of a sorted table:

  1. Edit a page

  2. Go to the table, and select the sort icon for the column you want to sort

  3. Select Publish to save the changes

Screenshot: A colorful, sortable table

Image Added

You can use the Cut row and Paste row icons to move rows around in the editor. 

For more information about Tables read Atlassian page: Tables

Tasks

Keep track of the things that need to get done with tasks. With the ability to give each task an assignee and due date, and plenty of ways to see your tasks, you can make sure nothing slips through the cracks. 

Add a task

You can add tasks on any page in Confluence. For example, you might add tasks under action items on a meeting notes page, or in a requirements page – anywhere you need a lightweight task management solution.

To create a task:

  1. In the editor, choose the Task list Image Added button or use the keyboard shortcut [  ] 
  2. Start typing your task – @mention someone to assign the task to them, and type // and choose a due date

The first person you mention in a task is the assignee; you can even assign tasks to yourself.

Note
  • If you assign a task to someone who doesn't have permission to view the page or space, they won't see the task.  
  • Tasks with no text will not be shown in the Task report macro. 
  • The date picker can be triggered by typing // or by typing a date in the format dd/mm/yyyy or dd-mm-yyyy. Typing other date formats in the editor won't trigger the date picker.
  • Personal Tasks (created in the Workbox in older versions of Confluence) don't appear in the Tasks view or Task Report. To migrate any incomplete personal tasks, go to Workbox > Personal Tasks and follow the prompts.
  • The wiki markup based Tasklist Macro has been removed from the macro browser. If you have a Tasklist macro on a page it will continue to work, but you will be unable to add new Tasklists using this macro.


View tasks

There are a number of ways to keep track of tasks assigned to you, or tasks you've created for others. 
Basics for tasks are explained below for more information read the following Atlassian page: Add, Assign and View Tasks.

View tasks on a page
Image Added

View tasks in your profile 

Go to Profile > Tasks.

Use the filters to show tasks that were assigned to you or created by you in the last 6 months, and toggle between complete or incomplete tasks.

Image Added

View in a task report

 Create a task report:

    1. Choose Create > Task Report
    2. Select the type of report:
      • Assigned to my team – for tasks assigned to particular people.
      • In my project – for tasks that appear in a specific space or parent page.
      • Custom – for a wide range of filtering options, including by date or page label.
    3. Follow the prompts to create the report.

This blueprint uses the Task Report Macro. You can also choose to use this macro on an existing page, for example, on a project or team space homepage.

Image Added

Labels

Labels are key words or tags that you can add to pages, blog posts and attachments. You can define your own labels and use them to categorize, identify or bookmark content in Confluence.

For example, you could assign the label 'accounting' to all accounts-related pages on your site. You can then browse all pages with that label in a single space or across the site, display a list of pages with that label, or search based on the label.

Because labels are user-defined, you can add any word that helps you identify the content in your site.

Below the basics for label usage is explained,  if you want to know more read the following Atlassian page: Add, Remove and Search for Labels and Display Pages with Label Macros.

Label a page or blog post

Any user with permission to edit a page can add labels to it. Any existing labels appear at the bottom-right of the page, below the page content.

To add a label to a page or blog post:

  1. At the bottom of the page, choose Edit labels Image Added or hit L on your keyboard
  2. Type in a new label (existing labels are suggested as you type)
  3. Choose Add

Image Added

If you're editing or creating a page, and you want to add labels, choose the Edit label icon Image Added at the top of the page.

Search by label

You can use the ' labelText: ' prefix to search specifically for content that has a specific label. For example, if you're looking for pages with the label 'chocolate', type labelText:chocolate into the search field in the Confluence header.

For more examples of searching by label, see Confluence Search Syntax.

Macro's 

Macros are how you supercharge your Confluence pages. 

You can use macros to:

  • change the format and layout of your page
  • display media like video, audio, and social media content
  • collate and organize Confluence pages, blogs, and files
  • perform actions from a page, such as creating a page from a template. 

Take your Confluence space to the next level using macros. 

Basics information and some highlighted Macros are explained below.
Head to the documentation for specific macros information of Atlassian to view full details of the parameters available in each macro.

Macro basics

Add a macro to your page

To add a macro to your page:

  1. From the editor toolbar, select Insert Image Added, then Other Macros.

  2. Select a macro from the list.
  3. Enter any required parameters.
  4. Choose Insert.

In the editor you'll see a placeholder that represents the macro. Once you publish your page, you'll see the macro in its full glory. 

Edit a macro

Macro parameters are used to change the behavior of a macro.

To change the macro parameters:

  1. In the editor, click the macro placeholder and select Edit.
    Image Added
  2. Update the parameters as required then select Insert.


Macro's highlighted

Jira Issues Macro

Issue linking also allows you to:

  • create an association between a Jira issue and a Confluence page
  • link a Jira issue to any other web page

When you link Jira issues together, you create a bi-directional connection between them

  1. From the editor toolbar, select Insert Image Added, then Other Macros.

  2. Choose Jira Issue/Filter from the category.
    Image Added
  3. Enter a filter or search for a Jira issue.
  4. Choose Insert

For more information read the following Atlassian page: Jira Issues Macro

Macro basics

Add a macro to your page

To add a macro to your page:

  1. From the editor toolbar, select Insert Image Removed, then Other Macros.

  2. Select a macro from the list.
  3. Enter any required parameters.
  4. Choose Insert.

In the editor you'll see a placeholder that represents the macro. Once you publish your page, you'll see the macro in its full glory. 

Edit a macro

Macro parameters are used to change the behavior of a macro.

To change the macro parameters:

  1. In the editor, click the macro placeholder and select Edit.
    Image Removed
  2. Update the parameters as required then select Insert.

Head to the documentation for specific macros of Atlassian to view full details of the parameters available in each macro.
Some Macros have been highlighted below:

...

Table of Contents and Content Zone Macro

The Table of Contents macro scans the headings on the current Confluence page to create a table of contents based on those headings or selected zone.
This helps readers find their way around lengthy pages, by summarizing the content structure and providing links to headings. 
Headings can be found at left side in the upper bar.
Image Added

Step-by-step guide Add Table of Contents:

...

More detailed information regarding Table of contents content macro's can be found on the following links:

...

 Main navigation bar
The main navigation bar is the menu at the top of your screen that stays with you wherever you go in Confluence.

Image RemovedImage Added

The options within your navigation bars may look different than the screenshot. Navigation options can be customized based on your space settings, permissions, and team preferences.

...

You can 'watch' pages to get email notifications when changes or comments are added to the page.


Share pages with teammates

...