Confluence 内容列表(Table of Contents)宏

内容列表(Table of Contents)宏将会扫描当前 Confluence 页面中的标题然后创建一个表格来显示这些标题。

这个有助于读者在很长的页面中通过提供的标题来快速定位页面结构。

宏参数的定义为,你可以使用这些参数在宏输出的内容和格式上进行定义。

Confluence 使用的存储格式或者 wikimarkup 格式中使用的参数和在宏浏览器中使用的标签是不同的,这些将会在下面在括号内容中列出(example)。

[table]
[tr][td][align=left]参数[/align]
[/td][td][align=left]默认值[/align]
[/td][td][align=left]说明[/align]
[/td][/tr]
[tr][td]输出类型(Output Type)
(type)

[/td][td]list
[/td][td][list]
[]list — 产生标准的内容列表表格。
[
]flat — 产生一个水平菜单样式的链接。
[/list][/td][/tr]
[tr][td]显示标题的数字(Display Section Numbering)
(outline)

[/td][td]clear
[/td][td]选择这个选择框,你的标题前面将会加上数字的排序。例如:1.1, 1.2, 1.3。
[/td][/tr]
[tr][td]列表样式(List Style)
(style)

[/td][td]disc
[/td][td]为每一个主题选择标题列表的样式。你可以选择有效的 CSS 样式表。例如:
[list]
[]none — 没有样式表选择
[
]circle — 选择样式表 circle
[]disc — 这个样式表为圆形点。这个是标准的样式表,这个样式表被用在默认的列表中。
[
]square — 选择样式表 square
[]decimal — 使用列表数字 (1, 2, 3, 4, 5)
[
]lower-alpha — 列表是小写字母 (a, b, c, d, e)
[]lower-roman — 列表是小写罗马数字 (i, ii, iii, iv, v, vi)
[
]upper-roman — 列表是大写罗马数字 (I, II, III, IV, V, VI)
[/list][/td][/tr]
[tr][td]标题缩进(Heading Indent)
(indent)

[/td][td]
[/td][td]设置标题缩进的样式情况。输入 10px 将会把标题缩进 10 个像素。例如,第一级的标题将会缩进 10 个像素,那么第二级的标题将会再相对第一级的标题缩进 10 个像素。
[/td][/tr]
[tr][td]分离器(Separator)
(separator)

[/td][td]brackets
[/td][td]这个参数只在屏幕显示列表的时候使用,你可以输入下面的值。
[list]
[]brackets — 所有的标题上加上: [ ]。
[
]braces — 所有的标题上加上: { }。
[]parens — 所有的标题上加上: ( )。
[
]pipe — 所有标题使用 | 符号分隔
[]anything — 每一个标题使用你输入的符号进行分隔。你可以输入任何文字作为分隔符。例如 "[b][/b]**"。如果你使用的是一个自定义分隔符,请确定的你分隔符输入的内容是你希望得到的,在分隔符直接没有空格等其他字符。
[/list][/td][/tr]
[tr][td]最小标题级别(Minimum Heading Level)
(minLevel)

[/td][td]1
[/td][td]选择你希望列出标题的最高级别。例如,输入 2 的话,标题列表将会列出第二级标题(包括第二级)和第二级以下的所有标题列表,但是这里是不会包括第一级标题的。
[/td][/tr]
[tr][td]最大标题级别(Maximum Heading Level)
(maxLevel)

[/td][td]7
[/td][td]选择你希望列出标题的最低级别。例如,输入 2 的话,标题列表将会列出第二级标题(包括第二级)和第二级以上的所有标题列表,这里将会显示第一级标题和第二级标题,但是这里是不会包括第三及其以下的标题的。
[/td][/tr]
[tr][td]包含标题(Include Headings)
(include)

[/td][td]
[/td][td]根据特殊的查询条件来过滤标题。你可以使用通配符字符。查看 [color=#3b73af]正则表达式[/color] 中的示例来构建正则表达式。
[/td][/tr]
[tr][td]不包含标题(Exclude Headings)
(exclude)

[/td][td]
[/td][td]根据特殊的查询条件来过滤标题。你可以使用通配符字符。查看 [color=#3b73af]正则表达式[/color] 中的示例来构建正则表达式。
[/td][/tr]
[tr][td]是否打印(Printable)
(printable)

[/td][td]checked
[/td][td]在默认情况下,TOC 是被打印出来的。如果你不对这个选择框选择的时候, TOC 将会在你打印的时候不被显示。[/td][/tr]
[tr][td]CSS 样式表名称(CSS Class Name)
(class)

[/td][td]
[/td][td]如果你在 CSS 样式表中自定义 TOC 样式,使用这个参数来讲 TOC 放置到

标签内,然后指定 CSS 样式表。
[/td][/tr]
[/table]
来源:http://cwiki.ossez.com/pages/viewpage.action?pageId=2393367