Confluence 內容列表（Table of Contents）宏

內容列表（Table of Contents）宏將會掃描當前 Confluence 頁面中的標題然后創建一個表格來顯示這些標題。這個有助於讀者在很長的頁面中通過提供的標題來快速定位頁面結構。

使用內容列表宏

提示： 如果希望從頁面編輯框中快速插入，可以選擇 插入 > 表格內容（Insert > Table of Contents）。

希望在頁面中添加內容列表宏：

 

1. 打開你希望編輯 Confluence 頁面，然后單擊 編輯（Edit）按鈕。頁面的編輯模式將會被打開。
2. 下一步，在編輯工具欄中單擊宏瀏覽器圖標。這時候宏瀏覽器將會在屏幕的中間打開。
3. 在宏瀏覽器中，在窗口的右上角的對話框中輸入你希望插入的宏的名稱。當找到與你輸入的宏名稱接近的宏后將會在中間的面板上顯示。單擊需要的宏然后來查看可用進行配置的宏選項，在這里你可以對需要插入的宏設置相關參數，然后單擊 插入（insert）來將需要的宏插入到頁面中。

 

參數

宏參數的定義為，你可以使用這些參數在宏輸出的內容和格式上進行定義。

Confluence 使用的存儲格式或者 wikimarkup 格式中使用的參數和在宏瀏覽器中使用的標簽是不同的，這些將會在下面在括號內容中列出(example)。

 

參數	默認值	說明
輸出類型（Output Type） (type)	list	list — 產生標准的內容列表表格。 flat — 產生一個水平菜單樣式的鏈接。
顯示標題的數字（Display Section Numbering） (outline)	clear	選擇這個選擇框，你的標題前面將會加上數字的排序。例如：1.1, 1.2, 1.3。
列表樣式（List Style） (style)	disc	為每一個主題選擇標題列表的樣式。你可以選擇有效的 CSS 樣式表。例如： 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)
標題縮進（Heading Indent） (indent)		設置標題縮進的樣式情況。輸入 10px 將會把標題縮進 10 個像素。例如，第一級的標題將會縮進 10 個像素，那么第二級的標題將會再相對第一級的標題縮進 10 個像素。
分離器（Separator） (separator)	brackets	這個參數只在屏幕顯示列表的時候使用，你可以輸入下面的值。 brackets — 所有的標題上加上： [ ]。 braces — 所有的標題上加上： { }。 parens — 所有的標題上加上： ( )。 pipe — 所有標題使用 | 符號分隔 anything — 每一個標題使用你輸入的符號進行分隔。你可以輸入任何文字作為分隔符。例如 "***"。如果你使用的是一個自定義分隔符，請確定的你分隔符輸入的內容是你希望得到的，在分隔符直接沒有空格等其他字符。
最小標題級別（Minimum Heading Level） (minLevel)	1	選擇你希望列出標題的最高級別。例如，輸入 2 的話，標題列表將會列出第二級標題（包括第二級）和第二級以下的所有標題列表，但是這里是不會包括第一級標題的。
最大標題級別（Maximum Heading Level） (maxLevel)	7	選擇你希望列出標題的最低級別。例如，輸入 2 的話，標題列表將會列出第二級標題（包括第二級）和第二級以上的所有標題列表，這里將會顯示第一級標題和第二級標題，但是這里是不會包括第三及其以下的標題的。
包含標題（Include Headings） (include)		根據特殊的查詢條件來過濾標題。你可以使用通配符字符。查看 正則表達式 中的示例來構建正則表達式。
不包含標題（Exclude Headings） (exclude)		根據特殊的查詢條件來過濾標題。你可以使用通配符字符。查看 正則表達式 中的示例來構建正則表達式。
是否打印（Printable） (printable)	checked	在默認情況下，TOC 是被打印出來的。如果你不對這個選擇框選擇的時候， TOC 將會在你打印的時候不被顯示。
CSS 樣式表名稱（CSS Class Name） (class)		如果你在 CSS 樣式表中自定義 TOC 樣式，使用這個參數來講 TOC 放置到 <div> 標簽內，然后指定 CSS 樣式表。

 

來源：http://cwiki.ossez.com/pages/viewpage.action?pageId=2393367