Difference between revisions of "Module:British regnal year/doc"

From blackwiki
Jump to navigation Jump to search
blackwiki>Mr. Stradivarius
(create)
 
blackwiki>Mr. Stradivarius
(expand)
Line 1: Line 1:
 
{{module rating|protected}}
 
{{module rating|protected}}
  
This module implements the {{tl|British regnal year}} template. It converts a year in the Gregorian calendar into a British [[regnal year]]. Please see the template page for documentation.
+
This module implements the {{tl|British regnal year}} template. It converts a year in the Gregorian calendar into a British [[regnal year]].
 +
 
 +
=== Syntax ===
 +
<nowiki>{{</nowiki><code>#invoke:British regnal year|main|</code><span style="color:gray;">''<year in Gregorian calendar>''</span><code><nowiki>}}</nowiki></code>
 +
 
 +
=== Example ===
 +
<nowiki>{{</nowiki><code>British regnal year|1952</code><nowiki>}}</nowiki> → {{British regnal year|1952}}
 +
 
 +
=== How it works ===
 +
 
 +
The data for the module is stored in a table at [[Module:British regnal year/data]]. The module looks through the data list from newest to oldest, and returns the data for the first result where the input year is greater than or equal to the <code>year</code> value. It calculates the regnal year based on the input year, the value of <code>year</code>, and the value of <code>startYear</code>. For most years it calculates the previous regnal year by subtracting one from the input year, but if the input year is equal to the value of <code>year</code>, the module uses the <code>prevEndYear</code> value and gets the link from <code>linkPrev</code> instead. A note can be added at the end of any entry by using the <code>note</code> field.
 +
 
 +
=== Data fields ===
 +
 
 +
The data table entries are organised as follows:
 +
* <code>year</code> - the year that the template searches for when deciding what links to display. In most cases this is the year that the monarch's reign began, although it can be different if the history is complicated.
 +
* <code>linkCurrent</code> - a wikilink to the current monarch's Wikipedia article.
 +
* <code>startYear</code> - the regnal year of the <code>year</code> value for the current monarch. If this is the monarch's first year on the throne, this is <code>1</code>; if it is their second year, this is <code>2</code>, and so on.
 +
* <code>linkPrev</code> - a wikilink to the Wikipedia article of the previous monarch.
 +
* <code>prevEndYear</code> - the regnal year of the <code>year</code> value for the previous monarch.
 +
* <code>note</code> - a short note about the years for this time period. This is displayed after the other content.
 +
 
 +
=== See also ===
 +
 
 +
* {{tl|year in other calendars}}

Revision as of 18:06, 19 August 2013

This module implements the {{British regnal year}} template. It converts a year in the Gregorian calendar into a British regnal year.

Syntax

{{#invoke:British regnal year|main|<year in Gregorian calendar>}}

Example

{{British regnal year|1952}} → 16 Geo. 6 – 1 Eliz. 2

How it works

The data for the module is stored in a table at Module:British regnal year/data. The module looks through the data list from newest to oldest, and returns the data for the first result where the input year is greater than or equal to the year value. It calculates the regnal year based on the input year, the value of year, and the value of startYear. For most years it calculates the previous regnal year by subtracting one from the input year, but if the input year is equal to the value of year, the module uses the prevEndYear value and gets the link from linkPrev instead. A note can be added at the end of any entry by using the note field.

Data fields

The data table entries are organised as follows:

  • year - the year that the template searches for when deciding what links to display. In most cases this is the year that the monarch's reign began, although it can be different if the history is complicated.
  • linkCurrent - a wikilink to the current monarch's Wikipedia article.
  • startYear - the regnal year of the year value for the current monarch. If this is the monarch's first year on the throne, this is 1; if it is their second year, this is 2, and so on.
  • linkPrev - a wikilink to the Wikipedia article of the previous monarch.
  • prevEndYear - the regnal year of the year value for the previous monarch.
  • note - a short note about the years for this time period. This is displayed after the other content.

See also