www.fgks.org   »   [go: up one dir, main page]

Help:Archiving a talk page: Difference between revisions

Content deleted Content added
m →‎Automated archiving: clearer subsection titles
(47 intermediate revisions by 33 users not shown)
Line 2:
{{Redirect2|Help:Archive|Help:Archiving|help on archiving web pages|Help:Archiving a source|the template used to mark discussions as closed|Template:Archive top|Wikipedia's historical archive|Wikipedia:Historical archive|selfref=yes}}
{{redirect|WP:AATP|the project page with the [[WP:ATP]] shortcut|Wikipedia:Attack page}}
{{for|plain and simple automated archiving of talk pages|Help:Archiving (plain and simple)}}
{{pp-vandalism|small=yes}}
{{Pp-move-indef}}
{{nutshell|This page explains how and why to set up archiving and archive search boxes on Wikipedia, offering multiple options and assessments of those options; for plain and simple instructions, see [[Help:Archiving for dummies]].}}
{{Wikipedia how to|H:ARC|WP:ARCHIVE|WP:AATP}}
{{nutshell|This page explains how and why to set up archiving and archive search boxes on Wikipedia, offering multiple options and assessments of those options; for plain and simple instructions, see [[Help:Archiving for dummies]].|}}
 
It is customary to periodically '''archive old discussions on a talk page''' when that page becomes too large. Bulky [[Help:Using talk pages|talk pages]] may be hard to navigate, contain obsolete discussion, or become a burden for users with slow Internet connections or computers. Notices are placed at the beginning of the talk page to inform all editors of an archive.
 
Regular articles are not archived because previous versions may be seen in the [[Help:Page history|page history]]; the practice of archiving is peculiarunique to talk pages and noticeboards, which often swell to great length.

Archiving one's own user talk page is optional; some users simply [[WP:BLANKING|blank the page]], as the history is kept available for future reference, but this is not considered the best practice (as it makes things more difficult to find and link). ForRemoval thisof specificcontent case,from theyour useuser oftalk “permalinks”page, cansuch provideas anwarnings easyposted wayby toothers, displayis anconsidered archivedevidence viewyou ofhave aseen talkthe pagecontent; atthis ais given moment,true thoughwhether there's no controlthe onremoval threadwas organizationmanual or presentationautomatic.
 
The [[Wikipedia:Talk page guidelines#When to archive pages|talk page guidelines]] suggest archiving when the talk page exceeds 75 KB (or 75,000 bytes), or has multiple resolved or stale discussions. However, when to archive, and what may be the optimal length for a talk page, are subjective decisions that should be adapted to each case. For example, ongoing discussions and nearby sections they reference should generally be kept intact.
Line 33 ⟶ 36:
:<code><nowiki>Special:PrefixIndex/</nowiki>''Talk:Pagename''</code>
For example
:<code>{{search link|[[Special:PrefixIndex/Help talk:Archiving a talk page}}]]</code> will display the talk page to this help page and all its archives.
 
== Manual archiving ==
Line 43 ⟶ 46:
# Delete copied material from main talk page with edit summary mentioning the name of the new archive.
# If an archive box doesn't already exist on the main talk page, add the line {{Tlx|Archives}} below the WikiProject tags and publish. (This will not be necessary if the main talk page already contains the line {{Tlx|Talk header}}, since this template automatically contains a list of archives if they are [[#Automated archiving|named in the standard way]].)
# If there is already an archive box on the relevant talk page, you may want to add to it the link to the new archive.
 
For a more detailed set of instructions, see [[/Manual archiving]].
 
=== {{anchor|Semi-automated cut and past procedure}}Semi-automated cut and paste procedure ===
[[User:Technical 13/ScriptsEvad37/OneClickArchiver|OneClickArchiver]] and [[User:Σ/Testing facility/Archiver|Archy McArchface]] are userscripts designed to simplify the above manual procedure. Instead of manually copying and pasting the text, these scripts allow you to simply check which sections you wish to archive and specify a page to archive the selected sections to. [[:User:Alexis Jazz/Factotum|Factotum]] is not a dedicated archiver script but can [[:User:Alexis Jazz/Factotum#Move a section to another page?|move a section to another specified page]], which can be a talk page archive.
 
=== Other manual procedures ===
Line 55 ⟶ 59:
 
== Automated archiving ==
{{for|plain and simple automated archiving|Help:Archiving (plain and simple)}}
{{shortcut|WP:AUTOARCHIVE}}
[[User:ClueBot III|ClueBot III]] and [[User:lowercase sigmabot III|lowercase sigmabot III]] can automatically create archives for any discussion page (one that has "talk" in the namespace), by moving sections to a subpage when the section has received no comments for a specified period of time. Both bots can archive sections into simple sequentially numbered archives (e.g. <code>YourPage/Archive&nbsp;1</code>, <code>YourPage/Archive&nbsp;2</code>, ...), or archive according to date (e.g. <code>YourPage/Archives/2013/June</code>, <code>YourPage/Archives/2013/July</code>, ...).
 
See the '''[[User:ClueBot III|ClueBot III page]]''' and the '''[[User:lowercase sigmabot III/Archive HowTo|lowercase sigmabot III page]]''' for detailed instructions on setting up these bots. Those pages explain each of the parameters used, such as <code>archiveheader</code>, <code>minthreadsleft</code>, etc. The examples below are also available for use. All of the examples here are intended for you to be able to copy them while viewing this page and paste them into the edit box on your target page without ''requiring'' any modification to have a working configuration.
 
'''Note:''' Make sure to establish consensus before setting up ClueBot III or lowercase sigmabot III on a talk page other than your user talk page.
 
=== Choosing a bot ===
Line 71 ⟶ 74:
|-
! style=text-align:left; | Number of talk pages in use on
| [https://templatecount.toolforge.org/index.php?lang=en&namespace=2&name=MiszaBot%2Fconfig 30~37,000]
| [https://templatecount.toolforge.org/index.php?lang=en&namespace=2&name=ClueBot+III%2FArchiveThis 9~10,000600]
|-
! style=text-align:left; | Index of archives?
Line 92 ⟶ 95:
 
The following are example configurations to set up automatic archiving of an article talk page or user talk page. These configuration templates do not produce any visible output, so you should generally also include [[#For talk pages|a template]] such as {{tlx|Archives}} to provide readers with links to search and navigate the archives. These templates may also be configured with the parameters <code>bot</code> and <code>age</code> to include a message notifying readers that automatic archiving is taking place. For example: {{tlc|Archives|age{{=}}90|bot{{=}}[[User:ClueBot III#How to archive your page|ClueBot III]]}}.
 
=== SequentiallyExample with sequentially numbered archives ===
 
{| class="wikitable"
Line 98 ⟶ 102:
! colspan="2" | Sequentially numbered archives
|-
! [[User:lowercaseLowercase sigmabot III/Archive HowTo|lowercaseLowercase sigmabot III]] !! [[User:ClueBot III#How to archive your page|ClueBot III]]
|- style="vertical-align:top;"
| <!-- This is intended to be able to be copied while you are viewing the page, not while editing. --><presyntaxhighlight lang="wikitext">
<nowiki>{{User:MiszaBot/config
| algo=old(90d)
| archive={{SUBST:#titleparts:{{SUBST:FULLPAGENAME}}}}/Archive %(counter)d
| counter=1
| maxarchivesize=75K
Line 109 ⟶ 113:
| minthreadsleft=5
| minthreadstoarchive=2
}}</nowiki></presyntaxhighlight>
|| <!-- This is intended to be able to be copied while you are viewing the page, not while editing. --><presyntaxhighlight lang="wikitext">
<nowiki>{{User:ClueBot III/ArchiveThis
| age=2160
| archiveprefix={{SUBST:#titleparts:{{SUBST:FULLPAGENAME}}}}/Archive
| numberstart=1
| maxarchsize=75000
Line 120 ⟶ 124:
| minarchthreads=2
| format= %%i
}}</nowikisyntaxhighlight>
</pre>
|}
 
Both of the above examples will create archive pages, as needed, starting with <code>''TalkPage''/Archive&nbsp;1</code> and continuing with <code>''TalkPage''/Archive&nbsp;2</code>, etc., when the current archive page grows to more than 75,000 bytes. Only sections with dates that are older than 90 days (2,160 hours) will be archived, although the five sections with the most recent contributions will be retained on the talk page no matter how long ago the last contribution was added. If archives for the page already exist, then set the counter/numberstart parameter to the next archive number in the series.
 
{{anchor|FULLPAGENAME}}Warning: the systemmagic variableword '''<nowiki>{{SUBST:FULLPAGENAME}}</nowiki>''' is replaced by the talk page name when the template is saved to a talk page. However some punctuation characters that can appear in a page name (<code>"&'</code>) are replaced by HTML character codes that are not recognised by the bots (see [[:mediawikiwiki:Manual:PAGENAMEE encoding#PAGENAME]] for details about these and other characters). For example <code>'</code> is replaced with <code>&#39&#59;</code> (so if the bot is to work then <code>&#39&#59;</code> must be replaced with <code>'</code>). This can be circumvented by using <code><nowiki>{{SUBST:#titleparts:{{SUBST:FULLPAGENAME}}}}</nowiki></code> to automatically sort the encoding.
 
=== ArchivesExample with archives by year/ and month ===
{| class="wikitable"
|-
Line 140 ⟶ 143:
Note:Each time ClueBot III runs it places threads in a ''single'' archive which is the YYYY/Month of (NOW - age). If you are starting archiving with a backlog this will result in a ''single file'' with all of your old threads older than <code>age</code>. ClueBot III does not appear to run every single day. Thus, even when archiving has been running for a while, some threads may end up in an archive that is one month later than when they were last edited.<br />
|- style="vertical-align:top;"
| <!-- This is intended to be able to be copied while you are viewing the page, not while editing. --><presyntaxhighlight lang="wikitext">
<nowiki>{{User:MiszaBot/config
| algo=old(90d)
| archive={{SUBST:#titleparts:{{SUBST:FULLPAGENAME}}}}/Archives/%(year)d/%(monthname)s
| minthreadsleft=4
| minthreadstoarchive=2
}}</nowiki></presyntaxhighlight>
|| <!-- This is intended to be able to be copied while you are viewing the page, not while editing. --><presyntaxhighlight lang="wikitext">
<nowiki>{{User:ClueBot III/ArchiveThis
| age=2160
| archiveprefix={{SUBST:#titleparts:{{SUBST:FULLPAGENAME}}}}/Archives/
| minkeepthreads=4
| minarchthreads=2
| format=Y/F
}}</nowikisyntaxhighlight>
</pre>
|-
| colspan="2" |Both of the above examples will create archive pages, as needed, with names similar to <code>YourPage/Archives/June</code>, <code>YourPage/Archives/July</code>, etc. Only sections with dates that are older than 90 days (2,160 hours) will be archived in these examples.
|-
|colspan="2"|see the Warning above for the system variable [[#FULLPAGENAME|FULLPAGENAME]]
|}
 
Line 196:
{{clear}}
;Example 2
{{Archives|*[[Help_talk:Archiving_a_talk_page/Archive_1|2003-20062003–2006]]
*[[Help_talk:Archiving_a_talk_page/Archive_2|2006-20072006–2007]]
*[[Help_talk:Archiving_a_talk_page/Archive_3|2007-20092007–2009]]
*[[Help_talk:Archiving_a_talk_page/Archive_4|2008-20142008–2014]]
*[[Help_talk:Archiving_a_talk_page/Archive_5|2014-20192014–2019]]}}
For a box with a manual archive list and a search bar {{tlp|Archives|''List of archives''}} can be used. For the box to the right the code is:
<br><codesyntaxhighlight lang="wikitext">{{tlp|Archives|<br>
<nowiki>*[[Help_talk:Archiving_a_talk_page/Archive_1|2003-20062003–2006]]</nowiki> <br>
<nowiki>*[[Help_talk:Archiving_a_talk_page/Archive_2|2006-20072006–2007]]</nowiki> <br>
<nowiki>*[[Help_talk:Archiving_a_talk_page/Archive_3|2007-20092007–2009]]</nowiki> <br>
<nowiki>*[[Help_talk:Archiving_a_talk_page/Archive_4|2008-20142008–2014]]</nowiki> <br>
<nowiki>*[[Help_talk:Archiving_a_talk_page/Archive_5|2014-20192014–2019]]</nowiki>}}</codesyntaxhighlight>
{{clear}}
;Example 3
{{Archives|auto=long|'''Archive box archives''':<br>[[Template talk:Archive box/Archive 1|Archive 1]], [[Template talk:Archive box/Archive 1|Archive 1]]|root=Template talk:Archives}}
For a box with both an automatic and manual list {{tlp|Archives|auto=long|''List of archives''}} can be used. The example below for [[Template talk:Archives]] where the archives for the old {{tl|archive box}} template are shown use the following code:
<code><nowikisyntaxhighlight lang="wikitext" inline>{{Archives|auto=long|'''Archive box archives''':<br>[[Template talk:Archive box/Archive 1|Archive 1]], [[Template talk:Archive box/Archive 1|Archive 1]]}}</nowiki></codesyntaxhighlight>
{{clear}}
;Example 4
Line 230:
}}
This template just demonstrate a lot of the parameters. Most of them are quite self explanatory. <br>
<code><nowikisyntaxhighlight lang="wikitext">{{archives
| auto = short
| search = no
Line 243:
| age = 1
| units = year
}}</nowiki></codesyntaxhighlight>
{{clear}}
 
Line 252:
{| border="0"
|-
| width="300400" |<pre><nowikisyntaxhighlight lang="wikitext">{{Archive box |search=yes |collapsible=yes |
bot=ClueBot III |age=90 |</nowiki>
<nowiki>title=[[Help:Archiving a talk page|Archives]]<!--</nowiki>
<nowiki>--> ([[{{#titleparts:{{TALKPAGENAME}}|1}}/Archive index|index]])| </nowiki>
<nowiki>{{Nowrap|'''2004''': {{Archives by months|2004}}}}</nowiki>
<nowiki>{{Nowrap|'''2005''': {{Archives by months|2005}}}}</nowiki>
<nowiki>{{Nowrap|'''2006''': {{Archives by months|2006}}}}</nowiki>
<nowiki>{{Nowrap|'''2007''': {{Archives by months|2007}}}}</nowiki>
<nowiki>{{Nowrap|'''2008''': {{Archives by months|2008}}}}</nowiki>
<nowiki>{{Nowrap|'''2009''': {{Archives by months|2009}}}}</nowiki>
<nowiki>{{Nowrap|'''2010''': {{Archives by months|2010}}}}</nowiki>
<nowiki>{{Nowrap|'''2011''': {{Archives by months|2011}}}}</nowiki>
<nowiki>{{Nowrap|'''2012''': {{Archives by months|2012}}}}</nowiki>
<nowiki>{{Nowrap|'''2013''': {{Archives by months|2013}}}}</nowiki>
<nowiki>{{Nowrap|'''2014''': {{Archives by months|2014}}}}</nowiki>
<nowiki>{{Nowrap|'''2015''': {{Archives by months|2015}}}}</nowiki>
<nowiki>'''2016''': {{Archives by months|2016}}</nowiki>
}}</syntaxhighlight>
<nowiki>}}</nowiki> </pre>
| style="vertical-align:top;" | {{Archive box |search=yes |title=[[Help:Archiving a talk page|Archives]]<!--
--> ([[{{#titleparts:{{TALKPAGENAME}}|1}}/Archive index|index]]) |collapsible=yes |bot=ClueBot III |age=90
Line 298:
==== Archive link banner ====
 
Instead of putting the archive links in a box that floats to the right or left, some prefer the links in a banner like {{tl|Talk header}}. Yearly and alphabetic archives are automatically detected in addition to regular sequential archives. A search box is by default included and if the page is archived by bots an auto archiving notice can be included by specifying {{para|archive_age}} in days.
 
'''{{tl|Talk header}}''' and '''{{tl|Auto archiving notice}}'''
 
<nowiki>{{Talk header}}</nowiki>
{{Talk header}}
 
'''The archive links show up in a row at the bottom of the above banner.''' ToFor seea examplesreal goworld toexample see '''[[SpecialTalk:WhatLinksHere/Template:talkheaderProxima Centauri]].'''
 
==== Archive notice banner ====
 
<nowiki>{{Auto archiving notice|bot=ClueBot III|age=14}}</nowiki>
{{Auto archiving notice|bot=ClueBot III|age=14}}
<nowiki>{{Auto archiving notice|bot=Lowercase sigmabot III|age=14}}</nowiki>
{{Auto archiving notice|bot=Lowercase sigmabot III|age=14}}
 
"Age" is in days. For notice examples; see: '''[[Special:WhatLinksHere/Template:Auto archiving notice]].'''
 
== Archive indexing ==
{{Notice|[[User:Legobot|Legobot]]'s archive indexing task is currently not functioning on a regular basis and has not been for quite some time. It is unclear when, or if, this bot will be functioning.}}
Having an archive index makes finding old discussions on a given topic easier, particularly in pages with many archives, or when the archives are of considerable size. An archive index, when one exists, is typically stored on the page <code>Talk:YourPage/Archive index</code>. While it is possible to generate an index by hand, the <code>/Archive index</code> page is normally generated automatically. There are two bots which automatically create indexes: [[User:Legobot|Legobot]] and [[User:ClueBot III|ClueBot III]].
 
Line 328 ⟶ 316:
! Numbered archives !! Archives/Year/Month
|- valign="top" <!-- This is intended to be able to be copied while you are viewing the page, not while editing. -->
| <pre><nowikisyntaxhighlight lang="wikitext">{{User:HBC Archive Indexerbot/OptIn
|target=/Archive index
|mask=/Archive <#>
|leading_zeros=0
|indexhere=yes
}}</nowiki></presyntaxhighlight><!-- This is intended to be able to be copied while you are viewing the page, not while editing. -->
|| <pre><nowikisyntaxhighlight lang="wikitext">{{User:HBC Archive Indexerbot/OptIn
|target=/Archive index
|mask=/Archives/<year>/<month>
|indexhere=yes
}}</nowiki></presyntaxhighlight>
|}
 
[[User:ClueBot III|ClueBot III]] automatically creates an archive index when archiving. ClueBot III stores the archive indexes it creates on unique pages in its user space. The archive index for the page you are archiving can be [[WP:TRANS|transcluded]] onto your <code>Talk:YourPage/Archive index</code> page by putting the following text in that page:<br />
<code><nowiki>{{User:ClueBot III/Master Detailed Indices/{{NAMESPACE}}: {{BASEPAGENAME}}}}</nowiki></code><!-- This is intended to be able to be copied while you are viewing the page, not while editing. -->
 
== Archive searching ==
Line 350 ⟶ 338:
 
== Continuing discussions ==
If a thread has been archived prematurely, such as when it is still relevant to current work or was not concluded, unarchive it by copying it back to the talk page from the archive, and deleting it from the archive. Do not unarchive a thread that was effectively closed; instead, start a new discussion and link to the archived prior discussion.
It is difficult to say exactly when a discussion "ends" and when it is continuing. Given that archived discussions are immutable, archiving a discussion effectively ends that particular discussion. When reopening a discussion is desired, links to archived discussions can be provided in the new discussion thread.
 
== Example pages ==
Line 359 ⟶ 347:
 
== See also ==
* [[Help:Archiving for(plain dummiesand simple)]]
*[[Help:Using talk pages]]
* [[Wikipedia:Closing discussions]]
* [[Wikipedia:Refactoring talk pages]]
* [[Module:Archive list]] is the, [[Wikipedia:Lua|Lua]] code that drives Archive templates
* Pages that need archiving
** [[Wikipedia:Database reports/Long pages|Database report of long pages]], contains a list of long talk pages.
** [[:Category:Archive requests|Category Archive requests]] is populated by the {{Tl|Archiveme}} template.