Шаблон:Dotted TOC page listing/документація

Це підсторінка документації шаблону {{Dotted TOC page listing}}.
Вона містить інформацію про використання, категорії та інші дані, які не є частиною шаблону.

Використання

Використовується на сторінках простору назв Сторінка: для відображення змісту твору або роботи згідно з оригіналом.

Параметри

chaptertext (1) : номер розділу (заповнюється при наявності). Відображається ліворуч від стовпчика entrytext (2).
entrytext (2) : назва розділу
pagetext (3) : the page number to be linked; can be any text including Roman numerals, etc.; for wikilinking, consider {{DJVU page link}}
symbol : послідовність символів або зображень. За замовчуванням — «крапка» («.»)
spaces (4) : кількість пробілів між елементами symbol — від 0 до 10. За замовчуванням — 1.
dotend : Additional text at the end of the line of dots, for offsets etc.
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
hi : a measure for the hanging indent when text overflows to a second line. Default is 1em.
chapter-width : ширина стовпчика chaptertext (1). За замовчуванням — 2.5em.
chapter-align : горизонтальне вирівнювання тексту в стовпчику «номер розділу». За замовчуванням — right. Варіанти: left, center.
chapter-valign : вертикальне вирівнювання тексту в стовпчику «номер розділу». За замовчуванням — top. Варіанти: middle, bottom.
entry-width : ширина стовпчика entrytext (2). За замовчуванням — 100%.
entry-align : горизонтальне вирівнювання тексту в стовпчику «назва розділу». За замовчуванням — left. Варіанти: justify, right, center.
entry-style : додаткові css для стовпчика «назва розділу».
col3-width : ширина стовпчика pagetext (3). За замовчуванням — 2em.
col3-align : горизонтальне вирівнювання тексту в стовпчику «номер сторінки». За замовчуванням — right. Варіанти: left, center.
col3-valign : вертикальне вирівнювання тексту в стовпчику «номер сторінки». За замовчуванням — bottom. Варіанти: middle, top.
dottext : Replaces the series of periods (".") by text.
col4text : додатковий 4-й стовпчик після pagetext (3) (номера сторінки).
col4-width : ширина стовпчика col4text. За замовчуванням — 2em.
col4-align : Adjusts the alignment of the fourth column. Default is "right"; alternate choice: "center" or "left".
textbackground : Adjusts the CSS background of the entry text. Default is white. (Note: this is not the same as "none")
(5) : максимальна гранична кількість елементів symbol у рядку. За замовчуванням для кожного значення параметра spaces (4) встановлена у відповідних шаблонах {{Dotted TOC page listing/n}} така кількість, щоб заповнити елементами symbol весь рядок до правої границі сторінки. Це може призвести до надмірного збільшення розміру і відповідно некоректного відображення тої сторінки, до якої включаються сторінки змісту (трансклюзія). У таких випадках ця сторінка потрапить до Категорія:Сторінки з перевищеним розміром включених шаблонів. Для запобігання цього використовуйте 5-й параметр, максимально зменшуючи кількість елементів symbol до необхідного відповідно до оригіналу твору.

Розширення

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.

Див. також

Шаблон:TOC page listing