AwardAnnals:Annal page
From AwardAnnals
Overview
An annal uses an {{annalentry:}} (AE) to document the result of an award event, which is the means for providing the honors list that appears in every honor roll listing and on the creative work (CW) page. An annal is the heart of the Award Annals, consequently it has its own namespace. Editing an annal is restricted to Award Annals administrators because the AE on a page in the Annal namespace is inserted into the AE database, causing a ripple of page updates.
If adding a new annal, do not forget to edit the annal navigator for the previous year so that the navigator provides continuous linking.
Naming Convention
Use the award organization page name with these modifications:
- Prepend the year of award.
- Append the award category.
The proper name for an award is comprised of the award organization plus award category and should be capitalized.
If you are an Award Annals administrator, the page may be prepended with “Annal:” so that the database insertions take place. If you do not have these privileges, create the page anyway. Especially in the case of adding a new award to the site, administrators may not want to induct the pages until the CWs, AEs, and award organization pages have been reviewed. Once deemed acceptable, it is merely a matter of moving the page to the “Annal” namespace. It should be noted that being an official Annal is not necessary. It is acceptable to create all of the pages for ”Goober’s Homemade Award”, which will look just like an official Annal. The only difference will be that winning a Goober will not garner any honor points, and it will not be listed in the honors list. If a number of unofficial awards is added to the site, I will provide some facility for seeing a complete list of honors for each CW so that the unofficial awards will be linked to from CW listings.
Format
This example is taken from Annal:2001 Hugo Award for Novel.
Results of the [[Hugo Award]] in the year [[:Category:2001]]. For a [[AwardAnnals:Ranking|ranked]] list of books, try an honor roll:
*[[Honor roll:Hugo Award for Novel|Hugo Award for Novel]]
*[[Honor roll:Speculative Fiction books|Speculative Fiction books]]
*[[Honor roll:Speculative Fiction authors|Speculative Fiction authors]].
{{annalentry:set terms
| year=2001
| prevannal = 2000
| nextannal = 2002
| annalcategory = Hugo Award for Novel
| awardpage = [[Hugo Award]]
| award=Hugo-Novel
| 1=winner
| 2=
| 3=nominee
| 4=
| default=3
| set recipients
| winner = Harry Potter and the Goblet of Fire: Book 4 of Harry Potter
| Midnight Robber
| The Sky Road
| Calculating God
| A Storm of Swords
}}
Introductory information
The page should start with a simple identification of the annal containing:
- Name and link to the award organization
- Year linked to the year’s category
- Links to relevant or related honor rolls
Additional information about the award ceremony and anomalies is welcome, so long as it is brief. For instance, it should be noted if there are was a tie, or if no winner was named, or if no award was given for this year. If the ceremony differs from year to year, a short paragraph about this particular year is in order; otherwise, put such information on the award organization page.
Annal entry construct
For detailed information on this construct, see AwardAnnals:annalentry. It's purpose here is to identify the finalists and winner of this award. The number of arguments is unlimited, and the state of the entry changes with each argument. The arguments should appear in this order:
- set terms should be the first argument. This tells the parser that the following arguments will describe the award and the terms applied to the CWs. These terms determine the words in the honors list, and should be manipulated to produce the desired result.†
- year is obvious.
- prevannal identifies the previous year’s annal to produce a link in the annal navigator. The digits previous year is usually enough. If the award organization changes the name of the award, a full link will be accepted.
- nextannal identifies the next year’s annal. Leave blank if there is none.
- annalcategory is the name of the wiki category for this specific award. It is usually the name of the annal page without the year (e.g. “Hugo Award for Novel”). If the award organization changes the name of the award or the category, keep using the old annalcategory to preserve continuity.
- awardpage is the page title of the award organization’s page (e.g., Hugo Award). This creates a link in the annal navigator, and includes the annal in a category named for the award organization (e.g., Category:Hugo Award annals).
- award is the term used to identify this award in the honors list you see on each CW listing. It should be a very short and descriptive. For instance:
“Hugo–novel” (Hugo Award for Novel)
“NBA–nonfiction” (National Book Award for Nonfiction)
“NBA–nonfiction” (National Book Award for Nonfiction)
“Oscar–Picture” (Academy Award® for Best Motion Picture) - 1 is the term used to describe the CW that wins. It is usually “winner”, but may be “1st” or “Palme d’Or”, or whatever the award organization calls the winner. Also list the other places. The finalists are always “3” so that scoring is equal with awards that sometimes issue special recognition for the runner-up.
- default is the place of a CW that does not explicitly specify a place. In the example format above, notice that Harry Potter is specified as the winner, and the place of the others is not specified. They default to “3”, which is “nominee”
- set recipients tells the parser that the following arguments will identify CWs.
- creative works are listed here ordered by place (winner first) and then by title. Use the “place” term specified in the arguments above to identify the proper score for each work. List the title of the CW's page rather than the proper title of the CW: notice that the winner’s page (Harry Potter and the Goblet of Fire: Book 4 of Harry Potter) includes the subtitle to differentiate it from the film. The name of the work shown in the AE listing will be the proper title identified in {{definework:}}. See AwardAnnals:Creative work page for details on CW title and CW page title.
The annalentry uses {{displayworks:}} to display a listing for every work named. If used in the “Annal:” namespace, it modify the honors list and score to include this event. The winner’s listing will display a blue ribbon on this page.
†An honors list is generated like this: “{$year} {$award} {$place}”. Manipulation of this process was necessary for the Dagger Award because the place should come before the award: the winner is “2000 Gold Dagger”, and second place is “2000 Silver Dagger”. This was accomplished by leaving award blank:
{{annalentry:set terms
| year=2000
| award=
| 1=Gold Dagger
| 2=Silver Dagger
| 3=Dagger shortlist
…
Categories
Annals are automatically included in three categories. The first is named simply for the year (e.g., Category:2001). The second is named for the award organization (e.g., Category:Hugo Award annals). The third is named for the award/category (e.g., Category:Hugo Award for Novel). This provides a listing of all the annals available for an award/category, which may be quicker than the annal navigator if you are looking for a particular year. Follow the pipe with the name of the page without the namespace (not strictly necessary, but what the heck).
