【DB宝47】企业知识分享+团队协作神器之Confluence

toc

一、Confluence简介

confluence是一个专业的企业知识管理与协同软件，可以用于构建企业wiki。通过它可以实现团队成员之间的协作和知识共享。

关键词：信息共享、协同编辑

以下几个基本概念需要了解一下：

• 空间（Space） 空间是页面的组合，可以创建不限数量的空间。空间是Confluence系统中的一个区域，用于存储wiki页面，并可实现对空间中的所有文档进行统一的权限管理。 通常，我们可以针对每个项目单独创建一个空间，然后将与该项目相关的文档信息放置到该空间中，并只对项目成员开设访问/编辑权限。 除了项目空间，每个成员都有一个个人空间。平时成员可以将工作总结或笔记等文档放置到自己的空间中；对于对团队有帮助的文档，就可以将文档移动至团队项目空间中。 可以理解为SVN或Git的一个库
• Dashboard Dashboard是Confluence系统的主页，在Dashboard界面中包含了Confluence站点中的所有空间列表，以及最近更新内容的列表。
• 页面（Page） 在Confluence系统中，页面是存储和共享信息的主要方式。页面可以互相链接、连接、组织和访问，并以树状结构进行组织，放置于空间之中。 页面遵循所见即所得的编辑方式，操作上简单易用。更强大的地方在于，页面支持大量的内容展现形式，除了富文本文档外，还包括图表、视频、附件（可预览）、流程图、公式等等；如果还不够，还可以通过海量的第三方插件进行扩展。 在页面中可以通过@其它成员，通知相关成员查看文档。文档保存成功后，被@的成员就会收到邮件，并可根据邮件中的链接访问到该文档，然后进行评论或者协同编辑。
• 模板（template） 创建页面时除了采用空白文档，也可以选择模板。模板是在空白文档的基础上，根据特定需求添加了一些文档要素，可辅助用户更好更快地创建文档。 Confluence内置了大量的模板，可辅助用于项目工作的各个环节，包括产品需求、会议记录、决策记录、指导手册（How-to）、回顾记录、工作计划、任务报告等等。并且由于Confluence和JIRA是同一家公司的产品，在Confluence中可以和JIRA进行无缝衔接，实现对产品质量实现更好的展现。 如果对Confluence自带的模板不满意，还可以对模板进行调整，或者根据自己的需求创建其它类型的模板。
• 权限（Permission） 在安全性方面，Confluence具有完善和精细的权限控制，可以很好地控制用户在Wiki中创建、编辑内容和添加注释。 权限控制分3个维度，分别是团队（Group），个人（Individual Users），匿名用户（Anonymous）。 使用团队级的权限控制时，需要在Confluence服务器中对公司员工进行分组，好处在于配置比较方便，只需要对整个团队进行统一的权限配置。 但在实际项目中，经常会存在同一个项目包含多个跨团队成员的情况，这个时候就不适合采用团队权限配置方式，只能采用逐个添加成员的方式，并对各个成员分别配置权限。 另外一种情况，就是对于未登录的用户，以及项目成员以外的用户，可以开设部分权限，例如只读（View）

二、知识库软件对比

三、快速安装confluence 7.4.6版本

安装过程较为复杂，但是，小麦苗已制作了相关镜像，大家可以直接下载，开箱即用。

-- 创建容器
docker pull registry.cn-hangzhou.aliyuncs.com/lhrbest/lhrconfluence746:1.0
docker run -d --name lhrconfluence -h lhrconfluence \
  -p 221:22 -p 3388:3389 -p 8090:8090 -p 8306:3306 \
  -v /sys/fs/cgroup:/sys/fs/cgroup \
  --privileged=true lhrbest/lhrconfluence746:1.0 \
  /usr/sbin/init
  
  
-- Web页面访问：首次打开有些慢，后续再打开就顺畅了
http://192.168.66.35:8090
用户名和密码：admin/lhr

-- 若是不能访问，则重新启动相关资源
mysqld --user=mysql &
/etc/init.d/confluence restart

首次使用，请更新URL：

修改为自己的服务器IP地址即可。

四、confluence基本操作简介

4.1、创建空间（Space）

新建一个项目时，首先要做的就是创建一个空间，并进行初始化配置。

创建空间的方式很简单，可以从顶部菜单进行创建：【空间/Spaces】->【创建空间/Create Space】；也可以从Dashboard页面的Spaces页面中进行创建。

如下图：

空间类型如下：

弹出的对话框共有4个选项。

如果是个人项目，一般选【空白空间/Blank space】，可创建页面、博客；

如果只需要创建页面，则选择【文档空间/Documentation Space】；

如果要限定团队某个成员访问的空间，则选择【团队空间/Team Space】；

至于【知识库/Knowledge base】与【空白空间/Blank space】差不多。

如果需要和Jira上的项目关联，推荐选择【软件项目空间/software project space】

因此，个人用，选【空白空间/Blank space】

团队用，选【团队空间/Team Space】或【软件项目空间/software project space】。

这里选择【空白空间/Blank space】进行演示：

然后是填写空间的基本信息。所有类型的空间都有两个必填字段，空间名/Space name和空间标识符Space key（空间的ID或key，一旦确定不能修改），不同空间不能重复，但空间名是可以重复的。

个人空间可勾选“只对我可见/Visible only to me"，即仅对个人可见

团队空间会多一个“团队成员Team members”字段，用于添加空间的成员。如下图：

需要说明的是，空间创建完成后，Space key字段是不能修改的，其它字段以及团队成员都可以进行修改。

4.2、配置空间权限

创建空间后，根据项目需要，可以给空间设置权限。只有空间的管理员才能对空间权限进行配置。

操作方式如下：首先进入空间的页面，在空间左下角中，【空间管理/Space tools】->【权限/Permissions】，进入权限管理页面。Confluence的权限控制比较完善，可以根据团队规范进行较为精细粒度的设置

4.3、新建页面或“文档”

在Confluence中文件以树状结构进行组织。

推荐的创建方式是，先进入父目录的页面，然后再点击【Create】进行创建。在创建文档页面中，可以看到新建文档的“父页面/Parent”，表示新文档创建后将位于“父页面”文件的下一个层级中。

这里说一下，confluence上有大量的模板，比较常用的是以下三种：

【空白页/Blank page】用以创建属于自己所需的文档，随心所欲的自定义；

【博文/Blog pot】可以创建从网络收藏的网页；

【文件列表/File list】创建一个文件网盘，可以上传各类文档、软件等。

这里选择空白页面创建。

在编辑时，页面遵循所见即所得的编辑方式，基本上跟在MS Word中的操作类似。

Confluence也集成了许多编辑工具，可以很方便地插入图表、链接、附件、代 办列表等等。如果还不满足需求，可以点击【Insert】->【Other macros】，查找更多的扩展插件。

加号处的下拉选项，提供了增强性的编辑功能。包括支持Markdown语法、支持Todo任务列表、支持多种宏等等。

【目录/Table of Contents】插入目录插入目录宏，可根据你的标题格式自动生成目录。

4.4、移动文档

很多时候我们需要调整目录结构，这就涉及到需要将文档移动到别的目录层级下。

操作方式如下：先进入到待移动的文档页面中，点击页面右上角的【…】->【移动】，根据提示选择新的父页面

4.5、空间管理

空间管理包括对空间的配置、删除、权限等等一系列的管理。在页面左下方的【空间管理/Space tools】即可进入空间管理操作。

4.6、插入Markdown文档+目录

插入目录：

image-20210324103115638

4.7、邀请团队成员开通账号

About Me

● 本文作者：小麦苗，部分内容整理自网络，若有侵权请联系小麦苗删除