Confluence中最常用的宏(Macro)
Confluence中最常用的宏 Macro状态宏Jira宏目录宏页面信息宏用户信息宏团队日历宏页面属性宏页面属性报告宏博客宏标签内容宏标签宏摘要宏包含摘要宏信息宏面板宏格式宏个人资料图片宏锚点宏
·
要想制作一个有用的Confluence页面,需要几个前提:
- 准备有用的内容,有吸引力的内容。从读者的角度考虑,页面中应该有哪些内容,如何布局等等。
- 转换思维。Confluence页面不同于Word或PDF文档,不能像离线文档那样放入几十页内容,而应该将内容拆分到不同的页面,并为不同类型的读者提供自然的页面跳转链接,将内容串联起来。
- 掌握Confluence编辑器技能。包括设计页面布局、使用表格、添加链接、引入多媒体内容等,最重要的技能,也是本文的重点,掌握几十种内置宏(Macro)的用法。
下表列出了Confluence中最常用的一些宏,例如状态宏、标签宏、目录宏、摘要宏、Jira宏等等。也可以通过视频课程学习它们的使用场景和用法(
Confluence内容管理培训和
Confluence文档和知识库管理培训)。
宏(Macro) | 常用理由 | 要点 | 参考文档 | 推荐指数 |
状态宏(Status Macro) | 让内容可视化,醒目、高亮。瞬间提升内容档次 |
| 状态宏文档 | ✭✭✭✭✭ |
展开宏(Expand Macro) | 使页面信息简洁 |
| 展开宏文档 | ✭✭✭✭✭ |
代码块宏(Code Block Macro) | 用代码块宏展示代码才够专业 |
| 代码块宏文档 | ✭✭✭✭✭ |
面板宏(Panel Macro) 列宏(Column Macro) 段宏(Section Macro) | 页面布局三件套 |
| ✭✭✭✭✭ | |
目录宏(Table of Contents) | 让读者快速跳转到感兴趣的内容 |
| 目录宏文档 | ✭✭✭✭✩ |
摘要宏(Excerpt Macro) 和 包含摘要宏(Excerpt Include Macro) | 在一个页面中引用另一个页面或另一些页面的摘要。 |
| 摘要宏文档和包含摘要宏文档 | ✭✭✭✭✩ |
Jira图表宏(Jira Chart Macro)和 Jira Issues宏(Jira Issues Macro) | Jira和Confluence结合使用的必备技能 |
| 和 | ✭✭✭✭✩ |
页面属性宏(Page Properties Macro)和 页面属性报告宏(Page Properties Report Macro) | 制作同类页面的索引页,汇总每个页面的属性信息 |
| ✭✭✭✭✩ | |
锚点宏(Anchor Macro) | 让读者快捷跳转到页面的指定位置 |
| 锚点宏文档 | ✭✭✭✩✩ |
团队日历宏(Team Calendar Macro) | 在日历上列出重要事件,还能集成Jira上的事件 |
| 团队日历宏文档 | ✭✭✭✩✩ |
信息宏、提示宏、注意宏、警告宏(Info, Tip, Note, and Warning Macros) | 让信息类别更直观 |
| 信息宏、提示宏、注意宏、警告宏文档 | ✭✭✭✩✩ |
搜索宏(Livesearch Macro) | Confluence不是文档服务器,它是一个网站。用好搜索宏才能更理解这句话 |
| 搜索宏文档 | ✭✭✭✩✩ |
图表宏(Chart Macro) | 图表胜过千言万语 |
| 图表宏文档 | ✭✭✭✩✩ |
画图宏 | 文档里需要配上各种图形说明,包括:流程图、时序图、设计图、拓扑图、ER图、组织图、UML图、数据图表、whiteboard...... |
| 直接绘图类: 文本生成类: | ✭✭✭✭✩ |
(未完待续......) ...... |
(本文将持续更新,欢迎点赞、评论、收藏、转发、打赏,谢谢支持!)
友情链接:
DEVPOD社区,旨在打造高质量的DevOps工具知识库。包括商业工具:Atlassian Jira,Confluence,Jfrog,极狐, CodeBeamer等。开源工具栈如:Gitlab,ArgoCD, Jenkins等。 致力于帮助企业建实现云原生时代DevOps转型。
更多推荐
已为社区贡献14条内容
所有评论(0)