Difference between revisions of "Template:As of/doc"

From SVR Wiki
Jump to: navigation, search
m (Examples: dewikified link)
(removing deprecated format (all instances converted))
Line 8: Line 8:
  
 
==Syntax==
 
==Syntax==
 +
 +
The template can be used in the following forms:
  
 
:<tt>{&#123;As of{{!}}year{{!}}month{{!}}day&#125;}</tt>
 
:<tt>{&#123;As of{{!}}year{{!}}month{{!}}day&#125;}</tt>
:<tt>{&#123;As of{{!}}month_name year&#125;}</tt> (''deprecated'')
+
:<tt>{&#123;As of{{!}}year{{!}}month&#125;}</tt>
 +
:<tt>{&#123;As of{{!}}year&#125;}</tt>
 +
 
 +
Several additional named parameters can also be used (see below).
  
 
===Parameters===
 
===Parameters===
Line 16: Line 21:
 
'''Required'''
 
'''Required'''
 
*'''year''' (first parameter) – required; must be in full numerical format (''yyyy'')
 
*'''year''' (first parameter) – required; must be in full numerical format (''yyyy'')
*:'''''month_name year''''' (first parameter, ''deprecated'') – required; month_name must be capitalised full name, and year must be in full numerical format (e.g. "April 2006")
 
  
 
'''Optional'''
 
'''Optional'''
Line 22: Line 26:
 
*'''day''' (third parameter) – optional; numerical format only, not included in link
 
*'''day''' (third parameter) – optional; numerical format only, not included in link
  
'''Named optional'''
+
'''Named'''
 
*'''alt''' (named parameter) – optional; allows substitution of visible text output (defaults to "As of [date]") for different wording or use of lower case
 
*'''alt''' (named parameter) – optional; allows substitution of visible text output (defaults to "As of [date]") for different wording or use of lower case
 
*'''df''' (named parameter) – optional; allows use of American date format with value US, only visible to users who have not set their date preferences yet
 
*'''df''' (named parameter) – optional; allows use of American date format with value US, only visible to users who have not set their date preferences yet
Line 34: Line 38:
 
:<tt>{&#123;As of{{!}}2008{{!}}4{{!}}1{{!}}alt=as of the <nowiki>[[2000 United States Census]]</nowiki>&#125;}</tt> returns "''as of the [[2000 United States Census]]''"
 
:<tt>{&#123;As of{{!}}2008{{!}}4{{!}}1{{!}}alt=as of the <nowiki>[[2000 United States Census]]</nowiki>&#125;}</tt> returns "''as of the [[2000 United States Census]]''"
 
:<tt>{&#123;As of{{!}}2008{{!}}7{{!}}5{{!}}df=US&#125;}</tt> returns "''As of {{Start date|2008|7|5}}''"
 
:<tt>{&#123;As of{{!}}2008{{!}}7{{!}}5{{!}}df=US&#125;}</tt> returns "''As of {{Start date|2008|7|5}}''"
 
:<tt>{&#123;As of{{!}}April 2006&#125;}</tt> returns "''As of {{Start date|April 2006}}''"
 
  
 
==See also==
 
==See also==

Revision as of 01:54, 21 July 2008

Template:Template doc page viewed directly

Usage

The template {{As of}} is used to link a section of text to an appropriate "As of..." page without creating a visible link on the page itself. This allows editors to catalogue statements that may become dated over time. It also includes the ISO 8601 format needed by hAtom (class="updated") and hCalendar (class="dtstart") microformats through use of the {{Start date}} template. Unlike the {{Update after}} template, {{As of}} does not require the editor to give a full date. This template should not be subst'd.

Syntax

The template can be used in the following forms:

{{As of|year|month|day}}
{{As of|year|month}}
{{As of|year}}

Several additional named parameters can also be used (see below).

Parameters

Required

  • year (first parameter) – required; must be in full numerical format (yyyy)

Optional

  • month (second parameter) – optional; full, abbreviated or numerical (recommended) formats supported
  • day (third parameter) – optional; numerical format only, not included in link

Named

  • alt (named parameter) – optional; allows substitution of visible text output (defaults to "As of [date]") for different wording or use of lower case
  • df (named parameter) – optional; allows use of American date format with value US, only visible to users who have not set their date preferences yet

Examples

{{As of|2008}} returns "As of 2008 (2008)"
{{As of|2008|7}} returns "As of July 2008 (2008-07)"
{{As of|2008|7|5}} returns "As of 5 July 2008 (2008-07-05)"
{{As of|2008|4|1|alt=as of the [[2000 United States Census]]}} returns "as of the 2000 United States Census"
{{As of|2008|7|5|df=US}} returns "As of July 5, 2008 (2008-07-05)"

See also