Template:Archive box/doc
![]() | 此頁面是Template:Archive box的Template文档。 此頁面可能包含了模板的使用說明、分類和其他内容。 |
![]() | 此模板的文档不存在、不全面或不能详细描述其功能及/或其代码中的参数。请帮助扩充并改进其文档。 |
![]() | 此模板为{{archives}}的老式包装。{{archives}}相比此模板有更多功能,并默认会自动生成存档列表。 |
此模板適合使用在討論頁用來列出存檔的討論頁。
使用方法
编辑Include the archive box on the talk page by adding:
基本代碼
编辑{{Archive box | [[Archive <#>]] }}
完整代碼
编辑{{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}} | style = <CSS values> | title = <Alt. title> | image = [[File:Foo.png|35px]] | bot = <name of bot> | units = <time units (defaults to days)> | age = <#> (defaults to days) | [[/Archive <#>]], [[/Archive <#>]], [[/Archive <#>]], etc. }}
Substitute [[/Archive <#>]]
with the actual name(s) of the archive page(s). In the above replace each value enclosed inside < and > with an actual value or leave it empty. Replace the File:Foo.png with an actual image or remove that field entirely. Remember to remove the explanation "(defaults to days)". 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.
Parameters
编辑Placement
编辑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. (On some article and WikiProject talk pages, there is more than one right floating box. In that case, the edit links of the text sections next to those boxes often "bunch up". Use the {{stack}} template to provide a solution for that problem.)
Box width
编辑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.
Search
编辑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 <#>]] }}
Image
编辑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 icons
编辑If you wish to use something other than the default icon, there's a gallery of available icons at commons:Category:Archive icons.
Style
编辑<pre.raw>
{{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 links
编辑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}}/Archives |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}}/Archives }}
Examples
编辑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]] }} |
| ||||
{{archive box| [[/Archive 1]]<br /> [[/Archive 2]]<br /> [[/January 2008 - December 2008]]<br /> [[/Deletion discussion]] }} |
| ||||
{{archive box| : [[/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]] }} |
| ||||
{{archive box|index=/Archive index|search=yes|bot=FooArchiveBot|age=90| # [[/Archive 1]] # [[/Archive 2]] # [[/January 2008 - December 2008]] # [[/Deletion discussion]] }} |
| ||||
{{archive box|box-width=10em| * [[/Archive 1|Archive 1]] * [[/Archive 2|Archive 2]] * [[/January 2008 - December 2008|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}} }} |
| ||||
{{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]] }} |
|
Notes
编辑Talk header
编辑Many talk pages already include the {{Talk header}} template. By default, this template includes links to archive subpages assuming the archive subpages are numbered in the standard manner (Archive 1, Archive 2, etc.). If the {{Talk header}} template is on a page, and archive subpages are named in the standard manner, then a separate archive box is likely unnecessary. On the other hand, a separate archive box can pipe links (i.e. to display the date range of the archive). If you decide to go ahead and use the archive box anyway, you can add |noarchive=yes
to the Talk header to remove the redundant links to archives.
參見
编辑- {{archives}}
- {{archive box collapsible}}
- {{talk archive navigation}}
- Help:Archiving a talk page
- Tracking: Category:Archive boxes with unusual parameters
|