页面树结构

本指南的对象是谁?

因为它作为维基软件,集成了易于使用和灵活的、专业的网络发布功能,因此很容易入门,但是能为您的团队所有成员提供高质量的输出。

1.添加空间

在Atlassian,我们为每个产品创建一个单独的空间作为那个产品的知识库。在这里可以看到一个Confluence知识库的生动示例。

提示:我们建议将文档主题用于您的知识库。

文档: Setting up a New Global Space (设置一个新的全局空间)

观看下面的视频,进一步了解Confluence中的内容是如何组织的。

2.添加用户

当您已经为您的团队或者部门创建了您的第一个空间以后,您会想要邀请他们来同您一起使用Confluence。

文档: Adding Users(添加用户)

3.设置空间权限

现在您已经创建了一个新的空间,就设置它的权限来决定谁可以创建和查看内容。例如,您可能想要限制您的团队成员编辑页面—知识库文章,但是允许所有的用户在页面上添加评论。

进一步了解Confluence Space Permissions(Confluence空间权限)

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)将它们嵌入到您的空间主页上。

文档: 

7.2突出显示您的公告

  1. 到您的空间主页。
  2. 点击 'Edit'(编辑)。
  3. 插入一个'Heading 2'(页眉2),例如“重要的技术公告”。
  4. 插入黑体文本,上面写着 'Copy the RSS feed into your RSS reader:'(.将RSS摘要复制到您的RSS阅读器中)。
  5. 在编辑器工具条中点击 'Insert'(插入)菜单下的'Macro Browser'(宏浏览器)。
  6. 在宏浏览器中选择'Panel' (面板)宏并根据提示设置宏。
  7. 点击 'Insert'(插入)。
7.3插入 'Blog Posts' (博文)宏
  1. 请将您的光标移动到Panel(面板)宏占位符中,然后启动宏浏览器。
  2. 在宏浏览器中选择'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(面板)宏中。

7.4添加RSS反馈

通过链接一幅图片,将您的RSS提要插入到您的面板中。

  1. 通过编辑器中在对其进行行内拖放(dragging and dropping),将一个RSS图标附加到该页面上。
  2. 选择这幅图片,然后点击编辑器工具条中的'Right Align'(右对齐)图标。 
  3. 再次选择这幅图片 - 'Image Properties Panel'(图片属性面板)将会出现,您应在这里为这幅图片加上边框。 
  4. 选择这幅图片然后点击编辑器工具条中的 'Link'(链接)按钮。
  5. 选择'Web Link' (网络链接)标签,然后插入您创建的RSS提要URL。
  6. 点击'Insert'(插入)来将您的RSS提要链接到RSS图标图片。
  7. 点击 'Save'(保存)。

恭喜!您已经成功地创建了一个主动的知识库。

文档Using Drag-and-Drop(使用拖放)

评估您的知识库对客户服务的有效性是非常重要的。Google Analytics使您深入了解您的网站流量和客户如何访问您的知识库中的资源。

进一步了解: Tracking Confluence Usage with Google Analytics(通过Google Analytics跟踪Confluence的使用情况)

8.跟踪知识库的有效性

插入Google Analytics代码

  1. 如果您还没有一个Google账户,那么就创建一个Google账户,然后使用您的Confluence实例的URL创建一个Google Analytics账户。
  2. 将Google Analytics代码复制到您的剪贴板中。
  3. 作为一个系统管理员或Confluence管理员登录到Confluence中。
  4. 选择'Browse'(浏览)菜单下的'Confluence Admin'(Confluence管理),到Confluence 'Administration Console' (管理控制台)。
  5. 在页眉'Look and Feel'(观感)下方的左侧导航面板中选择'Custom HTML'(定制HTML)。
  6. 点击 'Edit'(编辑)。
  7. 将您已经保存的Analytics代码通过您的剪贴板粘贴到标签为'At end of the BODY'(主体末尾)的表中。
  8. 点击 '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

  • 无标签