本指南的对象是谁?
因为它作为维基软件,集成了易于使用和灵活的、专业的网络发布功能,因此很容易入门,但是能为您的团队所有成员提供高质量的输出。
目录 |
---|
视频:Confluence Product Demonstration video(双击视频,可以全屏显示)
1.添加空间
在Atlassian,我们为每个产品创建一个单独的空间作为那个产品的知识库。在这里可以看到一个Confluence知识库的生动示例。
提示:我们建议将文档主题用于您的知识库。
文档: Setting up a New Global Space (设置一个新的全局空间)
观看下面的视频,进一步了解Confluence中的内容是如何组织的。
视频:Atlassian Confluence Product Demonstration Video 4.0 (双击视频,可以全屏显示)
2.添加用户
当您已经为您的团队或者部门创建了您的第一个空间以后,您会想要邀请他们来同您一起使用Confluence。
文档: Adding Users(添加用户)
3.设置空间权限
现在您已经创建了一个新的空间,就设置它的权限来决定谁可以创建和查看内容。例如,您可能想要限制您的团队成员编辑页面—知识库文章,但是允许所有的用户在页面上添加评论。
进一步了解: Confluence Space Permissions(Confluence空间权限)视频:Confluence Space Permissions Quick Hit Video (双击视频,可以全屏显示)
4.定制文档主题
您可以配置文档主题,添加您自己的定制页眉和页脚,并定制左侧导航条中的内容。
文档: Configuring the Documentation Theme(配置文档主题)
5.创建Include page宏
您可以使用Include page (包含页面)宏和Excerpt Include(摘录包含宏)包含来自于位于另一个页面中的一个页面的内容,从而防止内容重复。这对重用样板文件内容特别有用。
文档: 创建一个包含库
进一步了解: 在维基中编写技术文档——内容重用与结构
6.定制空间主页
您可以修改您的主页的标题和内容,使之更贴近您的知识库。点击左边的屏幕截图,了解Atlassian是如何定制Confluence Knowledge Base(Confluence知识库)主页的。
进一步了解: 5 Essential Confluence Features for Technical Writers(对技术文档作者必不可少的5项Confluence功能)
7.让您的知识库更主动
Atlassian的技术支持团队已经通过提供RSS提要创建了一个主动的知识库。这样其客户就可以订阅并收到关于其产品的重要技术警报。
遵循下列步骤,您就可以创建一个与Atlassian的Confluence Knowledge Base(Confluence知识库)类似的主页,并将您的知识库由被动变为主动。
7.1 创建您的RSS提要
Atlassian为每项技术公告都会从知识库空间发布一条新的博客帖。您可以使用Confluence RSS提要构建器(Confluence RSS Feed Builder)为这些公告创建RSS提要,然后使用博客帖宏(Blog Posts Macro)将它们嵌入到您的空间主页上。
文档:
- Working with the Blog Posts(使用博客帖工作)
- Blog Posts Macro(博客帖宏)
- Using the RSS Feed Builder(使用RSS提要构建器)
7.2突出显示您的公告
- 到您的空间主页。
- 点击 'Edit'(编辑)。
- 插入一个'Heading 2'(页眉2),例如“重要的技术公告”。
- 插入黑体文本,上面写着 'Copy the RSS feed into your RSS reader:'(.将RSS摘要复制到您的RSS阅读器中)。
- 在编辑器工具条中点击 'Insert'(插入)菜单下的'Macro Browser'(宏浏览器)。
- 在宏浏览器中选择'Panel' (面板)宏并根据提示设置宏。
- 点击 'Insert'(插入)。
- 请将您的光标移动到Panel(面板)宏占位符中,然后启动宏浏览器。
- 在宏浏览器中选择'Blog Posts'(博客帖)宏,然后指定下列设置:
- 'Content Type to Display'(显示内容类型): 标题
- 'Restict to These Spaces'(这些空间的限制): 您知识库空间关键字
- 'Maximum Number of News Items'(新闻条目的最大数量): 5
- 'Sort By'(排序方式): 创建
- 'Reverse Sort'(逆向排序): 勾选框
3. 点击'Insert'(插入),将Blog Post(博客帖)宏插入到您的Panel(面板)宏中。
通过链接一幅图片,将您的RSS提要插入到您的面板中。
- 通过编辑器中在对其进行行内拖放(dragging and dropping),将一个RSS图标附加到该页面上。
- 选择这幅图片,然后点击编辑器工具条中的'Right Align'(右对齐)图标。
- 再次选择这幅图片 - 'Image Properties Panel'(图片属性面板)将会出现,您应在这里为这幅图片加上边框。
- 选择这幅图片然后点击编辑器工具条中的 'Link'(链接)按钮。
- 选择'Web Link' (网络链接)标签,然后插入您创建的RSS提要URL。
- 点击'Insert'(插入)来将您的RSS提要链接到RSS图标图片。
- 点击 'Save'(保存)。
恭喜!您已经成功地创建了一个主动的知识库。
文档: Using Drag-and-Drop(使用拖放)
评估您的知识库对客户服务的有效性是非常重要的。Google Analytics使您深入了解您的网站流量和客户如何访问您的知识库中的资源。
进一步了解: Tracking Confluence Usage with Google Analytics(通过Google Analytics跟踪Confluence的使用情况)
8.跟踪知识库的有效性
插入Google Analytics代码
- 如果您还没有一个Google账户,那么就创建一个Google账户,然后使用您的Confluence实例的URL创建一个Google Analytics账户。
- 将Google Analytics代码复制到您的剪贴板中。
- 作为一个系统管理员或Confluence管理员登录到Confluence中。
- 选择'Browse'(浏览)菜单下的'Confluence Admin'(Confluence管理),到Confluence 'Administration Console' (管理控制台)。
- 在页眉'Look and Feel'(观感)下方的左侧导航面板中选择'Custom HTML'(定制HTML)。
- 点击 'Edit'(编辑)。
- 将您已经保存的Analytics代码通过您的剪贴板粘贴到标签为'At end of the BODY'(主体末尾)的表中。
- 点击 'Save'(保存)。
现在您可以监控您在Confluence实例和知识库中创建的每个页面的活动和流量了。
渴望更多信息?
现在您已经学完了本指南,那么了解更多关于构建一个主动的知识库(proactive Knowledge Base)的信息并观看Atlassian峰会上发布的,由Atlassian的知识库创建者所作的演讲《Confluence as a knowledge base: Five tips for an awesome KB(Confluence作为一个知识库:适用于一个优秀知识库的五条小贴士)》。
视频:5 Tips for an Awesome Knowledge Base