Wonani kulemba kwambula kuona kwa User:HBC Archive Indexerbot

{{retired|bot=yes}}
{{Notice|HBC Archive Indexerbot has been replaced but '''these instructions are still correct.''' <br/> The archive indexing function is being performed by [[User:Legobot|Legobot]].}}
<noinclude>
{|align=left
 |__TOC__
 |}
{{bot|Krellis|status=inactive}}
{{Emergency-bot-shutoff}}
'''This bot is [[Wikipedia:Bots/Requests for approval/HBC Archive Indexerbot|approved]]. [[User:HighInBC|HighInBC]]<small> <sup>(Need help? [[User_talk:HighInBC|Ask me]])</sup></small> 00:48, 9 December 2006 (UTC)

==Introduction==
I am an automated bot coded and operated by [[User:HighInBC|HighInBC]] and [[User:Krellis|Krellis]].  I can read through piles of talk page archives and produce a handy index of topics with links.  This will allow you to browse or search the entire archive for keywords or recurring discussions.  Anyone can request that I service any page on the English Wikipedia, simply follow the easy instructions below!

==Instructions==
</noinclude>
To use this service you need archives, a destination page, and a page for the request.

# First create a destination page (the one you want the index to be written to, typically ending in <code><nowiki>/Archive index</nowiki></code>) and place the following text on this page: <code><nowiki><!-- Legobot can blank this --></nowiki></code>
#: This will not be visible, as it is contained in HTML comment tags; this gives the bot permission to write to the page.  '''You MUST create this page and place the tag on it, the bot WILL NOT create it for you automatically!'''
# On the root page of the archives you want indexed, usually the talk page itself, place the following code, replacing the items in <code><nowiki><></nowiki></code> with the appropriate values as described below: <code><nowiki>{{User:HBC Archive Indexerbot/OptIn|target=<target>|mask=<mask>|leading_zeros=<zeros>|indexhere=<indexhere>|template=<template location>}}</nowiki></code>
## <code><target></code> is your destination page (created in step 1). Note that this must be the full page name, including the namespace. A relative path may be specified, and will be assumed to be relative to the page on which the OptIn code is placed.  If you are unsure, full paths are always best.
## <code><mask></code> is used to describe how to find your archives, see [[#Mask|below]] for details. You may specify multiple masks by specifying <code>mask1=<mask></code>, <code>mask2=<mask></code>, <code>mask3=<mask></code>... Pages matching all of the masks will be combined together for the final index. Again, the mask must be the full page name, or a relative path such as <code>/Archive <#></code>.
## <code><zeros></code> is the number of leading 0s in your archive title, "Archive 01" would be 1 leading zero, "Archive 1" is 0 leading zeros.
## <code><indexhere></code> should be '''yes''' or '''no'''. If yes, it will index the root talk page the request is on as well as the archive pages.
## <code><template location></code> is the name of a wiki page containing an archive index template.  The template syntax is described [[#Template|below]].  This parameter is optional, and if left out or left blank, the [[User:HBC Archive Indexerbot/default template|default template]] will be applied.
# Wait; the next time the bot runs it should write your report.

===Mask===
Your mask is simply the path of your archives with the numbers replaced with <code><#></code>.

Example:

<code>User talk:HighInBC/Archive <#></code> would cover <code>User talk:HighInBC/Archive 1</code> through the last archive.

If your archive has leading zeros, then set the '''leading_zeros''' parameter to the number of leading zeros you have.

If your archives are named using dates rather than numbers, or by topic, you can specify multiple mask parameters in the template, each of which will be read in turn.  If there's no incrementing number, simply do not include the <code><#></code> in the mask, and it will be used as an individual page name instead.

===Template===
Templates are defined as a series of HTML comments followed by wikitext for each part of the page.  See the [[User:HBC Archive Indexerbot/default template|default template]] for an example template definition.  Each section is introduced with an HTML comment consisting of only the section name.  All content from the next line until the next section heading is considered to be part of the section.  Blank lines inside sections are ignored.  The possible sections of a template are:

{| class="wikitable"
! Section Name !! Description
|-
| LEAD || Introductory text, to be placed at the top of the archive index page.
|-
| HEADER || A header for the index, placed after the bot's description of how the index was created, but before any rows of data are output.  Typically used to begin a table, create column headings, etc.
|-
| ROW || The format of an actual row of data.  There are a number of variables available in the row:
* <code>%%topic%%</code> - The topic from the archives, as pulled from the archive heading.
* <code>%%replies%%</code> - The estimated number of replies contained within that section of the archive.
* <code>%%link%%</code> - A link directly to the appropriate section in the appropriate archive for this topic.
* <code>%%first%%</code> - Timestamp of first comment in the topic (YYYY-MM-DD HH:MM:SS format).  Available in epoch seconds as <code>%%firstepoch%%</code>.
* <code>%%last%%</code> - Timestamp of last comment in the topic (YYYY-MM-DD HH:MM:SS format).  Available in epoch seconds as <code>%%lastepoch%%</code>.
* <code>%%duration%%</code> - Duration of the topic (difference between first and last, in normalized text format).  Available in raw seconds as <code>%%durationsecs%%</code>.

This section is '''required''' (and this is the only section required in a template, all others are optional).
|-
| ALTROW || The format of an alternating row.  If provided, this section will be used instead of the "Row" section for every other row of data, starting with the second.  It is generally used to alternate row colors within a table.  The same variables described in [[#Row|"Row"]] above are available.
|-
| FOOTER || A footer, output immediately after the last row of data.  Generally used to close a table, if one was started in the header.
|-
| TAIL || A final section below the footer, for any comments, bottom-of-page navigation, categories, etc.
|-
| END || Indicates that the template definition is over, no more parsing will take place.
|}

===Example===
For example, when using the HBC Archive Indexerbot (now Legobot) to index the talk discussions on the [[Wikipedia talk:WikiProject Television]] project page, to list on [[Wikipedia talk:WikiProject Television/Archive index]], the following code would be used:

<pre style="overflow:auto;">
{{User:HBC Archive Indexerbot/OptIn |target=Wikipedia talk:WikiProject Television/Archive index |mask=Wikipedia talk:WikiProject Television/Archive <#> |leading_zeros=0 |indexhere=yes }}
</pre>

==Usage==
The index page (<code><target></code>) can be specified as the ''index'' parameter for the {{tl|Archives}} template. This will create a clickable link at the top of the box for accessing the generated index.

==Schedule==
The bot is currently scheduled to run twice per day, at 11:23 and 23:23 UTC.  It may run at additional times beyond those, and may miss some scheduled runs while it is under continued development/bugfixing.

==Caveats==
* Very long sets of archives such as ''Wikipedia:Administrators' noticeboard/IncidentArchive<#>'' will not archive due to timeout errors and maximum page size.
* When using [[Help:Sorting|sortable]] table for results, the <code>%%duration%%</code> will sort alphabetically, which is probably unfavourable behavior. To work around this, use invisible <code>%%durationsec%%</code> variable like this: <code><nowiki><span style="display: none;">%%durationsecs%%</span> %%duration%%</nowiki></code>
<noinclude>
==Links==
* I keep a [[/logs|log file]].
* My [[/source|source code]] is GFDL licensed.
* The [[/default template|default template]] I use for generating reports (although a better design may be found at [[User:Krellis/archive template]])
* Feature requests can be added to [[User talk:HBC Archive Indexerbot/to do|my todo list]]

==Awards==
{| style="border: 1px solid gray; background-color: #fdffe7;"
|rowspan="2" valign="middle" | [[Image:Tireless_Contributor_Barnstar.gif|100px]]
|rowspan="2" |
|style="font-size: x-large; padding: 0; vertical-align: middle; height: 1.1em;" | '''The Tireless Contributor Barnstar'''
|-
|style="vertical-align: middle; border-top: 1px solid gray;" | Let's face it, this bot just keeps on archiving and never gives up. It deserves a pat on the back and a botsnack. [[User:Irbisgreif|Irbisgreif]] ([[User talk:Irbisgreif|talk]]) 02:09, 1 August 2009 (UTC)
|}

==See also==
{{Warchivenav|state=uncollapsed}}
[[Category:Wikipedia bots with Perl source code published]]
[[Category:Wikipedia archive bots|HBC Archive Indexerbot]]
</noinclude>