ITaP Confluence Guide. Instructions for Getting Started with Confluence a Purdue

Transcription

1 ITaP Confluence Guide Instructions for Getting Started with Confluence a Purdue

2 This instruction set was developed by ITaP for instructor and student use. For comments, suggestions, correction, etc. please contact us at:

3 Contents What is Confluence?... 4 Best Practices... 4 User Resources... 5 Access to a Confluence Wiki Space... 5 Login:... 5 Dashboard... 6 Editing a Confluence Wiki Space... 9 Edit Link:... 9 Add Dropdown Menu: Tools Dropdown Menu: Online Tutorials Additional Resources / 1 9 / : 5 1 P M 3 P a g e

4 What is Confluence? This guide is for faculty and students to get started using Confluence. Confluence is a wiki tool, similar to the format of Wikipedia, which allows users to create web spaces for communication and collaboration. Within a wiki space a user can upload files for others to see and create discussions through commenting and blogging. Confluence is an organizational system that makes it easy to keep content in one place allowing it to be viewable from anywhere in the world. Confluence is an enterprise level tool used by many businesses, but also demonstrates a strong educational value. The tool allows for many types of instructional collaboration including site linking, attaching offline/online work, commenting, and blogging. Confluence pages can be directly exported to Microsoft Office and the tool s functionality is expandable through the addition of plug-ins. Additionally, Confluence allows for page versioning and its content is fully searchable. Best Practices Page Restrictions should be used sparingly in Confluence and applied appropriately. Only the users or groups selected for View and Edit will be able to perform those functions in relation to the assigned page (note both options have restriction applied individually). Also a Home page should never be restricted, as all child pages will be restricted as well. It is highly recommended that only child pages with limited or no children of their own ever be restricted. See graphic on next page. 4 P a g e 3 / 1 9 / : 5 1 P M

5 User Resources This section of the guide is for use by all users of Confluence and will provide useful information for accessing and edited site content. Access to a Confluence Wiki Space Login: Access to a Confluence wiki space is granted to all Purdue faculty, staff, and students via CAS authentication. To access the Purdue Confluence dashboard online, go to: You can use your Purdue Career Account and password to login to the tool in the upper right. After a user logs in, a dashboard will allow them to access all wiki spaces associated with their account. This may include course, research, or general access spaces. For user issues with logging in, go to: 3 / 1 9 / : 5 1 P M 5 P a g e

6 Dashboard The main dashboard has four sections: (A) menu, (B) tools, (C) spaces, and (D) community tracking. A. Unless the menu has been modified by a Space Administrator (see Instructor Resources), the Dashboard breadcrumb is located to the left-hand side of the menu bar. Users can always return to their dashboard by clicking on this link. Besides the breadcrumbs, the menu bar contains the top level navigation for Confluence, which includes the Browse and User dropdown menus as well as the Search dialog box. The Browse dropdown menu will let a user obtain access to a more global view of a specific Confluence space as well as any directories, shortcuts, or advance permissions that the user may have. The menu choices on this dropdown may change from space to space within Confluence. 6 P a g e 3 / 1 9 / : 5 1 P M

7 The User dropdown menu (represented by the user s name) contains all of the user specific features. Some of these include user profile, status updates, pages that a user is watching, personal labels, and view history. Additionally, this dropdown is where all users log out of Confluence. The Search dialog box in the menu bar is where a user can search for content from all spaces that they have access to in Confluence. B. The tools section of a Confluence page is near the upper right of the page and will have different tools depending on what level of permissions a user has. On the dashboard, the only two tools available to a user are Add Page and Add Blog Post. Selecting either of these tools will prompt a user for what space (only spaces that a user has access to will be selectable) the want to add a page or blog post. Inside an individual wiki space, tool choices will be different and may look like the following image; where a user can view attached images, view page history, watch a page, and restrict a page, amongst other options. 3 / 1 9 / : 5 1 P M 7 P a g e

8 C. On the main dashboard, the Spaces section has two tabs: Favorite and Global. These two tabbed areas contain links to every wiki space accessible by the user. The Global tab displays all wiki space that the user can view, where as the Favorite tab will limit the display of wiki space to only those that have a gold star selected next to them. A user can select/deselect a favorite space by clicking on the star icon next to its name at the right. D. The community tracking section of the dashboard is where a user can see activity in all spaces that are accessible to them. The list displays the name of the user who made a change or added a file and also provides a link to go directly to the edited page or document. The + and - icons on the right-hand side of this section allow for the user to display more or fewer items in the list. A video that covers logging in and the dashboard is available online (note you will need Shockwave player installed for your browser: 8 P a g e 3 / 1 9 / : 5 1 P M

9 Editing a Confluence Wiki Space To edit a Confluence space the user needs to have permissions to do so (see Instructor Resources). Pages can only be edited if the space administrator allows this option; the dropdown menus or links that allow for editing are Edit, Add, and Tools pictured on the sample page below. Edit Link: By selecting the Edit link in the upper right of the screen, the user opens the page editing window. This is where all content for a given page can be modified. In this window the user can (if allowed) (A) edit the title, (B) edit the page text, (C) choose whether it is a minor change, (D) change the page hierarchy, (E) add restrictions, (F) add/remove labels, and (G) Save or Cancel all edits made. Additionally there is a link to the wiki mark-up full notation guide, which the user can access here: 3 / 1 9 / : 5 1 P M 9 P a g e

10 A. To edit the title for the page the user just needs type in a new name in the text field. The lager heading font will automatically be applied to the page when it is saved. B. The large text box is where a user can edit the page content. There are three view tabs to choose from for editing the content: Rich Text, Wiki Markup and Preview. The Rich Text tab allows for the editing of page content in much the same manner as Microsoft Word. It has a WYSIWYG tool bar with all the options for adding formatted text, images, links, and document attachments to a page. The Wiki Markup tab allows for the user to implement markup coding toedit the page content. The Full notation guide can be found here: The Preview tab give the use a sneak-peek of what their content edits will look like to the viewers of the page before the edits are saved. C. If you want to make only a minor change,, select the Minor Change box. By selecting this box, no notifications will be sent to any people watching the page and update will not be recorded on the dashboard. However, the update will still be tracked in the History and can always be reverted. D. By clicking on the Edit link next to the Location section of the page editing window, a user can change the page hierarchy (if allowed) by selecting a new parent page within the space or even selecting a new space altogether. (Note the user will need to have permissions to access a space in order to transfer a page to it.) E. The Restrictions section of the page editing window is where a user can limit (if allowed) those who can View and Edit a page at a more granular level than using Permissions (covered later under Instructor Resources). Only the users selected for View and Edit will be able to perform those functions in relation to the assigned page (Note: caution is advised when using this feature since it can severely limit access to a page - see Best Practices for recommended usage of this feature). F. Adding Labels to a wiki space allow for the Search feature in Confluence to more closely relate your space content with certain topics. 10 P a g e 3 / 1 9 / : 5 1 P M

11 G. The Save or Cancel buttons allow the user to save or cancel all edits made to the page in the current session. A video that covers editing a Confluence space is available online (note you will need Shockwave player installed for your browser: Add Dropdown Menu: The Add dropdown menu allows the user to (A) add pages, (B) add comments, (C) add a blog post, and (D) add an attachment to their wiki space. Also this menu is where a user can add a bookmark for a given page to their Confluence bookmarks list. A. Adding a Page creates a new child page for the currently selected page. By selecting this option a new page is created and the page editing window automatically opens. B. By selecting the Comment option in the dropdown menu, a new comment text box opens at the bottom of the current page. This box allows for editing via Rich Text or Wiki Markup, similar to the page editing window. The user can also select the check box for Watch this page, which will allow them to receive update notifications if they choose. After the comment has been written, the user just needs to click to the Post button to add the comment to the bottom of the page. 3 / 1 9 / : 5 1 P M 11 P a g e

12 C. Adding a Blog Post creates a new blog page and the page editing window automatically opens. Again the user can edit via Rich Text or Wiki Markup and can add labels to their post. After the blog post is saved, the user will be taken to the blog page that has a listing of all blogs associated with the wiki space. The blog has its own Search feature and date tracking system by month. On subsequent visits, users can accesses the blog on a space by the Browse dropdown menu in the upper right of the page. D. To add a file attachment to the current page, a. selects Attachment from the Add dropdown menu. A window will open b. browse their desktop for a file or drag-and drop a file onto the page (see graphic on next page.). c. click the Attach button to upload the file to the page. The file name will then appear in the Attached Files section of the window d. add any additional files in the same manner (note: links to attached files will not appear in the page content until they are added via the page editing window see Edit Link section B above ). e. select the View link in the upper right to return. 12 P a g e 3 / 1 9 / : 5 1 P M

13 Word Documents, Adobe PDFs, and PowerPoint files can be embedded into a page directly. View how to do this online at: under Embedding Files. Tools Dropdown Menu: Depending on the level of access a user has for an individual wiki space, tool choices will be different and may look like the following image; where a user can view attached images, view page history, watch a page, favorites a page, and restrict a page, amongst other options. Online Tutorials ITaP has several online tutorials to help users get started using Confluence as well as other tools supported at the University. These can be found online at: 3 / 1 9 / : 5 1 P M 13 P a g e

14 Additional Resources ITaP Confluence Showcase: Confluence Video Tutorials: Confluence New Possibilities for Teaching and Learning: Confluence Notation Guide: Confluence 3.4.x Users Guide: Atlassian Q&A Community: Request ITaP assistance with Confluence: This instruction set was developed by ITaP for instructor and student use. For comments, suggestions, correction, etc. please contact us at: 14 P a g e 3 / 1 9 / : 5 1 P M