• Home
  • Random
  • Nearby
  • Log in
  • Settings
Donate Now If Wikipedia is useful to you, please give today.
  • About Wikipedia
  • Disclaimers
Wikipedia

Template:Archives

  • Template
  • Talk
  • Language
  • Watch
  • View source

Archives
Archive 1

Template documentation[view] [edit] [history] [purge]
WarningThis template is used on approximately 51,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

The {{Archives}} template may be used to add a box containing page links to archived discussions. It will automatically detect archived pages by default if they follow the format {{PAGENAME}}/Archive #, eliminating the need to manually update the box each time a new archive page is created. If a list of archives is given manually through the first unnamed parameter it does not check for archives automatically, instead auto=long or auto=short has to be added if both manual and automatic lists are used.

This page is intended to explain the details of template usage. For a general guide to archiving see Help:Archiving a talk page which includes a simpler explanation of this template.

Contents

  • 1 Usage
    • 1.1 Archive list
      • 1.1.1 Additional notes
    • 1.2 Icon image
    • 1.3 Search
    • 1.4 Archival method
    • 1.5 Other parameters
    • 1.6 Examples
  • 2 See also

Usage

{{archives
| archivelist = <!-- /archivelist -->
| auto        = <!-- short/long/no -->
| index       = <!-- /Archive index -->
| list        = 
| search      = <!-- yes/no -->
| root        =
| prefix      =
| collapsible = <!-- yes/no -->
| collapsed   = <!-- yes/no -->
| editbox     = <!-- yes/no -->
| box-width   = <!-- Box-width is deprecated and won't work -->
| style       = 
| title       = 
| image       = 
| image-size  =
| alt         = 
| link        = 
| target      = 
| bot         = 
| age         = 
| units       = <!-- time units (defaults to days) -->
|
<!-- optional additional text or list items -->
}}

Archive list

archivelist
Specifies a link to a subpage, such as "/archivelist", that contains the archive list.
auto= <short|long|no>
Specifies the format of the auto-generated archive list. If left unspecified, the default is "long"; any other word (except "no") will result in "short" and "no" disables auto-detection. Auto-detection is also disabled if a manual list is given in the first unnamed parameter.
index
Links the "Archives" title to a specified subpage, such as "/Archive index", that should be the subject index page for all archived discussions. Legobot may be used to create and maintain such an index.
list
Inline list of archives. The list parameter overrides automatic archive detection of pages named "Archive 1", "Archive 2" and so on. It cannot be used together with an automatically generated list.
(1st unnamed parameter)
Same as list parameter, but can be used together with an automatic list if auto=long or auto=short is used. This is usually done when other related archives are linked such as when using centralized talk pages or adding links to archives of alternative accounts.

With no explicit parameters, the archive list presented in the box is determined automatically. If a subpage called "{{PAGENAME}}/archivelist" exists, it will be used as the central content of the box. For an example, see Talk:Evolution, which [not currently] draws from Talk:Evolution/archivelist. The archivelist parameter changes the name of this subpage.

If no archive list subpage is detected, numbered archive subpages will be listed in long format. Such pages must be named as "/Archive #" because other naming styles will not be detected. The "long" auto format (the default) indicates "Archive 1", "Archive 2", and so on. The "short" auto format indicates only the archive number. See more examples below.

An additional list of archives can be passed in the first unnamed parameter, avoiding the need for a subpage.

Using "auto=no" will disable archive auto-detection. Manually specified archives will still be shown. [The archive box will also contain an "Edit" link, targeted at the archive list subpage, which can then be used to begin manually populating the list, if desired. This seems broken.] This may be desirable if the archive list is given in the title parameter.

Additional notes

The "auto" and "archivelist" parameters are not intended to be used together. (Doing so does not use the specified archive list page.)

The auto-generated archive list requires subpages to use the common naming convention. That is, "{{PAGENAME}}/Archive 1", "{{PAGENAME}}/Archive 2", and so on. The letter "A" must be capitalized, there must be a single space between the word "Archive" and the number, and there must be no leading zeros. If archive subpages do not conform to this convention, they can be renamed to conform, or a manual list can be maintained.

Specifying "auto" with any value other than "long" or "no" results in the short-format list; the use of "short" as the value just makes things more obvious to others.

Icon image

image
An alternate image to be used, defaults to "Replacement filing cabinet.svg". May also use image-size. none results in no image.
alt
Alt text for the image, for visually impaired readers. See WP:ALT. This defaults to empty. If a nonempty value is specified for link, alt should be nonempty too, and should indicate what will happen if the user clicks on the image.
link
Link for the image. This normally defaults to empty, which means no link. However, if alt is nonempty, it defaults to the image's file page.

The link and alt parameters only take effect if the image is changed from the default.

Search

search
If yes, adds a search box to the template.
root
Specify a different base than {{FULLPAGENAME}}/. Use prefix if the addition of a trailing slash is not desired.
search-break
Default:no
search-width
Default:22
search-button-label
Default: Search

Archival method

target
The title of the page (just the name, no link syntax) that threads are currently being archived to, for manual archiving.
bot
If specified, a note about automatic archiving will be shown.
age
If specified, this will be displayed as the archiving delay.
units
If specified, this will be displayed units for the archiving delay. The default is "days".

Other parameters

collapsible
If yes, makes the list collapsible.
collapsed
If yes, makes the list collapsed.
style
An arbitrary string of CSS can be applied to the box (use with care).
title
An alternative title, defaults to "Archives". The title is automatically linked to the /archivelist subpage if it exist. If another link is desired a wiki link may be inserted here.
editbox
If yes or omitted, includes a button to edit the archive box's sub-page /archivelist.

Examples

Default
{{archives}}

Archives
Archive 1

Short, index
{{archives
  |auto= short
  |index= /Archive index
}}

Archives
no archives yet (create)

See also

  • v
  • t
  • e
Templates for archiving
  • Archiving (simple)
  • Archiving (technical)
Recommended
  • {{Archives}} (very configurable side box or banner for main talk page)
  • {{Automatic archive navigator}} (banner placed on archive pages with navigation)
  • {{Talk header}} (banner with talk page guidelines and archives)
  • {{Archive top}} / {{Atop}} (archives/closes discussion)
  • lowercase sigmabot III (MiszaBot) (most popular auto archiving bot)
  • Archy McArchface (one-click archiver script)
Side box
  • {{Archives}}
Headers
With
navigation
  • {{Annual archive}}
  • {{Archived annually}}
  • {{Archive navigation}}
  • {{Archive number}}
  • {{Automatic archive navigator}} (does not need parameter)
  • {{Archives by months}}
  • {{Month-year archive nav}}
  • {{Monthly archived talk}}
  • {{UserTalkArchive}}
  • {{Warning archive notice}}
Without
navigation
  • {{Archive}}
  • {{Archive index}}
  • {{Archivemainpage}}
  • {{Archiving}}
  • {{Talk archive notice with diff}}
With
search
  • {{Talk header}} (contains an automatically appearing archive search box and nav)
Content
formatting
  • {{Archive top}} / {{atop}}
  • {{Archive top green}} / {{atopg}}
  • {{Archive top red}} / {{atopr}}
  • {{Archive top yellow}} / {{atopy}}
  • {{Archive bottom}} / {{abot}}
  • {{Closed rfc top}}
  • {{Collapse}}
  • {{Collapse top}}
  • {{Collapse bottom}}
  • {{Hidden archive top}} / {{hat}}
  • {{Hidden archive bottom}} / {{hab}}
  • {{Poll top}}
  • {{Poll bottom}}
Lists
  • {{Archive list}} (numbered archives usually the default)
  • {{Archive list alpha}}
  • {{Monthly archive list}}
  • {{Yearly archive list}}
Discussion
  • {{Archive request}}
  • {{Please archive}}
  • {{uw-archive}}
Automatic
archiving
systems
  • Archy McArchface (one-click archiver script)
  • ClueBot III
    • {{User:ClueBot III/ArchiveNow}}
  • HBC Archive Indexerbot (Legobot)
  • lowercase sigmabot III (MiszaBot)
  • OneClickArchiver
  • Bot873
  • {{Archive basics}}
  • {{subst:Bump}}
  • {{subst:Do not archive until}}
  • {{subst:Oca}}
  • {{subst:Pin section}}
  • {{subst:Setup auto archiving}}
  •  Category:Archival templates
The documentation on top is transcluded from Template:Archives/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.
Retrieved from "https://simple.wikipedia.org/w/index.php?title=Template:Archives&oldid=8977997"
Last edited on 3 August 2023, at 08:36

Languages

    • Адыгэбзэ
    • العربية
    • অসমীয়া
    • Авар
    • تۆرکجه
    • Basa Bali
    • বাংলা
    • 閩南語 / Bân-lâm-gú
    • Башҡортса
    • Беларуская
    • Беларуская (тарашкевіца)
    • भोजपुरी
    • Български
    • Čeština
    • Chavacano de Zamboanga
    • Chi-Chewa
    • Cymraeg
    • ދިވެހިބަސް
    • Diné bizaad
    • Dolnoserbski
    • डोटेली
    • Eesti
    • English
    • Esperanto
    • فارسی
    • Fiji Hindi
    • Français
    • Galego
    • ГӀалгӀай
    • ગુજરાતી
    • Gungbe
    • हिन्दी
    • Hornjoserbsce
    • Ilokano
    • Bahasa Indonesia
    • Interlingua
    • Italiano
    • कॉशुर / کٲشُر
    • Қазақша
    • Коми
    • Kurdî
    • Кыргызча
    • Latina
    • Latviešu
    • Ligure
    • La .lojban.
    • Magyar
    • मैथिली
    • Македонски
    • ဘာသာမန်
    • Bahasa Melayu
    • 閩東語 / Mìng-dĕ̤ng-ngṳ̄
    • မြန်မာဘာသာ
    • Nederlands
    • नेपाली
    • 日本語
    • Нохчийн
    • Norsk bokmål
    • Oʻzbekcha / ўзбекча
    • ਪੰਜਾਬੀ
    • ပအိုဝ်ႏဘာႏသာႏ
    • Русский
    • Sakizaya
    • Scots
    • Shqip
    • සිංහල
    • سنڌي
    • Slovenščina
    • کوردی
    • Српски / srpski
    • Srpskohrvatski / српскохрватски
    • தமிழ்
    • Tarandíne
    • တႆး
    • తెలుగు
    • Türkçe
    • Українська
    • اردو
    • Tiếng Việt
    • 文言
    • 粵語
    • 中文
    Wikipedia
    • Wikimedia Foundation
    • Powered by MediaWiki
    • This page was last changed on 3 August 2023, at 08:36.
    • Content is available under CC BY-SA 4.0 unless otherwise noted.
    • Privacy policy
    • About Wikipedia
    • Disclaimers
    • Code of Conduct
    • Developers
    • Statistics
    • Cookie statement
    • Terms of Use
    • Desktop