Confluence使用教程

---

外鏈：爲什麼使用confluence？

版本：Atlassian Confluence 6.3.1

---

一、Confluence簡介

Confluence是一個企業級的Wiki軟件，可用於在企業、部門、團隊內部進行信息共享和協同編輯。

---

1.1、能做什麼？

團隊將日常的工作任務進度管理、技術知識分享、開發文檔、操作手冊、文檔附件都放置入Confluence中進行統一管理，富文本編輯器使文檔內容支持更加豐富，（一般confluence配套使用jira，jira專注於項目bug管理，更多請【百度jira】）

1.2、基礎概念

Confluence的使用並不複雜，只需掌握如下幾個基礎概念。空間（Space）空間是Confluence系統中的一個區域，用於存儲wiki頁面，並可實現對空間中的所有文檔進行統一的權限管理。
通常，我們可以針對每個項目單獨創建一個空間，然後將與該項目相關的文檔信息放置到該空間中，並只對項目成員開設訪問/編輯權限。
除了項目空間，每個成員都有一個個人空間。平時成員可以將工作總結或筆記等文檔放置到自己的空間中；對於對團隊有幫助的文檔，就可以將文檔移動至團隊項目空間中。

1.2.1、Dashboard

Dashboard是Confluence系統的主頁，在Dashboard界面中包含了Confluence站點中的所有空間列表，以及最近更新內容的列表。

1.2.2、頁面（Page）

在Confluence系統中，頁面是存儲和共享信息的主要方式。
頁面可以互相鏈接、連接、組織和訪問，並以樹狀結構進行組織，放置於空間之中。頁面遵循所見即所得的編輯方式，操作上簡單易用。更強大的地方在於，頁面支持大量的內容展現形式，除了富文本文檔外，還包括圖表、視頻、附件（可預覽）、流程圖、公式等等；如果還不夠，還可以通過海量的第三方插件進行擴展。
在頁面中可以通過@其它成員，通知相關成員查看文檔。文檔保存成功後，被@的成員就會收到郵件，並可根據郵件中的鏈接訪問到該文檔，然後進行評論或者協同編輯。

1.2.3、模板（template）

創建頁面時除了採用空白文檔，也可以選擇模板。模板是在空白文檔的基礎上，根據特定需求添加了一些文檔要素，可輔助用戶更好更快地創建文檔。
Confluence內置了大量的模板，可輔助用於項目工作的各個環節，包括產品需求、會議記錄、決策記錄、指導手冊（How-to）、回顧記錄、工作計劃、任務報告等等。並且由於Confluence和JIRA是同一家公司的產品，在Confluence中可以和JIRA進行無縫銜接，實現對產品質量實現更好的展現。
如果對Confluence自帶的模板不滿意，還可以對模板進行調整，或者根據自己的需求創建其它類型的模板。

1.2.4、權限（Permission）

在安全性方面，Confluence具有完善和精細的權限控制，可以很好地控制用戶在Wiki中創建、編輯內容和添加註釋。
權限控制分3個維度，分別是團隊（Group），個人（Individual Users），匿名用戶（Anonymous）。
使用團隊級的權限控制時，需要在Confluence服務器中對公司員工進行分組，好處在於配置比較方便，只需要對整個團隊進行統一的權限配置。
但在實際項目中，經常會存在同一個項目包含多個跨團隊成員的情況，這個時候就不適合採用團隊權限配置方式，只能採用逐個添加成員的方式，並對各個成員分別配置權限。
另外一種情況，就是對於未登錄的用戶，以及項目成員以外的用戶，可以開設部分權限，例如只讀（View）。

---

二、常見操作

熟悉了Confluence的基礎概念，基本上就可以摸索着對Confluence進行上手了。不過，爲了減少摸索時間，在這裏我再將Confluence中的常用操作進行說明。

2.1、文檔查看與操作

用戶賬戶登錄首頁->選擇要查看的【空間】->【****開發項目管理】->【項目管理】->選擇對應的項目→查看您想看的文檔

2.2、添加文檔

在Confluence中文件以樹狀結構進行組織。
推薦的創建方式是，先進入父目錄的頁面，然後再點擊【Create】進行創建。在創建文檔頁面中，可以看到新建文檔的“父級”，表示新文檔創建後將位於“父級”文件的下一個層級中。

在新建文檔時，需要選擇文檔模板。這個就根據文檔的實際類型或用途進行選擇即可，如果覺得都不合適，就選擇“Blank page”。

2.3、編寫文檔

在編寫文檔時，頁面遵循所見即所得的編輯方式，基本上跟在MS Word中的操作類似。
Confluence也集成了許多編輯工具，可以很方便地插入圖表、鏈接、附件、代辦列表等等。如果還不滿足需求，可以點擊【插入】->【其他宏】，查找更多的擴展插件。

• 2.3.1、 選擇【格式化】->【代碼塊】->【語法高亮】->自由選擇風格【選擇sql】->自由選擇主題【選擇】->【emacs】,接着確認，即可插入sql
  

• 2.3.2、 插入表格，插入開發狀態顏色，點擊【+】->選擇【狀態】
  
• 2.3.3、 插入圖片和附件 選擇【插入文件和圖片】
  例如，Confluence默認是不支持Markdown編輯模式的，如果想採用Markdown來編寫文檔，就可以通過上述方式到插件市場尋找Markdown的插件。
  不過根據實踐發現，當前Confluence的Markdown插件支持的還不夠好，使用體驗上不盡如人意。比較推薦的做法，還是在單獨的Markdown編輯器上採用markdown語法進行編輯，編輯完成後進行預覽，然後將渲染後的文檔內容複製粘貼到Confluence中。
  
• 2.3.4、移動文檔
  很多時候我們需要調整目錄結構，這就涉及到需要將文檔移動到別的目錄層級下。
  操作方式如下：先進入到待移動的文檔頁面中，點擊頁面右上角的【…】->【移動】；
  然後選擇移動到新的目錄即可。
  

2.4、創建目錄

與創建文檔方式一致，直接創建標題保存即可

2.5、模板方式創建文檔

選擇【以層級方式查看】->[模板]->【編輯】

三、發表評論

四、上傳文檔附件

樣例

五、導出

六、文檔權限管理

選擇【…】->【限制】

七、創建空間

新建一個項目時，首先要做的就是創建一個空間，並進行初始化配置。
創建空間的方式很簡單，可以從頂部菜單進行創建：【空間】->【創建】；也可以從Dashboard頁面的Spaces頁面中進行創建。

1. 進入創建空間頁面後，需要選擇空間類型。這個需要根據空間的用途進行選擇，對於團隊協作的空間，推薦選擇“Team Space”，如果實在不知道選擇什麼類型，選擇“Blank Space”也是可以的。
2. 然後是填寫空間的基本信息。所有類型的空間都有兩個必填字段，空間名和空間標識符。空間標識符可以理解爲空間的ID，不同空間的空間標識符不能重複，但空間名是可以重複的。
3. 另外，對於“Team Space”類型的空間，多了一個“Team members”字段，用於添加空間的成員。成員的名稱是其公司郵箱的前綴。
   需要說明的是，空間創建完成後，Space key字段是不能修改的，其它字段以及團隊成員都可以進行修改。
   
   

八、配置空間權限

創建空間後，根據項目需要，可以給空間設置權限。只有空間的管理員才能對空間權限進行配置。
操作方式如下：首先進入空間的頁面，在空間左下角中，【空間管理】->【權限】，進入權限管理頁面。

Confluence的權限控制比較完善，可以根據團隊規範進行較爲精細粒度的設置。