View source for Template:Archive list/doc

{{Documentation subpage}}
{{High-use|45109}}
{{lua|Module:Archive list}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE. -->

This template can be applied to any talk page or discussion archive, and will return links to all the numbered archives of that page or its parent page. By default the template uses the naming convention specified at [[WP:ARCHIVE]], <code>Talk:PAGENAME/Archive 1</code>, with a capital A, a space before the number, and no leading zeros. This template should not usually be substituted&nbsp;– that way, the list of links will update itself whenever a new numbered archive is added.

This template can be used with {{tl|archive box}} to produce a box of numbered archive links without entering them all manually. To do this, use <code><nowiki>{{archive&nbsp;box|auto=yes}}</nowiki></code>.

== Usage ==

<pre>{{archive list
| root            = 
| links           = 
| nobr            = 
| prefix          = 
| prefixspace     = 
| linkprefix      = 
| linkprefixspace = 
| sep             = 
| linesep         = 
| start           = 
| max             = 
| auto            =
}}</pre>

== Parameters ==

Valid parameters are:
* <code>root = ''<root>''</code> - use this to specify a root other than that of the page from which the template is transcluded.
* <code>links = ''#''</code> - the number of links to display per line. The default is 10.
* <code>nobr = ''yes''</code> - set this to <code>''yes''</code> to remove all line breaks. This parameter cannot be used in conjunction with {{para|links}}.
* <code>prefix = ''<prefix>''</code> - a custom prefix for the archives, without the number. The default is "Archive ".
* <code>prefixspace = ''yes''</code> - adds a space between the prefix and the archive number for prefixes specified with {{para|prefix}}.
* <code>linkprefix = ''<linkprefix>''</code> - a custom prefix for the display links, without the number. The default is blank. If auto=long, use 'none' to have it blank.
* <code>linkprefixspace = ''yes''</code> - adds a space between the link prefix and the archive number for prefixes specified with {{para|linkprefix}}.
* <code>sep = ''<sep>''</code> - the separator for archive links. The default value is the comma separator for the language set in your preferences: "<code>{{int:comma-separator}}</code>". If this is set to either <code>''dot''</code> (<code>{{int:dot-separator}}</code>), <code>''pipe''</code> (<code>{{int:pipe-separator}}</code>), <code>''comma''</code> (<code>{{int:comma-separator}}</code>), or <code>''tpt-languages''</code> (<code>{{int:tpt-languages-separator}}</code>), then it uses that separator as specified for your default language. If it is any other value, that value is used as it is. Whitespace is stripped from the values, but this can be worked around by using <code>&amp;#32;</code> (for spaces) and <code><nowiki><br /></nowiki></code> (for new lines). It is also possible to work around the whitespace limitation by calling [[Module:Archive list]] directly from another [[WP:Lua|Lua]] module.
* <code>linesep = ''<linesep>''</code> - the separator for lines of archive links. The possible input values are the same as for the {{para|sep}} parameter, and the default separator text is <code><nowiki><br /></nowiki></code>. How often the value is displayed depends on the value of {{para|links}}.
* <code>start = ''#''</code> - the archive number to start listing archives from. This must be smaller than the largest archive number, or {{para|max}} if it is specified.
* <code>max = ''#''</code> - the largest archive number to list. This overrides the automatic detection of archive page numbers.
* <code>auto = ''long''</code> - outputs as a table. Changes default value of links to 3 and linkprefix to 'Archive '.

== Limitations ==

This template has been updated to use [[Module:Archive list]]. The old template was limited to detecting 200 archives, but now there is no such limitation. However, at very high numbers of archives the template might reach the [[Wikipedia:Template limits#Expensive parser function calls|expensive function call limit]]. On a page with no other templates that call expensive functions, this template should be able to output 400,000+ archive links. On pages with other templates that make expensive function calls, it may fail sooner.

== See also ==
*[[Module:Archive list]] - the Lua module this template is based on.
*{{tl|archive list long inline}}

== Related templates ==

For other related templates see navbox below.
{{warchivenav}}

<includeonly>{{sandbox other||<!--
++++ PLEASE ADD CATEGORIES BELOW THIS LINE, THANK YOU. -->
[[Category:Archival templates]]
}}</includeonly>