模板:Dotted TOC page listing/top

Entry text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1

模板文件[檢視] [編輯] [歷史] [清除快取]

本模板模仿原文中的目錄格式，用於維基文庫的作品頁面。

用法

參數：

• chaptertext (1)：章節號碼（可選），顯示於項目的左側。
• entrytext (2)：章節或項目的標題
• pagetext (3)：鏈接的頁碼
• symbol：任何系列的符號或圖片，默認為「.」。NB! Do not use any templates inside this parameter. Any templates here will be expanded (to much more than the single dot) and then repeated ~50 times for every single line. A large, but not abnormal, TOC observed in the wild generated ~1.5MB of HTML output (and hit the MediaWiki hard transclusion limit).
• spaces (4)：符號之間的空格數量，可輸入0至10之間的數字，默認為1。
• dotend：點線後額外的文字，以供排版之用。
• pagenum : Display page number to wikilink to; must be an Arabic number
• positionoffset : use with pagenum to wikilink to compute page number of current document to link to, adjusted for pages of front matter
• djvupage
• djvupageoffset
• hi：a measure for the hanging indent when text overflows to a second line. Default is 1em.
• chapter-width：調整章節列的寬度，默認為2.5em。
• chapter-align：調整章節列的對齊方向，默認為「right」。
• entry-align：調整項目列（即第二列）的對齊方向，默認為「left」，亦可選「justify」。
• entry-width：調整項目列的寬度，默認為80%。
• col3-width：調整第三列的寬度，默認為2em。
• col3-align：調整第三列的對齊方向，默認為「right」，亦可選「center」或「left」。
• dottext：取代默認的「.」符號。
• col4text：在頁碼後加入第四列。
• col4-width：調整第四列的寬度，默認為2em。
• col4-align：調整第四列的對齊方向，默認為「right」，亦可選「center」或「left」。
• textbackground : Adjusts the CSS background of the entry text. Default is white. (Note: this is not the same as "none")

相關模板

To cater for situations where a desired listing crosses one or more page boundaries, a number of variants upon this template exist, all of which accept the same parameters (and silently ignore any which do not apply to them):

• {{dotted TOC page listing/top}}: permits specification of listing segment appearing above the page break.
• {{dotted TOC page listing/suspend}}: (normally appears in page footer) closes off listing processing for current page only.
• {{dotted TOC page listing/resume}}: (normally appears in page header) reopens listing processing for a new page.
• {{dotted TOC page listing/continue}}: (appears in subsequent body; not normally required) continues specification of entry component of listing on a new page, which will be completed only on yet another following page.
• {{dotted TOC page listing/bottom}}: (normally appears at top of page body) completes specification of entry component initiated on a prior page.

Note: use of the named parameters are preferred when working with any of the boundary-crossing templates above.

Applying {{dotted TOC page listing/top}}{{dotted TOC page listing/continue}}{{dotted TOC page listing/bottom}} (no intervening new-lines between template invocations; all bearing same parameter specifications) should produce the same result as using {{dotted TOC page listing}} with only minor deviations from the same parameters and values normally used in the core template.

Examples

• For an example of the use of {{Dotted TOC page listing}} (combined with {{TOC page listing}}) see: this page.
• For an example of the use of {{Dotted TOC page listing/top}} (etc.) see: this page (and the next); and how it looks in the main namespace: this page.
• For examples of pagenum and positionoffset, which work together, see (this page and the other tables of contents in that document)

Redirect

• Template:TOC line — redirect usage deprecated 6/7/2014; inconsistent &/or non-descriptive naming.

Export

Because this template uses an entire table for every row, it does usually not export well to devices with simpler CSS engines (e.g. e-readers). It also generates a very large amount of HTML markup. Templates like {{TOC row 1-dot-1}}/{{TOC row 2dot-1}} export better as they result in a single table for the whole TOC. If the amount of HTML is causing issues with the Mediawiki transclusion limits, consider not using dots at all.

See also

• Template:TOC page listing (typically used for TOC column headings)
• Template:Dotted TOC line