Team - 协同工具Confluence

Confluence

Confluence 是一个团队工作区，可有效融合知识与协作。
动态页面为您的团队提供一个场所，可用来创建、收集和协同处理任何项目或创意。
空间有助于您的团队构造、整理和共享工作，让每一位团队成员能够洞悉系统知识，并且访问实现最佳工作成果所需的信息。

官方信息

Confluence 指南 https://www.atlassian.com/zh/software/confluence/guides
Confluence 简要概述 https://www.atlassian.com/zh/software/confluence/guides/get-started/confluence-overview
Confluence 空间设置 https://www.atlassian.com/zh/software/confluence/guides/get-started/set-up

使用注意

转换思维

Confluence页面不同于Word或PDF文档，应该将内容拆分到不同的页面，并提供自然的页面跳转链接，将内容串联起来。

从读者的角度考虑如何编写一个Confluence页面

可用的素材
内容拆分---》目录结构---》页面布局
内容链接

熟悉编辑器的使用

页面布局
使用表格
添加链接
引入多媒体

善于利用内置宏（Macro）的便利功能

# Confluence中常用的宏（Macro）

状态宏（Status Macro）：让内容可视化，醒目、高亮。通常结合表格使用，放在某个单元格中
展开宏（Expand Macro）：使页面信息简洁。默认折叠信息，需要用户点击再显示详细内容
代码块宏（Code Block Macro）：用代码块宏展示代码，可以展示代码、命令，甚至日志内容，还可以在系统管理界面中添加自定义的代码类型（高亮类型）
面板宏（Panel Macro）、列宏（Column Macro）、段宏（Section Macro）：页面布局三件套，设置灵活的页面布局，突出视觉重点
目录宏（Table of Contents）：快速跳转到感兴趣的内容，使内容更整洁，内容较多时使用
Jira图表宏（Jira Chart Macro）和 Jira Issues宏（Jira Issues Macro）：Jira和Confluence结合使用的必备技能，使用时需要整体考虑呈现效果

页面属性宏（Page Properties Macro）和 页面属性报告宏（Page Properties Report Macro）    
- 制作同类页面的索引页，汇总每个页面的属性信息    
- 每类页面都有特定的属性，例如，需求类页面有负责人、实现状态等属性。
- 将同类页面的属性信息汇总到一个页面上，能帮助阅读者，可以快速找到想要的内容，或者对比不同页面的属性信息

团队日历宏（Team Calendar Macro）    
- 在日历上列出重要事件，还能集成Jira上的事件    
- 项目组或开发团队使用Confluence时，必须有按日期总览事件的视角
- 可以添加Jira中的事件，也可以添加自定义的事件

信息宏、提示宏、注意宏、警告宏（Info, Tip, Note, and Warning Macros）    
- 让信息类别更直观    
- 在大量信息中划出重点，以便读者理解或引起重视

搜索宏（Livesearch Macro）  
- 为空间设置一个搜索引擎
- 为某类标签的内容设置一个搜索引擎

图表宏（Chart Macro）    
- 图表胜过千言万语，图表不只是展示统计结果，更是为了帮助阅读者发现问题或解决问题
- 根据阅读者的需求，精心设计整个页面，包括如何布局、展示哪些内容、以什么形式呈现等