Wikisource

模板:Dotted TOC page listing/doc

< Template:Dotted TOC page listing

本模板模仿原文中的目录格式，用于维基文库的作品页面。

用法

编辑

參數：

  • 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):


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

编辑


检索自“https://zh.wikisource.org/w/index.php?title=Template:Dotted_TOC_page_listing/doc&oldid=2464627”