Template:Archive box/doc

This template can be used to display archives of a page in a floating box.

UsageEdit

Include the archive box on the talk page by adding:

Basic syntaxEdit

{{Archive box | [[/Archive <#>]] }}

Full syntaxEdit

{{Archive box
 | archivelist = /archivelist
 | auto        = <short|long|yes|no>
 | index       = /Archive index
 | links       = <#>
 | search      = <yes|no>
 | collapsible = <yes|no>
 | collapsed   = <yes|no>
 | box-width   = <#px or #em>
 | root        = Wikipedia_talk:{{PAGENAME}}/Archive #}}
 | style       = <CSS values> 
 | title       = <Alt. title>
 | image       = [[File:Foo.png|35px]]  
 | bot         = <name of bot>     
 | age         = <#> (defaults to days) | 
 [[/Archive <#>]], [[/Archive <#>]], [[/Archive <#>]], etc.
}}

Substitute [[/Archive <#>]] with the actual name(s) of the archive page(s) and make sure to add the forward slash / . How you present a list of archive pages is up to you. You can separate them with commas or format them as lists. You can also use piped links; see the #Automatic links and #Examples sections below.

ParametersEdit

PlacementEdit

The box uses a style that makes it float to the right. In other words, it will be aligned to the right edge of the page and all content following it will flow around the box.

Box widthEdit

The box width can be set by using the |box-width= parameter:

{{Archive box | box-width=13em | [[/Archive <#>]] }}
{{Archive box | box-width=200px | [[/Archive <#>]] }}

The standard width when this parameter is not used is 238px.

SearchEdit

A search bar which will search the archives of the current page can be added to the bottom of the box by using the |search=yes parameter. Other parameters can adjust the search bar.

  • |root= can be used to change the prefix of pages which are searched. The default is the current page name. Example: |root=User talk:Example/Archives will search in pages starting with User talk:Example/Archives.
  • |search-width= can be used to change the width of the text field, in characters. The default is 22, which fits the search bar with the default box width. Note: unlike |box-width=, this is a bare number with no units.
  • |search-break=yes will insert a break between the search bar and search button. The default is no.
  • |button-label= can be used to change the text on the search button. The default is Search.
{{Archive box | search=yes | [[/Archive <#>]] }}

ImageEdit

The image can be changed from the default using the | parameter. For example:

{{Archive box | image= [[Image:Crystal Clear app file-manager.png|35px]] | [[/Archive <#>]] }}
Other iconsEdit

If you wish to use something other than the default icon, there's a gallery of available icons at commons:Category:Archive icons.

StyleEdit

{{Archive box | style= CSS values | [[/Archive <#>]] }}

Examples:

Talk page colors on non-talk pages
background-color:#F8EABA; border-color:#C0C090;
Other page colors on talk pages
background-color:#F9F9F9; border-color:#AAAAAA;
Font size unchanged
font-size:1em;
Specific example, changing the background color to white 
{{archive box | auto=yes | style=background-color:#FFFFFF }}

Automatic linksEdit

If all the archives of a talk page are named exactly /Archive 1, /Archive 2 etc. (it will not work with e.g. /Archive1, /Archive 01, or subpages of a subpage, e.g. /Archives/Archive 1), you can use the auto parameter to display links to them all automatically. The list will update itself when new archives are added. If there are also named archives, you can manually add links to those as well.

Using |auto=yes

The links to the archive pages will appear as simple numbers, separated with commas (1, 2, 3, ...). Note: Archives numbered past 100 will be ignored.

{{archive box | auto=yes }}

The optional root=, links=, and nobr= parameters are passed to {{archive list}} when auto=yes. The following will look for a user's talk-page archives named /Archives/Archive 1, /Archives/Archive 2, etc., and list up to 5 archives per line:

{{archive box
 |auto= yes
 |root= User_Talk:{{PAGENAME}}/Archive <#>
 |links= 5
}}
Using |auto=long

If there are no more than 36 archive pages, and you prefer a three-column output, use |auto=long. The links to the archive pages will appear as Archive 1, Archive 2, etc. The links will be put into lines with a line break after each third link, to create columns. (Re-arranging the columns, e.g. from top to bottom, is not possible with this parameter. However, manually added links can be arranged in columns with {{multicol}}. See the multicol example below.)

{{archive box |auto=long }}

The optional |root= parameter is passed to {{archive list}} when |auto=long. The following will look for a user's talk-page archives named /Archives/Archive 1, /Archives/Archive 2, etc.

{{archive box
 |auto= long
 |root= User_Talk:{{PAGENAME}}/Archive <#>
}}

ExamplesEdit

For actual examples of the use of this template, use the what links here link in the toolbox on the sidebar, near the top on the left side of this page (unless you are using an unconventional skin ... in which case you probably know what you are doing).

Wikitext Appearance
{{archive box|search=yes|
[[/Archive 1]],
[[/Archive 2]],
[[/January 2008 - December 2008]] and
[[/Deletion discussion]]
}}

Archives

/Archive 1, /Archive 2, /January 2008 - December 2008 and /Deletion discussion

{{archive box|
[[/Archive 1]]<br />
[[/Archive 2]]<br />
[[/January 2008 - December 2008]]<br />
[[/Deletion discussion]]
}}

Archives

/Archive 1
/Archive 2
/January 2008 - December 2008
/Deletion discussion

{{archive box|
: [[/Archive 1]]
: [[/Archive 2]]
: [[/January 2008 - December 2008]]
: [[/Deletion discussion]]
}}

Archives
/Archive 1
/Archive 2
/January 2008 - December 2008
/Deletion discussion
{{archive box|image=[[Image:File-manager.svg|35px]]|
* [[/Archive 1|Archive 1]]
* [[/Archive 2|Archive 2]]
* [[/January 2008 - December 2008|January 2008 - December 2008]]
* [[/Deletion discussion|Deletion discussion]]
}}
File-manager.svg
Archives
  • Archive 1
  • Archive 2
  • January 2008 - December 2008
  • Deletion discussion
{{archive box|index=/Archive index|search=yes|bot=FooArchiveBot|age=90|
# [[/Archive 1]]
# [[/Archive 2]]
# [[/January 2008 - December 2008]]
# [[/Deletion discussion]]
}}

Archives (Index)
  1. /Archive 1
  2. /Archive 2
  3. /January 2008 - December 2008
  4. /Deletion discussion
Threads older than 90 days are archived by FooArchiveBot.
{{archive box|box-width=10em|
* [[/Archive 1|Archive 1]]
* [[/Archive 2|Archive 2]]
* [[/January 2008 - December 2008|January 2008 – December 2008]]
}}

Archives
  • Archive 1
  • Archive 2
  • January 2008 – December 2008
{{Archive box|
{{multicol}}
'''2007'''<br>
[[/Archive1|1]]<br>
[[/Archive2|2]]<br>
[[/Archive3|3]]<br>
[[/Archive4|4]]<br>
[[/Archive5|5]]<br>
{{multicol-break}}
'''2008'''<br>
[[/Archive6|6]]<br>
[[/Archive7|7]]<br>
[[/Archive8|8]]<br>
[[/Archive9|9]]<br>
[[/Archive10|10]]<br>
[[/Archive11|11]]<br>
{{multicol-break}}
'''2009'''<br>
[[/Archive12|12]]<br>
[[/Archive13|13]]<br>
{{multicol-end}}
}}

Archives

2007
1
2
3
4
5

2008
6
7
8
9
10
11

2009
12
13

{{archive box|search=yes|
{{Center|'''Sorted by date:'''}}
:#[[/Archive1|August–October 2008]]: Discussion with User.
:#[[/Archive2|August–November 2008]]: Discussion of rewrite.
:[[/Subpage 1]], [[/Subpage 2|2]], [[/Subpage 3|3]]
}}

Archives

Sorted by date:

  1. August–October 2008: Discussion with User.
  2. August–November 2008: Discussion of rewrite.
/Subpage 1, 2, 3

See alsoEdit

Last modified on 13 December 2010, at 21:40
http://en.m.wikibooks.org/wiki/Template:Archive_box/doc
en.m.wikibooks.org
crawl=CC-MAIN-2014-10
37376
application/http; msgtype=response
sha1:CXCVYJXE4RRE5OHBQVFZFXMXWUTTXA3Q
<urn:uuid:ad58230b-4e03-4ca0-ab2d-34979885c8ea>
2014-03-09T13:38:37Z
208.80.154.236
sha1:PYDUOV6I2D73GSFAZ4XVKPLVKXJIYRPU
<urn:uuid:5efe4559-70f0-48ff-96dd-6c4983d06b8f>
http://en.m.wikibooks.org/wiki/Template:Archive_box/doc
response
<urn:uuid:baab66e7-2f50-4be0-b5a6-0f0c5f4112b7>
robots: classic
hostname: ip-10-183-142-35.ec2.internal
software: Nutch 1.6 (CC)/CC WarcExport 1.0
isPartOf: CC-MAIN-2014-10
operator: CommonCrawl Admin
description: Wide crawl of the web with URLs provided by Blekko for March 2014
publisher: CommonCrawl
format: WARC File Format 1.0
conformsTo: http://bibnum.bnf.fr/WARC/WARC_ISO_28500_version1_latestdraft.pdf