Template:AthResult/doc

The AthResult template is for usage on athletics and track and field athlete biographies. It must be used in conjunction with the AchievementTable template to work properly.

AthResult is a semi-automated, non-intrusive method of quickly inserting a particular athlete's performance at a major competition. It must always be substituted to allow for easy future reading and editing, and to reduce template recall overheads.

Usage

 * See Template:AchievementTable for basic usage of that template

The basic usage of the template is as follows: YEAR

The information appears in the template in roughly the same order as it appears when placed on a page. Once the substituted template is saved on to a page, the resulting entry will automatically become plain text, matching entries done in the usual manual style.

Year

 * The first parameter is the year of the competition you want to add (e.g. 2012).

Competition

 * The second parameter denotes the competition. There are limited number of specific codes which correspond to the competitions which may be added:


 * Games
 * OG = Summer Olympics
 * UNI= Athletics at the Summer Universiade
 * MWG= Track and field at the Military World Games
 * AG= Athletics at the Asian Games
 * AIG= Indoor athletics at the Asian Indoor Games
 * AAG= Athletics at the All-Africa Games
 * PAG= Athletics at the Pan American Games
 * ARA= Athletics at the Pan Arab Games
 * CWG= Athletics at the Commonwealth Games
 * CACG= Athletics at the Central American and Caribbean Games
 * EAG= Athletics at the East Asian Games
 * SAG=Athletics at the South Asian Games
 * SEAG=Athletics at the Southeast Asian Games
 * LUG=Athletics at the Lusophony Games
 * GWG=Athletics at the Goodwill Games
 * JF=Athletics at the Jeux de la Francophonie
 * MG=Athletics at the Mediterranean Games
 * BG=Athletics at the Bolivarian Games
 * CAG=Athletics at the Central American Games
 * SAMG=Athletics at the South American Games
 * PACG=Athletics at the Pacific Games
 * PACMG=Athletics at the Pacific Mini Games
 * SPG=Athletics at the Pacific Games
 * SPMG=Athletics at the South Pacific Mini Games
 * MICG=Athletics at the Micronesian Games
 * ALBA=Athletics at the ALBA Games
 * Track and field championships
 * Track and field championships


 * WC= World Athletics Championships
 * WIC= World Athletics Indoor Championships
 * AFC=African Championships in Athletics
 * ASC=Asian Athletics Championships
 * AIC=Asian Indoor Athletics Championships
 * CACC=CAC Championships
 * EC=European Athletics Championships
 * EIC=European Athletics Indoor Championships
 * ETC=European Team Championships
 * SAC=South American Championships in Athletics
 * CAMC=Central American Championships
 * OAC=Oceania Championships
 * IBC=Ibero-American Championships in Athletics


 * Road and XC championships
 * WXC= World Athletics Cross Country Championships
 * AFXC=African Cross Country Championships
 * ASXC=Asian Cross Country Championships
 * EXC=European Cross Country Championships
 * WRW= World Athletics Race Walking Team Championships
 * ERW=European Race Walking Cup
 * PARW=Pan American Race Walking Cup
 * SAXC=South American Cross Country Championships
 * SARW=South American Race Walking Cup
 * WHM= World Half Marathon Championships


 * Age category
 * WJC= World Junior Championships in Athletics
 * WYC= World Youth Championships in Athletics
 * AFJC=African Junior Athletics Championships
 * ASJC=Asian Junior Athletics Championships
 * CAR=CARIFTA Games
 * CARJ=CARIFTA Games (U-20)
 * CARY=CARIFTA Games (U-17)
 * CACJC=CAC Junior Championships (U-20)
 * CACYC=CAC Junior Championships (U-17)
 * EU23= European Athletics U23 Championships
 * EJC= European Athletics Junior Championships
 * NAU23= NACAC Under-23 Championships in Athletics
 * PAJC= Pan American Junior Athletics Championships
 * SAU23=South American Under-23 Championships in Athletics
 * SAJC= South American Junior Championships in Athletics
 * SAYC= South American Youth Championships in Athletics
 * OAJC= Oceania Junior Championships
 * OAYC= Oceania Youth Championships
 * WMAO= World Masters Outdoor Athletics Championships
 * WMAI= World Masters Indoor Athletics Championships

Location
The third parameter denotes the location of the competition. Typical usage is to link the host city followed by its country unlinked (e.g. Berlin, Germany ).

Result
The fourth parameter corresponds to the finishing position of the athlete at that event (e.g. 1st, 2nd, 9th). Medal colours are automatically added. Qualifying statements may also be added if desired, for example, "20th (heats)".

Gender
The fifth parameter denotes the gender of the competition in which the athlete is competing: either Men or Women. This parameter is used to generate links to event result articles when they are present.

Event
The sixth parameter denotes the specific athletic event in which the athlete is competing (e.g. 100 metres, shot put, decathlon, marathon). This should not be linked.

Example
The code listed below will produce the following table. The first entry demonstrates how to insert notes alongside the template. The Olympic and European entries demonstrate how event result articles are automatically linked. The Asian Games entry links to the larger "Athletics Results" page.

Fixing rowspan issues
If several entries refer to the same year then the rowspan parameter can be used. If omitted this defaults to 1 and will enter the year for a single line as normal. For example, the following code produces the following result:

Known issues

 * Where a table has both "Event" and "Notes" columns, notes can be manually added by placing them after a vertical bar "|" on the line below the AthResult code.


 * For athletes who compete in just one event specifically (high jumpers for instance), this template will still generate the event name for each and every entry.