01 前言
之前,在公司内部搭建了一套confluence,安装过程见我的另外一篇文章:https://www.jianshu.com/p/2f2142ce01b7
最近,公司用的人慢慢多了起来,很多人都在问一些基本使用问题,在此总结一下,也算是个人加深一下印象
02 概念
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)
掌握以下信息,就可以开始使用了
03 基本操作简介
创建空间(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字段是不能修改的,其它字段以及团队成员都可以进行修改。
配置空间权限
创建空间后,根据项目需要,可以给空间设置权限。只有空间的管理员才能对空间权限进行配置。
操作方式如下:首先进入空间的页面,在空间左下角中,【空间管理/Space tools】->【权限/Permissions】,进入权限管理页面。Confluence的权限控制比较完善,可以根据团队规范进行较为精细粒度的设置
新建页面或“文档”
在Confluence中文件以树状结构进行组织。
推荐的创建方式是,先进入父目录的页面,然后再点击【Create】进行创建。在创建文档页面中,可以看到新建文档的“父页面/Parent”,表示新文档创建后将位于“父页面”文件的下一个层级中。
这里说一下,confluence上有大量的模板,比较常用的是以下三种:
【空白页/Blank page】用以创建属于自己所需的文档,随心所欲的自定义;
【博文/Blog pot】可以创建从网络收藏的网页;
【文件列表/File list】创建一个文件网盘,可以上传各类文档、软件等。
这里选择空白页面创建。
在编辑时,页面遵循所见即所得的编辑方式,基本上跟在MS Word中的操作类似。
Confluence也集成了许多编辑工具,可以很方便地插入图表、链接、附件、代办列表等等。如果还不满足需求,可以点击【Insert】->【Other macros】,查找更多的扩展插件。
加号处的下拉选项,提供了增强性的编辑功能。包括支持Markdown语法、支持Todo任务列表、支持多种宏等等。
【目录/Table of Contents】插入目录插入目录宏,可根据你的标题格式自动生成目录。
移动文档
很多时候我们需要调整目录结构,这就涉及到需要将文档移动到别的目录层级下。
操作方式如下:先进入到待移动的文档页面中,点击页面右上角的【…】->【移动】,根据提示选择新的父页面
空间管理
空间管理包括对空间的配置、删除、权限等等一系列的管理。在页面左下方的【空间管理/Space tools】即可进入空间管理操作。
04 总结
Confluence的功能非常之多,这里仅能介绍了最基本的功能。无论对于个人还是创业公司,Confluence是真正意义上的Wiki知识管理工具。现在有很多的用户使用Evernote、为知、有道作“知识管理”,恐怕大多数的情况,这类工具仅仅是扮演着收集与采集的工具,比如我现在用的Reede应用,看到好的文章就同步至Evernote,但是,我基本不会使用evernote做笔记或者撰写材料,这是因为Evernote的形态并不符合Wiki的理念。
又由于知识以各种各样的形态呈现,比如文章、图片、视频、文档、软件等等,传统的笔记类工具远远还不足以应付。
Confluence与Evernote的区别就像图书馆与迅雷。Confluence(图书馆)存放的知识在需要的时候可以应用,且以良好的结构组织;而Evernote(迅雷)只是为了收集(收藏)内容的目的而存在,即便有一天你知道evernote有你需要的知识,但你多数用搜索引擎直接搜索。
是时候试试confluence了。