- 由 zhongluqiang创建, 最后修改于5月 11, 2022
录一些Confluence编辑器的使用技巧,参考:https://confluence.atlassian.com/display/CONF56/Quick+Reference+Guide+for+the+Confluence+Editor
输入标题
通过Ctrl+数字
的方式来快捷输入标题,比如Ctrl+1
表示标题1,Ctrl+2
表示标题2,Ctrl+0
表示正文。
输入行内代码
行内代码快捷输入方式:空格+{{行内代码}}
,这里注意 {{
前面一定要有空格,否则会被当成普通文本来渲染。行内代码实际就是等宽字体,也可以选中文本后通过编辑器的菜单栏来设置。
输入链接
输入 [
调出链接下拉菜单,根据需要选择即可。
输入待办事项
编辑器菜单栏选择“插入更多内容->任务列表”,这个可以配合任务报告宏实现在首页展示所有待办事项的功能。
输入宏
输入 {
调出宏下拉菜单,后面可以继续跟上宏名称的关键字,以缩小搜索范围。
除了可以用下拉菜单选择宏外,还可以直接用一对花括号直接指定宏,这种写法称为wiki标记,比如{space:all|width=100%}
,这个宏会展开成空间列表。这种写法除了可以在编辑器中使用,还可以在侧边栏中使用,效果如下:
用wiki标记来插入宏的方式在某些情况下可以大幅节约时间,比如插入代码块,如果想要自定义语言和主题等参数,按照正常的先插入宏,再设置参数流程,需要鼠标多次点击和选择,但是如果使用wiki标记来插入代码块,则可以直接输入这些参数,双手不用脱离键盘,相对来说效率要高很多,插入代码块的wiki标记如下:
{code:title=This is my title|theme=FadeToGrey|linenumbers=true|language=java|firstline=0001|collapse=true} This is my code {code}
实际使用时,只需要赋值一两个主要参数即可。
常用宏
格式化
主要包括代码块,信息框/提示框/警告框等,比如下面是一个信息框:
这是一个信息提示框
Confluence内容
用于聚合显示Confluence的内容,比如空间列表,任务报告,最近更新等,常用的有以下几个:
- 空间列表 - 显示所有空间
- 任务报告 - 显示所有未守成的待办事项,可指定空间或页面;
- 最近修改过的页面 - 显示最近修改过的的页面,包括作者和修改时间;
- 最近更新 - 效果和上面类似;
- 热门标签 - 显示标签云或标签列表;
- 标签列表 - 按首字母显示所有标签;
导航
用于快速定位或搜索指定页面,常用如下:
- 目录 - 显示文章区目录;
- 页面树 - 显示当前空间所有页面或某个页面的子页面树;
- livesearch - 显示一个搜索框,用于搜索当前空间页面;
- 锚 - 用于插入锚点,插入的描点可在插入链接时转换成链接来使用;
开发
与开发相关的宏,这里只使用一个HTML宏,可以插入HTML源码,一般用来插入 <iframe>
标签。
分栏
参考:https://confluence.atlassian.com/display/CONF56/Working+with+Page+Layouts+and+Columns+and+Sections
支持给页面分栏,调整页面的纵向布局。Confluence预置了几种常见的分栏模式,在工具栏点击即可,如下:
一种常见的布局是双栏布局,左宽右窄,左边放内容,右边放目录宏。
这些预置的分栏模式可以应付大多数场景,但在某些场景下,可能需要自定义某个列的宽度,这时可以使用Section宏和Column宏。Section宏用于显示一个内容块,支持显示border,内部可放置几个Column,通过对Column设置一个宽度,就可以达到自定义列宽度的效果,示例如下,这里将每个Column宽度设置为25%:
这是第一列
这是第二列
这是第三列
这是第四列
Draw.io
使用记录:
- 平均分布各行,各列元素,比如对齐上面的二叉树。
- 插入链接并修改字体和颜色,使图形对象可以点击跳转,并且不显示为超链接。
- 通过输入空的tooltips来禁用tooltips功能,否则链接会默认把路径当作tooltips,这个方法对tags同样适合。
- 通过对图形对象打上不同的tags来分组控制图形对象,比如批量禁用一批图像的显示。
- 编辑界面下点击Edit Macro,如果勾选lightbox选项,则流程图在点击后会弹出浮窗单独显示,一般情况下不需要勾选。
- 当前阶段Draw.io宏有一个缺陷,就是不能居中显示,一种解决办法是勾选Simple Viewer选项,这个选项会把流程图渲染成图片显示,但图形会变得不可点击跳转。
通过HTML宏来隐藏标题
在页面结束位置插入HTML宏,内容如下:
<style type="text/css"> #title-heading, #main-header, .page-metadata { display: none;} </style>
按此方法,只要知道元素的选择器,比如id或class,都可以用此方法来隐藏。
- 无标签