Шаблон:Compact TOC/Документация: различия между версиями

[досмотренная версия][досмотренная версия]
Нет описания правки
Нет описания правки
 
(не показаны 3 промежуточные версии этого же участника)
Строка 1: Строка 1:
{{Template
Шаблон для вставки навигационной полосы с алфавитным указателем.
|Name=Compact TOC
|Type=Навигация
|Type2=Оформление
|Type3=
|Sub=No
|Designer=CryptoUser
|Designer2=
|Designer3=
|Notes=
}}


== Использование ==
== Использование ==
Строка 51: Строка 41:


=== Параметры ===
=== Параметры ===
*<code>name=</code> &mdash; меняет заголовок на альтернативное название вместо "Содержание" или полностью скройте его, введя <code>name=no</code>
* <code>name=</code> &mdash; меняет заголовок на альтернативное название вместо «Содержание» или полностью скройте его, введя <code>name=no</code>.
*<code>side=yes</code> &mdash; put the "Contents" heading on the left side with a colon, instead of the top without one
* <code>side=yes</code> &mdash; размещает заголовок «Содержание» слева от строки символов.
*<code>center=yes</code> &mdash; center to ToC in the horizontal middle of the page, instead of floated left
* <code>center=yes</code> &mdash; центрирует горизонтальную полосу шаблона на странице.
*<code>right=yes</code> &mdash; align the ToC horizontally to the right of the page (may require <code><nowiki><br style="clear:right;" /></nowiki></code> after it, depending on page layout), instead of floated left (this parameter is mutually exclusive with the "center" option above, and should be used sparingly and with good reason)
* <code>right=yes</code> &mdash; выравнивает шаблон справа (может потребовать <code><nowiki><br style="clear:right;" /></nowiki></code> после него, в зависимости от макета страницы), вместо floated left (этот параметр является взаимоисключающим с параметром «center», указанным выше, и его следует использовать экономно и по уважительной причине).
*<code>align=</code> &mdash; sets the alignment of the ''links'' inside the table; default is left; use <code>center</code>, <code>right</code> or <code>left</code>
* <code>align=</code> &mdash; устанавливает выравнивание «ссылок» внутри таблицы; по умолчанию — влево; используйте <code>center</code>, <code>right</code> или <code>left</code>
*<code>nobreak=yes</code> &mdash; no linebreak between the A-B-C-etc. stuff and the See also/References/etc. stuff (note: does not affect the heading; use <code>side=</code> for that)
* <code>nobreak=yes</code> &mdash; нет разрыва строки между секциями «A-B-C…» и «См. также/Ссылки/и т. д.» (примечание: не влияет на заголовок; используйте <code>side=</code>).
*<code>top=yes</code> &mdash; enable the "Top" link; this is only useful if this copy of the ToC is at the bottom (or middle, theoretically) of the page, as a secondary ToC (every rendered page has a hidden <code><nowiki><a name="top" id="top"></a></nowiki></code> above the sitenotice which makes this link work without having to do anything but enable it in the template)
* <code>top=yes</code> &mdash; добавляет ссылку «Вверх»; необходимо в том случае, если шаблон стоит внизу страницы.
*<code>sym=yes</code> &mdash; enable the "!$@" link for symbolic entries section
* <code>sym=yes</code> &mdash; добавляет ссылку «!$@» — секцию для типографских знаков.
*<code>num=yes</code> &mdash; enable the "0–9" link for numeric entries section (note that it is "–", the en-dash, not "-", the hyphen-minus at upper right of most keyboards)
* <code>num=yes</code> &mdash; добавляет ссылку «0-9» — секцию для цифр.
*<code>symnum=yes</code> &mdash; enable the "!–9" link for combined symbolic and numeric entries section (note that it is "–" not "-", and that the preceding two options are mutually exclusive with this one)
* <code>symnum=yes</code> &mdash; добавляет ссылку «!-9» — комбинированную секцию для знаков и цифр.
*<code>custom1</code>, <code>custom2</code> and <code>custom3</code> &mdash; add up to 3 extra "custom" sections at the end of the list (alternatively <code>Sec1, Sec2, Sec3</code>)
* <code>custom1</code>, <code>custom2</code> и <code>custom3</code> &mdash; добавляет 3 дополнительных произвольных раздела в конце списка (или, иначе, <code>Sec1, Sec2, Sec3</code>).
*<code>seealso=yes</code> &mdash; enable link to the "See also" section
* <code>seealso=yes</code> &mdash; добавляет ссылку на раздел «См. также».
*<code>refs=yes</code> &mdash; enable link to the "References" section (note that it is plural)
* <code>refs=yes</code> &mdash; добавляет раздел «Ссылки».
*<code>notes=yes</code> &mdash; enable link to the "Notes" section (note that it is plural)
* <code>notes=yes</code> &mdash; добавляет раздел «Примечания».
*<code>notesfirst=yes</code> &mdash; enable link to the "Notes" section, but placed before "References"; '''''do not''' use with <code>notes</code>'' (note that it is plural)
* <code>notesfirst=yes</code> &mdash; помещает раздел «Примечания» перед разделом «Ссылки»; '''''не используйте''' вместе с <code>notes</code>''.
*<code>extlinks=yes</code> &mdash; enable link to the "External links" section
* <code>extlinks=yes</code> &mdash; добавляет ссылку на раздел «Литература».


====Letters====
==== Буквы ====
Any letter can be deleted by adding it as a '''lowercase''' blank parameter, or replaced with an unlinked letter by using that letter:
Некоторые буквы могут быть исключены из списка через добавление соответствующей ''строчной'' буквы:
{{tlx|Compact TOC|side&#61;yes|j&#61;|q&#61;}}
{{tlx|Compact TOC|side&#61;yes|j&#61;|q&#61;}}
{{Compact TOC|side=yes|j=|q=}}
{{Compact TOC|side=yes|j=|q=}}


Строка 77: Строка 68:
{{Compact TOC|side=yes|j=J|q=Q}}
{{Compact TOC|side=yes|j=J|q=Q}}


With a little more work, one can create range links:
Немного более сложным способом можно создать ссылки на диапазон:


{{tlx|Compact TOC|side&#61;yes|x&#61;<nowiki>[[#X-Z|X-Z]]</nowiki>|y&#61;|z&#61;}} (or <code>x=|y=|z=<nowiki>[[#X-Z|X-Z]]</nowiki></code> etc.)
{{tlx|Compact TOC|side&#61;yes|x&#61;<nowiki>[[#X-Z|X-Z]]</nowiki>|y&#61;|z&#61;}} (или <code>x=|y=|z=<nowiki>[[#X-Z|X-Z]]</nowiki></code> и т.д.)
{{Compact TOC|side=yes|x=[[#X-Z|X-Z]]|y=|z=}}
{{Compact TOC|side=yes|x=[[#X-Z|X-Z]]|y=|z=}}


====Shorthand====
==== Быстрая вставка ====
For quicker referencing common usage, <code>short1</code> can be entered as the first parameter (before <code>name=</code>):
Для более быстрого перехода к общему использованию, можно ввести в качестве первого параметра <code>short1</code> (перед <code>name=</code>):
{{tlx|Compact TOC|short1}}
{{tlx|Compact TOC|short1}}


{{Compact TOC|short1}}
{{Compact TOC|short1}}


===Examples===
=== Примеры ===
{{tlx|Compact TOC|top&#61;yes}}
{{tlx|Compact TOC|top&#61;yes}}
{{Compact TOC|top=yes}}
{{Compact TOC|top=yes}}
Строка 106: Строка 97:
<code><nowiki>{{</nowiki>'''CompactTOC'''<nowiki>|short1|num=yes|sym=yes|seealso=yes|notesfirst=yes|extlinks=yes}}</nowiki></code>
<code><nowiki>{{</nowiki>'''CompactTOC'''<nowiki>|short1|num=yes|sym=yes|seealso=yes|notesfirst=yes|extlinks=yes}}</nowiki></code>
{{Compact TOC|short1|num=yes|sym=yes|seealso=yes|notesfirst=yes|extlinks=yes}}
{{Compact TOC|short1|num=yes|sym=yes|seealso=yes|notesfirst=yes|extlinks=yes}}
<noinclude>[[Категория:Шаблоны:Документация]]</noinclude>

Текущая версия от 12:08, 27 марта 2024

Шаблон для вставки навигационной полосы с алфавитным указателем.

Использование

Typical:

{{Compact TOC|symnum=yes}}

Только алфавит (без цифр и типографики):

{{Compact TOC}}

Полный набор знаков, по центру (не указывайте параметр или измените его на пустой или "no", чтобы отключить функцию)

{{Compact TOC|name=Contents|side=yes|center=yes|right=|align=center|nobreak=yes|top=yes|num=yes|sym=yes|symnum=|custom1=|custom2=|custom3=|seealso=yes|notesfirst=|refs=yes|notes=yes|extlinks=yes}}

или

{{Compact TOC
|name=
|side=yes
|center=yes
|right=
|align=center
|nobreak=yes
|top=yes
|num=yes
|sym=yes
|symnum=
|custom1=
|custom2=
|custom3=
|seealso=yes
|notesfirst=
|refs=yes
|notes=yes
|extlinks=yes
|a=
...
|я=
}}

Параметры

  • name= — меняет заголовок на альтернативное название вместо «Содержание» или полностью скройте его, введя name=no.
  • side=yes — размещает заголовок «Содержание» слева от строки символов.
  • center=yes — центрирует горизонтальную полосу шаблона на странице.
  • right=yes — выравнивает шаблон справа (может потребовать <br style="clear:right;" /> после него, в зависимости от макета страницы), вместо floated left (этот параметр является взаимоисключающим с параметром «center», указанным выше, и его следует использовать экономно и по уважительной причине).
  • align= — устанавливает выравнивание «ссылок» внутри таблицы; по умолчанию — влево; используйте center, right или left
  • nobreak=yes — нет разрыва строки между секциями «A-B-C…» и «См. также/Ссылки/и т. д.» (примечание: не влияет на заголовок; используйте side=).
  • top=yes — добавляет ссылку «Вверх»; необходимо в том случае, если шаблон стоит внизу страницы.
  • sym=yes — добавляет ссылку «!$@» — секцию для типографских знаков.
  • num=yes — добавляет ссылку «0-9» — секцию для цифр.
  • symnum=yes — добавляет ссылку «!-9» — комбинированную секцию для знаков и цифр.
  • custom1, custom2 и custom3 — добавляет 3 дополнительных произвольных раздела в конце списка (или, иначе, Sec1, Sec2, Sec3).
  • seealso=yes — добавляет ссылку на раздел «См. также».
  • refs=yes — добавляет раздел «Ссылки».
  • notes=yes — добавляет раздел «Примечания».
  • notesfirst=yes — помещает раздел «Примечания» перед разделом «Ссылки»; не используйте вместе с notes.
  • extlinks=yes — добавляет ссылку на раздел «Литература».

Буквы

Некоторые буквы могут быть исключены из списка через добавление соответствующей строчной буквы: {{Compact TOC|side=yes|j=|q=}}

Содержание:
  A B C D E F G H I K L M N O P R S T U V W X Y ZА Б В Г Д Е Ё Ж З И Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Э Ю Я  


{{Compact TOC|side=yes|j=J|q=Q}}

Содержание:
  A B C D E F G H I J K L M N O P Q R S T U V W X Y ZА Б В Г Д Е Ё Ж З И Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Э Ю Я  


Немного более сложным способом можно создать ссылки на диапазон:

{{Compact TOC|side=yes|x=[[#X-Z|X-Z]]|y=|z=}} (или x=|y=|z=[[#X-Z|X-Z]] и т.д.)

Содержание:
  A B C D E F G H I J K L M N O P Q R S T U V W X-ZА Б В Г Д Е Ё Ж З И Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Э Ю Я  


Быстрая вставка

Для более быстрого перехода к общему использованию, можно ввести в качестве первого параметра short1 (перед name=): {{Compact TOC|short1}}

Содержание:   A B C D E F G H I J K L M N O P Q R S T U V W X Y ZА Б В Г Д Е Ё Ж З И Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Э Ю Я     Ссылки 


Примеры

{{Compact TOC|top=yes}}

Содержание
  Вверх - A B C D E F G H I J K L M N O P Q R S T U V W X Y ZА Б В Г Д Е Ё Ж З И Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Э Ю Я  


{{Compact TOC|name=no|center=yes|top=yes|custom1=Новый раздел|...}}


{{Compact TOC|side=yes|sym=yes|num=yes|refs=yes|...}}

Содержание:
  !$@0–9A B C D E F G H I J K L M N O P Q R S T U V W X Y ZА Б В Г Д Е Ё Ж З И Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Э Ю Я  
Другое  Ссылки 


{{Compact TOC|name=Указатель|top=no|refs=yes|notes=yes|...}}

Указатель


{{Compact TOC|name=no|side=yes|right=yes|symnum=yes|...}}

  !–9A B C D E F G H I J K L M N O P Q R S T U V W X Y ZА Б В Г Д Е Ё Ж З И Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Э Ю Я  
См. также 


{{CompactTOC|short1|num=yes|sym=yes|seealso=yes|notesfirst=yes|extlinks=yes}}

Содержание:   !$@0–9A B C D E F G H I J K L M N O P Q R S T U V W X Y ZА Б В Г Д Е Ё Ж З И Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Э Ю Я     См. также  Примечания  Ссылки  Литература