Plantilla:TOC
Sumario |
---|
Purpose
This is a Table-of-Contents replacement for alphabetical lists:
- The compact format goes sideways: A B C D E F G H I J K L ....
- The centering or numbers are optional: center=yes, num=yes.
- The "Contents" heading can go on top (default) or the side (side=yes).
- Letter ranges can be set (see below: #Letters): A B C-F G H-K L...
- Some letters can be omitted, instead of 26 separate letters.
- Other headers can be listed in the TOC (see below: Listing custom-headers).
- Set upper headers before "ABCDEF" by pre1, pre2, ... pre8.
- Set lower headers after "ABCDEF" by custom1, custom2, ... custom8.
- Conceal subheader link-text as "pre1name" over "pre1link" and "custom1name" over "custom1link" etc.
- Other options include: top=yes, seealso=yes, refs=yes, extlinks=yes, etc.
The template has all features of Template:CompactTOC7, plus some from Template:CompactTOC2, such as optional "Top" "0-9" sections, and allows selecting other sections.
Usage
Typical:
{{TOC|symnum=yes}}
For alphabetical only (no number or symbol entries):
{{TOC}}
For maximum number of features and centered placement (leave off a parameter or change it to blank or "no" to disable a feature)
{{TOC |name= |side=yes |center=yes |right= |align=center |nobreak=yes |top=yes |num=yes |sym=yes |symnum= |pre1= |pre1name= |pre1link= ... |pre8= |pre8name= |pre8link= |prebreak=
|custom1= |custom1name= |custom1link= ... |custom8= |custom8name= |custom8link= |seealso=yes |notesfirst= |refs=yes |notes=yes |extlinks=yes |a= ... |z= }}
Parameters
name
= — cambia el encabezado por defecto Tabla de Contenidos, o lo elimina (name=no
)side=yes
— Pone el encabezado a la izquierda, y no en la parte superiorcenter=yes
— centra la tabla (que por defecto va a la izquierda)right=yes
— Alinea la tabla a la derecha. Puede requerir incluir<br style="clear:right;" />
después (parámetro no compatible con center=yes)align=
— alinea los enlaces al inerior de la tabla (center, right o left)nobreak=yes
— no quiebra la línea después de la lista de letras A-B-...Y-Z (para los parámetros referencias, notas, etc. No afecta encabezadotop=yes
— enable the "Top" link; this is only useful if this copy of the ToC is a secondary ToC not at the top of the page, e.g. in the middle of a long glossary. (Every rendered page has a hidden <a name="top" id="top"></a> above the sitenotice which makes this link work without having to do anything but enable it in the template.)sym=yes
— enable the "!$@" link for symbolic entries sectionnum=yes
— enable the "0–9" link for numeric entries section (create a heading of ==0–9== for the link to work)symnum=yes
— enable the "!–9" link for combined symbolic and numeric entries section (create a heading of ==!–9== for the link to work)sep=·
— set the separator-text between word-headers (not between "ABCDEF") to "·"; could also be a vertical-bar or•
(•), etc.pre1
topre8
— list up to 8 extra section headers before (pre-list) the "ABCDEF" list. These appear as [[#pre1|pre1]].pre1name
topre8name
— modifies the way the pre-list section headers appear: [[#pre1|pre1name]]pre1link
topre8link
— modifies the targets of the pre-list headers: [[pre1link|pre1]].prebreak=<br>
— set break-line after all pre-list headers; can include text to introduce "ABCDEF".seealso=yes
— enable link to the "See also" sectionrefs=yes
— enable link to the "References" section (observe that it is plural)notes=yes
— enable link to the "Notes" section (observe that it is plural)notesfirst=yes
— enable link to the "Notes" section, but placed before "References"; do not use withnotes
(and do observe that it is plural)extlinks=yes
— enable link to the "External links" sectiona=
throughz=
— individually disable particular letters that have no entries. Use with caution and check regularly to make sure that new entries do not require the removal of these parameters. Can also be used to create range links, e.g. "X-Z". (See #Letters below for more detailed documentation of this feature.)
Letters
Any letter can be omitted (i.e. when it has no entries in the list) by specifying it as a lower-case blank parameter: {{TOC|side=yes|j=|q=}}
|
Or it can be replaced with an unlinked letter by using that letter (upper-case): {{TOC|side=yes|j=J|q=Q}}
|
Note: It is often better to create an empty placeholder span (e.g. <span id="Q" />
where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing new users who might not realize the TOC-template has skipped some letters.
The letter-assignment feature can also be used to create range links:
{{TOC|side=yes|x=[[#X-Z|X-Z]]|y=|z=}}
|
The feature can also be used (very tediously) for linking to sub-articles (e.g., for long lists that have been split into multiple pages):
{{TOC|name=[[Articlename]]|side=yes|n=[[Articlename (N–Z)#N|N]]|o=[[Articlename (N–Z)#O|O]]|...|z=[[Articlename (N–Z)#Z}}
|
Or, as another example:
{{TOC|side=yes|n=[[Articlename (N–Z)| N–Z (next page)]]|o=|p=|...|z=}}
|
Listing custom-headers
The optional parameters pre1...pre8 and custom1...custom8 allow listing up to 16 other section-headers in the TOC, before or after, the "ABCDEF" list:
{{TOC|name=no|center=yes|top=yes|seealso=yes|notes=yes|custom1=New section|custom2=Additional section}}
{{TOC|name=no|center=yes|top=yes|seealso=yes|notes=yes|custom1=New section|custom1name=Custom section name|custom2=Outside page}}
Headers can be listed before & after "ABCDEF" using pre1 & custom1:
- {{TOC|center=yes|align=center|top=yes|seealso=yes
|pre1=Scope of list|pre2=Abbreviations used|prebreak=<br>
|custom1=Popular entries}}
Sumario |
---|
The separator text can be set to a mid-dot by "sep=·" :
- {{TOC|center=yes|align=center|top=yes|seealso=yes
|pre1=Scope of list|pre2=Abbreviations used|prebreak=<br>
|custom1=Popular entries}}
Sumario |
---|
Shorthand
short1
can be used as the very first parameter (beforename=
) for shortening a common usage:
{{TOC|short1}}
Sumario: | 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 Referencias |
---|
It replaces {{TOC|side=yes|center=yes|nobreak=yes|refs=yes}}
Examples
{{TOC|top=yes}}
|
{{TOC|side=yes|sym=yes|num=yes|refs=yes|seealso=yes|custom1=Other}}
|
{{TOC|name=Directory|top=no|refs=yes|notes=yes|extlinks=yes}}
|
{{TOC|name=no|side=yes|right=yes|symnum=yes|seealso=yes}}
{{TOC|short1|num=yes|sym=yes|seealso=yes|notesfirst=yes|extlinks=yes}}
Sumario: | !$@ 0–9 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 Véase también Notes Referencias External links |
---|
Los editores pueden experimentar en la zona de pruebas de esta plantilla.
Por favor, añade las categorías e interwikis a la subpágina de documentación. Subpáginas de esta plantilla.