Difference between revisions of "Template:Floruit/doc"

From blackwiki
Jump to navigation Jump to search
(Sync.)
Line 3: Line 3:
 
<!--Partly based on documentation for {{cl|Citation Style 1 templates}}.-->
 
<!--Partly based on documentation for {{cl|Citation Style 1 templates}}.-->
 
{{ombox|textstyle=font-weight:bold;font-style:italic;|text=To quickly become familiar with this template, see {{slink||TemplateData}} (as usage summary), and {{slink||Examples}}.}}
 
{{ombox|textstyle=font-weight:bold;font-style:italic;|text=To quickly become familiar with this template, see {{slink||TemplateData}} (as usage summary), and {{slink||Examples}}.}}
The template {{bxtn|floruit}} (or [[#Redirects|any of its aliases]]) may be used to format the display of time periods or eras during which people, ideas, theories, or political, cultural or religious movements etc., may have been active or popular. It utilizes "fl.", an abbreviation of ''[[floruit]]'' or "flourished" (in [[Latin]]), as a prefix to the relevant date(s). The prefix abbreviation is wikilinked to floruit by default, but users may employ different or additional display options. Please also see {{slink||Exceptions}} for possible usage exceptions.
+
Template {{bxtn|floruit}} (or [[#Redirects|any of its aliases]]) may be used to format the display of time periods or eras during which people, ideas, theories, or political, cultural or religious movements etc., may have been active or popular. It utilizes "fl.", an abbreviation of ''[[floruit]]'' or "flourished" (in [[Latin]]), as a prefix to the relevant date(s); a special option may instead employ "active" as prefix. The prefix is wikilinked to floruit by default, but different or additional display options may be used. Please also see {{slink||Exceptions}} for possible usage exceptions.
  
 
==Usage==
 
==Usage==
  
 
===Structure===
 
===Structure===
For presentation purposes only, in the box below [brackets] indicate parameter values; variables are {{em|italicized}}; explanatory text is in (parentheses).
+
For presentation purposes only, in the box below [brackets] indicate parameter values; variables are {{italics correction|{{em|italicized}}}}; explanatory text is in (parentheses).
 
{{csdoc|usage full}}
 
{{csdoc|usage full}}
:<code><nowiki>{{floruit|date= (or) </nowiki>[{{var|date-value}}]<nowiki>|b= |ca= |pfx1= |pfx2= |sfx= |sfx-lk= |sortable= |wrap= }}</nowiki></code>
+
:<code><nowiki>{{floruit/sandbox|date= (or) </nowiki>[{{var|date-value}}]<nowiki>|date2= (or) </nowiki>[{{var|end-date-value}}]<nowiki>|b= |ca= |pfx1= |pfx2= |unit= |sfx= |sfx-lk= |sortable= |wrap= }}</nowiki></code>
 
{{end}}
 
{{end}}
 
Copy a blank version to use. All parameter names must be in lowercase. Use the "{{!}}" (pipe) character between each parameter. Leading and trailing spaces (&#160;) are trimmed from parameter values; therefore, parameters will not display if they are only populated by spaces. Misspelled or undefined parameters are ignored. Delete unused parameters or options, and explanatory text. See {{slink||Parameters}} for important details.
 
Copy a blank version to use. All parameter names must be in lowercase. Use the "{{!}}" (pipe) character between each parameter. Leading and trailing spaces (&#160;) are trimmed from parameter values; therefore, parameters will not display if they are only populated by spaces. Misspelled or undefined parameters are ignored. Delete unused parameters or options, and explanatory text. See {{slink||Parameters}} for important details.
  
By default, the date is prefixed with the abbreviation "fl.", wikilinked to its expanded form (''[[floruit]]''); displayable values are separated by a [[whitespace character]]s of varying lengths. [[Line wrap and word wrap]] is off. Optionally, the floruit date may be set to be sortable.{{efn|name=dts|Template {{tl|dts}} ({{bxtn|d}}ate {{bxtn|t}}ime {{bxtn|s}}orting) has been embedded in code and becomes active when the sortable option is used. Note {{tlf|dts}} has usage constraints; these may trigger native error messages.}} In most cases, usage errors will result in display of relevant error messages.
+
By default, the date or range is prefixed with the abbreviation "fl.", wikilinked to its expanded form (''[[floruit]]''); optionally, the prefix may be replaced by "active" in special cases. Displayable template values are separated by [[whitespace character]]s of varying lengths. Formatted date ranges are separated by a [[spaced en dash]]. [[Line wrap and word wrap]] is off. Optionally, the floruit date may be set to be sortable.{{efn|name=dts|Template {{tl|dts}} ({{bxtn|d}}ate {{bxtn|t}}ime {{bxtn|s}}orting) has been embedded in code and becomes active when the sortable option is used.}} In most cases, usage errors will result in display of relevant error messages.
  
 
===Applicability===
 
===Applicability===
 
This template may be used when exact or complete date information  
 
This template may be used when exact or complete date information  
 
{{Ordered list|list_style_type=lower-alpha|is not required|is not necessary or pertinent|is not reliably known}}
 
{{Ordered list|list_style_type=lower-alpha|is not required|is not necessary or pertinent|is not reliably known}}
[[Floruit|By definition]], the relevant date(s) may be month, year, decade, or century ranges, or may otherwise be inexact or approximate. See [[WP:APPROXDATE]] for additional guidance.
+
[[Floruit|By definition]], the relevant date(s) may be month, year, decade, or century ranges, or may otherwise be inexact or approximate. When the template is applied to persons with known occupations, the prefix option "active" is recommended; see [[WP:APPROXDATE]] for additional guidance.
  
 
===Exceptions===
 
===Exceptions===
Line 25: Line 25:
  
 
==Parameters==
 
==Parameters==
All parameters are optional; use of parameter {{bxt|date}} is suggested, as some options depend on it. Incorrect values will be flagged under almost all usage scenarios (see {{slink||Error messages}}). Parameter names are in {{bxtn|bold}}; explanatory or expanded text may follow, in parentheses.
+
All parameters are optional; some options may depend on other parameters. Use of parameters {{bxt|date}}, and (additionally, for date ranges) {{bxt|date2}}, is suggested. Incorrect parameter values will be flagged under almost all usage scenarios (see {{slink||Error messages}}).<br/>
 +
Parameter names are in {{bxtn|bold}} below, for presentation only.
  
 
===Date formatting parameters===
 
===Date formatting parameters===
 
Suggested:
 
Suggested:
*{{bxtn|date}}{{spaced en dash}} the time period during which the subject is known to have been active or popular. Values may be single dates or ranges in any relevant time unit; per [[WP:APPROXDATE]], where applicable, floruit ranges must be separated by a [[spaced en dash]]. Use any of Wikipedia's [[MOS:DATEFORMAT|acceptable date formats]], but please follow the relevant format established in the article, if any. Preceded by a [[narrow no-break space]]. Depending on the template options used, {{em|this parameter may require a value}}.
+
*{{bxtn|date}} or {{bxtn|[1]}} (stand-alone date, or start date for range){{spnd}} the time period (or the start of a time period) during which the subject is known to have been active or popular. Values may be in any relevant date unit. You may also use this parameter as a free-form field, for stand-alone dates or for date ranges; such ranges must be separated by a [[spaced en dash]] where applicable ([[WP:APPROXDATE]]). For time periods not delimited with start and end dates (such as "1990s" or "21st century") use this parameter only; in ranges with start and end dates, the additional parameter {{bxt|date2}} [[#rng|below]] may be used, and is recommended. Apply any of Wikipedia's [[MOS:DATEFORMAT|acceptable date formats]], but please follow the relevant format established in the article, if any. Depending on the prefix used (parameter {{bxt|pfx2}} [[#pre2|below]]), the value of {{bxt|date}} may be preceded by a [[narrow no-break space]], or by a [[no-break space]]. A value for this parameter {{em|may be required by other options}}.
 
:{{em|id=unnamed|Note:}} You may treat {{bxt|date}} as an unnamed parameter, and insert only its desired value.
 
:{{em|id=unnamed|Note:}} You may treat {{bxt|date}} as an unnamed parameter, and insert only its desired value.
:{{em|id=space|Note:}} If {{bxt|date}} is not utilized, the displayed output may vary according to the user’s choice of [[whitespace character]](s) following the prefix "fl.", or according to other user formatting.
+
:{{em|id=space|Note:}} When {{bxt|date}} is not utilized, displayed output may vary according to user formatting.
:{{en dash}}{{nbsp}}{{em|for examples see}} [[#dec|{{em|here}}]] {{em|(unnamed) and}} [[#plain|{{em|here}}]] {{em|(not used)}}
+
:{{en dash}}{{nbsp}}{{em|for examples see}} [[#dec|here]] {{em|(named and unnamed) and}} [[#plain|here]] {{em|(not used)}}
 +
*{{anchor|rng}}{{bxtn|date2}} or {{bxtn|[2]}} (end date for range){{spnd}} use to format the end date or period for ranges delimited with start and end dates; this parameter is recommended when depicting such ranges. Values may be in any relevant date unit. {{em|Requires}} a start date (parameter {{bxt|date}}). A [[spaced en dash]] is used as the range separator. A value for this parameter {{em|may be required by other options}}.
 +
:{{em|id=unnamed2|Note:}} You may treat {{bxt|date2}} as an unnamed parameter, and insert only its desired value.
 +
:{{en dash}}{{nbsp}}{{em|for examples see}} [[#brc|here]] {{em|(named and unnamed)}}
 
Optional:
 
Optional:
*{{bxtn|ca}} (circa){{spaced en dash}}set {{para|ca|yes}} for [[circa]] dates; the additional prefix "c.", preceded by a narrow no-break space, is inserted before the date (&#8201;c.).
+
*{{bxtn|ca}} (circa){{spnd}} use for [[circa]] dates; the additional prefix "c.", preceded by a narrow no-break space, is inserted before the relevant date(s) (&#8239;c.).
:{{en dash}}{{nbsp}}{{em|for an example see}} [[#circa|{{em|here}}]]
+
**set {{para|ca|yes}} or {{para|ca|date}} to apply circa independently of any parameter; or to apply to just parameter {{bxt|date}} when used as a stand-alone (or free-form) date; or, when {{bxt|date}} is used as the start date in a formatted range
Conditional:
+
**set {{para|ca|date2}} in formatted ranges {{italics correction|{{em|only}}}}; applies to the end date (parameter {{bxt|date2}})
*{{bxtn|sortable}}{{spaced en dash}} set {{para|sortable|yes}} to format the {{bxt|date}} value so that it is displayed properly within [[WP:TABLESORT|sortable table]]s; it works {{em|only}} with single-date values.{{efn|name=dts}} {{em|Requires a value for parameter}} {{bxt|date}}.
+
**set {{para|ca|both}} in formatted ranges {{em|only}}, as above, but applies to both start and end date (parameters {{bxt|date}} and {{bxt|date2}})
 +
:{{en dash}}{{nbsp}}{{em|for examples see}} [[#ca1|here]] {{em|(stand-alone date)}},  [[#ca1a|here]] {{em|(start date in range)}}, [[#ca2|here]] {{em|(end date in range), and}} [[#ca12|here]] {{em|(start and end date in range)}}
 +
Conditional ({{em|requires a value for parameter}} {{bxt|date}}):
 +
*{{bxtn|sortable}}{{spnd}} set {{para|sortable|yes}} to format the value for parameter {{bxt|date}} so that it is displayed properly within [[WP:TABLESORT|sortable table]]s; it works correctly {{em|only}} with dates that conform to Wikipedia's [[MOS:DATEFORMAT|acceptable date formats]].{{efn|name=dts}}
 
:{{em|id=sorted|Note:}} When using {{bxt|sortable}}, year values less than 1000 require leading zeroes up to the century digit, e.g. "050". Era suffixes (via parameter {{bxt|sfx}} [[#suf|below]]) are ignored.
 
:{{em|id=sorted|Note:}} When using {{bxt|sortable}}, year values less than 1000 require leading zeroes up to the century digit, e.g. "050". Era suffixes (via parameter {{bxt|sfx}} [[#suf|below]]) are ignored.
:{{en dash}}{{nbsp}}{{em|for an example see}} [[#sort|{{em|here}}]]
+
:{{en dash}}{{nbsp}}{{em|for an example see}} [[#sort|here]] ({{em|with additional options}})
  
 
===Prefix formatting parameters===
 
===Prefix formatting parameters===
Optional:
+
Optional:  
*{{bxtn|pfx1}} (prefix style){{spaced en dash}} use this parameter to {{em|italicize}} the display of the prefix "fl.", by setting {{para|pfx1|italics}}.
+
*{{bxtn|pfx1}} (prefix style){{spnd}} use this parameter to {{em|italicize}} the prefix display, by setting {{para|pfx1|italics}}.
:{{en dash}}{{nbsp}}{{em|for an example see}} [[#sort|{{em|here}}]]
+
:{{en dash}}{{nbsp}}{{em|for an example see}} [[#sort|here]] ({{em|with additional options}})
*{{bxtn|pfx2}} (prefix link){{spaced en dash}} alias {{bxtn|lk}}. By default, the prefix is wikilinked to ''[[floruit]]''; use this parameter to change the default by inserting one of the following values:
+
*{{anchor|pre2}}{{bxtn|pfx2}} (prefix link){{spnd}} alias {{bxtn|lk}}. The abbreviation "fl.", wikilinked to ''[[floruit]]'' and followed by a narrow no-break space, is used as the default prefix; use this parameter to change the default by inserting one of the following values:
**set {{para|pfx2|abbr}} to display a [[tooltip]] when the pointer hovers over "fl.", expanding it to "floruit"; tooltip display may depend on browser and/or operating system version.
+
**set {{para|pfx2|abbr}} to display a [[tooltip]] when the pointer hovers over "fl.", expanding it to "floruit"; tooltip display may depend on browser and/or operating system version
**set {{para|pfx2|no}} or {{para|pfx2|off}} to display "fl." in plain text; use to avoid [[WP:Overlinking|overlinking]] when this template is used repeatedly in the body of an article ({{slink|Wikipedia:Manual of Style/Abbreviations|Miscellaneous shortenings}}).
+
**set {{para|pfx2|no}} or {{para|pfx2|off}} to display "fl." in plain text; use to avoid [[WP:Overlinking|overlinking]] when this template is used repeatedly in the body of an article ({{slink|Wikipedia:Manual of Style/Abbreviations|Miscellaneous shortenings}})
:{{en dash}}{{nbsp}}{{em|for examples see}} [[#ttip|{{em|here}}]] {{em|(tooltip) and}} [[#plain|{{em|here}}]] {{em|(plain text)}}
+
**set {{para|pfx2|active}} to replace "fl." with "active", wikilinked to ''[[floruit]]'' and followed by a no-break space; recommended when referring to persons with known occupations
 +
**set {{para|pfx2|active-no}} or {{para|pfx2|active-off}} to use "active" as above, but to display it in plain text
 +
:{{see section|pre={{en dash}}{{nbsp}}{{em|for examples see}}||ttip|txt=here|post={{em|(tooltip)}}|term=,}} {{see section||plain|txt=here|post={{em|(plain text)}}|term=,}} {{see section|pre=and||act|txt=here|post={{em|("active")}}}}
 +
 
 +
===Suffix formatting parameters===
 +
Conditional ({{em|require a value for parameter}} {{bxt|date}}; {{em|may require a value for parameter}} {{bxt|date2}}):
 +
*{{anchor|suf}}{{bxtn|sfx}} (suffix){{spnd}} use this parameter to add an era suffix preceded by a no-break space to the floruit date or range. Displays in plain text, but you may use the dependent parameter {{bxt|sfx-lk}} {{see section||suflink|txt=below}} to display with an appropriate wikilink. The available options conform to the [[MOS:ERA|default calendar era]]. If parameter {{bxt|unit}} is specified ({{see section||du|pre=see|txt=below}}), the suffix follows the unit value. When using this parameter with formatted ranges the value applies to the end date only, {{em|except}} when the date range straddles eras.
 +
**set {{para|sfx|ad}} to display the suffix AD ([[Anno Domini]]) after parameter {{bxt|date}} when used as a stand-alone (or free-form) date; or, in formatted ranges, after the end date (parameter {{bxt|date2}})
 +
**set {{para|sfx|bc}} as above, but displays the suffix BC ([[Anno Domini|Before Christ]])
 +
**set {{para|sfx|bce}} as above, but displays the suffix BCE ([[Common Era|Before Common Era]])
 +
**set {{para|sfx|ce}} as above, but displays the suffix CE ([[Common Era]])
 +
**set {{para|sfx|b-a}} in formatted ranges {{em|only}}, to denote they straddle eras; displays BC after the start date (parameter {{bxt|date}}) and AD after the end date (parameter {{bxt|date2}})
 +
**set {{para|sfx|b-c}} in formatted ranges {{em|only}}, as above, but displays BCE after the start date and CE after the end date
 +
:{{en dash}}{{nbsp}}{{em|for examples see}} [[#suf1|here]] {{em|(free-form range)}}, [[#suf2|here]] {{em|(end date in range), and}} [[#suf12|here]] {{em|(start and end date in range straddle eras)}}
 +
*{{anchor|suflink}}{{bxtn|sfx-lk}} (suffix link){{spnd}} use to wikilink the suffix to the appropriate page, by setting {{para|sfx-lk|yes}};{{efn|name=noerr|Any other value is ignored silently.}} parameter {{bxt|sfx}} is {{em|required}}.
 +
:{{en dash}}{{nbsp}}{{em|for an example see}} [[#suf-lk|here]]
  
 
===Other parameters===
 
===Other parameters===
Conditional ({{em|require a value for parameter}} {{bxt|date}}):
+
Conditional ({{em|require a value for parameter}} {{bxt|date}}; {{em|may require a value for parameter}} {{bxt|date2}}):
*{{bxtn|b}} (brackets){{spaced en dash}} use {{bxt|b}} to display the template's output in parentheses, by setting {{para|b|yes}}.
+
*{{bxtn|b}} (brackets){{spnd}} use {{bxt|b}} to display the template's output in parentheses, by setting {{para|b|yes}}.
:{{en dash}}{{nbsp}}{{em|for an example see}} [[#brc|{{em|here}}]]  
+
:{{en dash}}{{nbsp}}{{em|for an example see}} [[#brc|here]]  
*{{anchor|suf}}{{bxtn|sfx}} (suffix): use this parameter to append the floruit date with an era suffix preceded by a [[no-break space]]. Displays in plain text, but you may use the dependent parameter {{bxt|sfx-lk}} (see [[#suflink|below]]) to display with an appropriate wikilink. The available options conform to the [[MOS:ERA|default calendar era]].
+
*{{anchor|du}}{{bxtn|unit}} (date unit){{spnd}} use this parameter to specify a date unit for the floruit date or range, preceded by a no-break space. When using this parameter with formatted ranges, the value applies to the end date, or to both start and end date.
**set {{para|sfx|ad}} to display the suffix AD ([[Anno Domini]])
+
**set {{para|unit|c}} to add "century" after parameter {{bxt|date}} when it is a stand-alone (or free-form) date; or, in formatted ranges, to add the unit after the end date (parameter {{bxt|date2}})
**set {{para|sfx|bc}} to display the suffix BC ([[Anno Domini|Before Christ]])
+
**set {{para|unit|m}} as above, but adds "millennium" instead
**set {{para|sfx|bce}} to display the suffix BCE ([[Common Era|Before Common Era]])
+
**set {{para|unit|c-c}} in formatted ranges {{italics correction|{{em|only}}}}; adds "century" after both the start and the end date ({{bxt|date}} and {{bxt|date2}})
**set {{para|sfx|ce}} to display the suffix CE ([[Common Era]])
+
**set {{para|unit|m-m}} in formatted ranges {{em|only}}, as above, but adds "millennium" instead
:{{en dash}}{{nbsp}}{{em|for an example see}} [[#circa|{{em|here}}]]
+
:{{en dash}}{{nbsp}}{{em|for examples see}} [[#du1|here]] {{em|(stand-alone date)}}, [[#ca2|here]] {{em|(end date in range), and}} [[#du12|here]] {{em|(start and end date in range)}}
*{{anchor|suflink}}{{bxtn|sfx-lk}} (suffix link): use to wikilink the suffix to the appropriate page, by setting {{para|sfx-lk|yes}};{{efn|name=noerr|Any other value is ignored silently.}} parameter {{bxt|sfx}} is {{em|required}}.
 
:{{en dash}}{{nbsp}}{{em|for an example see}} [[#suf-lk|{{em|here}}]]
 
 
Optional:
 
Optional:
*{{bxtn|wrap}} (word wrap){{spaced en dash}} by default, template output displays without word wrapping; to turn word wrap on, set {{para|wrap|yes}}.
+
*{{bxtn|wrap}} (word wrap){{spnd}} by default, template output displays without word wrapping. To turn word wrap on, set {{para|wrap|yes}}; in order to conform to [[WP:MOS]], some parameters values may display with no-wrap separators.
:{{en dash}}{{nbsp}}{{em|for an example see}} [[#sort|{{em|here}}]]
+
:{{en dash}}{{nbsp}}{{em|for an example see}} [[#sort|here]]
  
 
==Examples==
 
==Examples==
*{{anchor|dec}}{{strong|Decade range}}
+
*{{anchor|dec}}{{strong|Decade range, stand-alone}}
:<code><nowiki>{{floruit|date=2010s}}</nowiki></code>
+
:<code><nowiki>{{floruit/sandbox|date=2000s}}</nowiki></code>
 
:or
 
:or
:<code><nowiki>{{floruit|2010s}}</nowiki></code> ([[#unnamed|{{em|note}}]])
+
:<code><nowiki>{{floruit/sandbox|2000s}}</nowiki></code> ([[#unnamed|{{em|note}}]])
:Either generates: {{floruit|2010s}}
+
:Either generates: {{floruit/sandbox|2000s}}
*{{anchor|brc}}{{strong|Decade range, in parentheses}}
+
*{{anchor|brc}}{{strong|Decade range, formatted, in parentheses}}
:<code><nowiki>{{floruit|date=2010s|b=yes}}</nowiki></code>
+
:<code><nowiki>{{floruit/sandbox|date=2000|date2=2010|b=yes}}</nowiki></code>
 
:or
 
:or
:<code><nowiki>{{floruit|2010s|b=yes}}</nowiki></code>
+
:<code><nowiki>{{floruit/sandbox|2000|2010|b=yes}}</nowiki></code> ([[#unnamed2|{{em|note}}]])
:Either generates: {{floruit|2010s|b=yes}}
+
:Either generates: {{floruit/sandbox|2000|2010|b=yes}}
 +
*{{anchor|ca1}}{{strong|Circa decade range, stand-alone}}
 +
:<code><nowiki>{{floruit/sandbox|date=2000s|ca=yes}}</nowiki></code>
 +
:Generates: {{floruit/sandbox|date=2000s|ca=yes}}
 +
*{{anchor|ca1a}}{{strong|Circa start date for formatted decade range}}
 +
:<code><nowiki>{{floruit/sandbox|2000|2010|ca=date}}</nowiki></code>
 +
:Generates: {{floruit/sandbox|2000|2010|ca=date}}
 +
*{{anchor|ca2}}{{strong|Circa end date for century range, with date unit}}
 +
:<code><nowiki>{{floruit/sandbox|date=20th|date2=21st|ca=date2|unit=c}}</nowiki></code>
 +
:Generates: {{floruit/sandbox|date=20th|date2=21st|ca=date2|unit=c}}
 +
*{{anchor|ca12}}{{strong|Circa formatted century range, with date unit}}
 +
:<code><nowiki>{{floruit/sandbox|date=20th|date2=21st|ca=both|unit=c}}</nowiki></code>
 +
:Generates: {{floruit/sandbox|date=20th|date2=21st|ca=both|unit=c}}
 
*{{anchor|plain}}{{strong|Prefix only, in plain text}}
 
*{{anchor|plain}}{{strong|Prefix only, in plain text}}
:<code><nowiki>{{floruit|pfx2=no}} 2010s</nowiki></code> ([[#space|{{em|note}}]])
+
:<code><nowiki>{{floruit/sandbox|pfx2=no}} 2010s</nowiki></code> ([[#space|{{em|note}}]])
:Generates: {{floruit|pfx2=no}} 2010s
+
:Generates: {{floruit/sandbox|pfx2=no}} 2010s
*{{anchor|ttip}}{{strong|Years range, prefix with tooltip}}
+
*{{anchor|ttip}}{{strong|Year range, formatted, prefix with tooltip}}
:<code><nowiki>{{floruit|date=2010{{snd}}2016}}|pfx2=abbr}}</nowiki></code>
+
:<code><nowiki>{{floruit/sandbox|date=2010|date2=2016|pfx2=abbr}}</nowiki></code>
:Generates: {{floruit|date=2010{{snd}}2016|pfx2=abbr}}
+
:Generates: {{floruit/sandbox|date=2010|date2=2016|pfx2=abbr}}
*{{anchor|circa}}{{strong|Circa century and suffix}}
+
*{{anchor|act}}{{strong|"Active" prefix, formatted range}}  
:<code><nowiki>{{floruit|date=21st century|ca=yes|sfx=ce}}</nowiki></code>
+
:<code><nowiki>{{floruit/sandbox|date=January 2000|date2=April 2001|pfx2=active}}</nowiki></code>  
:Generates: {{floruit|date=21st century|ca=yes|sfx=ce}}
+
:Generates: {{floruit/sandbox|date=January 2000|date2=April 2001|pfx2=active}}
*{{anchor|suf-lk}}{{strong|Suffix wikilinked, prefix in plain text, circa century, in parentheses}}
+
*{{anchor|suf1}}{{strong|Suffix, free-form decade range}}
:<code><nowiki>{{floruit|date=21st century|b=yes|ca=yes|pfx2=no|sfx=ce|sfx-lk=yes}}</nowiki></code>
+
:<code><nowiki>{{floruit/sandbox|date=2000s to 2010s|sfx=ce}}</nowiki></code>
:Generates: {{floruit|date=21st century|b=yes|pfx2=no|ca=yes|sfx=ce|sfx-lk=yes}}
+
:Generates: {{floruit/sandbox|date=2000s to 2010s|sfx=ce}}
 +
*{{anchor|suf2}}{{strong|Suffix for end date, formatted mixed-unit range}}
 +
:<code><nowiki>{{floruit/sandbox|date=1990s|date2=before 2010|sfx=ce}}</nowiki></code>
 +
:Generates: {{floruit/sandbox|date=1990s|date2=before 2010|sfx=ce}}
 +
*{{anchor|suf12}}{{strong|Suffix, formatted century range straddles eras, with date units}}
 +
:<code><nowiki>{{floruit/sandbox|date=1st|date2=1st|unit=c-c|sfx=b-a}}</nowiki></code>
 +
:Generates: {{floruit/sandbox|date=1st|date2=1st|unit=c-c|sfx=b-a}}
 +
*{{anchor|suf-lk}}{{strong|Suffix wikilinked, "active" prefix in plain text, formatted decade range with circa start date, in parentheses}}
 +
:<code><nowiki>{{floruit/sandbox|date=2000s|date2=2010s|b=yes|pfx2=active-no|ca=yes|sfx=ce|sfx-lk=yes}}</nowiki></code>
 +
:Generates: {{floruit/sandbox|date=2000s|date2=2010s|b=yes|pfx2=active-no|ca=yes|sfx=ce|sfx-lk=yes}}
 +
*{{anchor|du1}}{{strong|Date unit, stand-alone century}}
 +
:<code><nowiki>{{floruit/sandbox|date=21st|unit=c}}</nowiki></code>
 +
:Generates: {{floruit/sandbox|date=21st|unit=c}}
 +
*{{anchor|du12}}{{strong|Date units, formatted century range}}
 +
:<code><nowiki>{{floruit/sandbox|date=20th|date2=21st|unit=c-c}}</nowiki></code>
 +
:Generates: {{floruit/sandbox|date=20th|date2=21st|unit=c-c }}
 
*{{anchor|sort}}{{strong|Sortable year, word wrap is on, prefix italicized, and suffix}}  
 
*{{anchor|sort}}{{strong|Sortable year, word wrap is on, prefix italicized, and suffix}}  
:<code><nowiki>{{floruit|date=050|sortable=yes|pfx1=italics|sfx=bce|wrap=yes}}</nowiki></code> ([[#sorted|{{em|note}}]])
+
:<code><nowiki>{{floruit/sandbox|date=050|sortable=yes|pfx1=italics|sfx=bce|wrap=yes}}</nowiki></code> ([[#sorted|{{em|note}}]])
:Generates: {{floruit|date=050|sortable=yes|pfx1=italics|sfx=bce|wrap=yes}}
+
:Generates: {{floruit/sandbox|date=050|sortable=yes|pfx1=italics|sfx=bce|wrap=yes}}
  
 
==Error messages==
 
==Error messages==
Multiple errors are flagged per parameter; errors involving the same parameter may be mutually exclusive.</br>
+
Multiple errors are flagged per parameter; errors involving the same parameter may be mutually exclusive. Errors may also be {{em|conditional}}, dependent on the options utilized and/or required; for example, when a correct value for "circa" is specified for the end date of a formatted range, but no such range is utilized.</br>
Messages replace the relevant parameter value(s), and appear under the following conditions:{{efn|name=tl2|When error messages appear in live usage, the included [[template:tl2|template link]] to {{bxtn|{{tlf|floruit}}}} is active.}}
+
Messages replace the relevant parameter value(s), and appear under the following conditions:{{efn|name=tl2|When error messages appear in live usage, the included [[template:tl2|template link]] to {{bxtn|{{tlf|floruit}}}} is active.}}<br/><br/>
{{crlf|2}}
+
{{strong|Parameters {{bxt|b}}, {{bxt|ca}}, {{bxt|pfx1}}, {{bxt|pfx2}}, {{bxt|unit}}, {{bxt|sortable}}}} and {{bxt|wrap}}
{{strong|Parameters {{bxt|b}}, {{bxt|ca}}, {{bxt|pfx1}}, {{bxt|pfx2}}, {{bxt|sortable}}}} and {{bxt|wrap}}
+
*Incorrect value: {{error|message={{small|&#91;error in template {{tl2|floruit}}: wrong value for the {{var|parameter}} option&#93;}}}}
*Incorrect value: {{error|message={{small|&#91;error in template {{tl2|floruit}}: wrong value for the {{var|relevant-parameter}} option&#93;}}}}
+
{{strong|Parameters {{bxt|b}}, {{bxt|unit}}, {{bxt|sfx}}}} and {{bxt|sortable}}
{{strong|Parameters {{bxt|b}}, {{bxt|sfx}}}} and {{bxt|sortable}}
+
*Date required: {{error|message={{small|&#91;error in template {{tl2|floruit}}: {{var|parameter}} option requires a date value&#93;}}}}
*Date required: {{error|message={{small|&#91;error in template {{tl2|floruit}}: {{var|relevant-parameter}} option requires a date value&#93;}}}}
+
{{strong|Parameter {{bxt|date2}}}}
 +
*Start date missing: {{error|message=&#32;{{small|&#91;error in template {{tl2|floruit}}: date range requires a starting date&#93;}}}}
 
{{strong|Parameter {{bxt|sfx}}}}
 
{{strong|Parameter {{bxt|sfx}}}}
 
*Incorrect or unsupported entry: {{error|message={{small|&#91;error in template {{tl2|floruit}}: wrong or unsupported suffix&#93;}}}}
 
*Incorrect or unsupported entry: {{error|message={{small|&#91;error in template {{tl2|floruit}}: wrong or unsupported suffix&#93;}}}}
 
{{strong|Parameter {{bxt|sfx-lk}}}}
 
{{strong|Parameter {{bxt|sfx-lk}}}}
 
*Suffix not defined: {{error|message={{small|&#91;error in template {{tl2|floruit}}: suffix link requires suffix&#93;}}}}
 
*Suffix not defined: {{error|message={{small|&#91;error in template {{tl2|floruit}}: suffix link requires suffix&#93;}}}}
 +
{{strong|Parameter {{bxt|sortable}}}}
 +
*Incorrect date format:{{efn|name=dts-err|Trap for related {{tl|dts}} native errors.{{efn|name=dts}}}} {{error|message={{small|&#91;error in template {{tl2|floruit}}: wrong date format for the sortable option&#93;}}}}
  
 
==Redirects==
 
==Redirects==
Line 122: Line 172:
 
"ca": {
 
"ca": {
 
"label": "Circa",
 
"label": "Circa",
"description": "Set to \"yes\" for circa date(s)",
+
"description": "Set to \"yes\" or \"date\" for circa stand-alone dates or for circa start dates in formatted ranges; set to \"date2\" for circa end date in formatted ranges; set to \"both\" for circa formatted ranges; may require 'date' and 'end date' values",
"type": "boolean",
+
"type": "string",
 
"default": "no circa"
 
"default": "no circa"
 
},
 
},
Line 130: Line 180:
 
"1"
 
"1"
 
],
 
],
"label": "Date",
+
"label": "Date or start date",
"description": "Time-period or era, may be a single date or a range",
+
"description": "Time-period or era; may be stand-alone or the start date for a formatted range; may be required by other options",
 
"type": "string",
 
"type": "string",
 
"suggested": true
 
"suggested": true
Line 137: Line 187:
 
"sortable": {
 
"sortable": {
 
"label": "Sortable",
 
"label": "Sortable",
"description": "Set to \"yes\" to sort the date correctly within tables; works with single dates only; requires a 'date' value",
+
"description": "Set to \"yes\" to sort the date correctly within tables; works with properly formatted dates only; requires a 'date' value",
 
"type": "boolean",
 
"type": "boolean",
 
"default": "no sorting"
 
"default": "no sorting"
Line 155: Line 205:
 
"pfx1": {
 
"pfx1": {
 
"label": "Prefix style",
 
"label": "Prefix style",
"description": "Set to \"italics\" to render the prefix fl. in italics",
+
"description": "Set to \"italics\" to render the floruit prefix in italics",
 
"type": "string"
 
"type": "string"
 
},
 
},
Line 163: Line 213:
 
],
 
],
 
"label": "Prefix link",
 
"label": "Prefix link",
"description": "Use to change the default display of the prefix fl.: \"abbr\" replaces wikilink to 'floruit' with a tooltip; \"no\" or \"off\" renders fl. in plain text",
+
"description": "Use to change the default display of the prefix fl.: \"abbr\" replaces wikilink to 'floruit' with a tooltip; \"no\" or \"off\" renders fl. in plain text; \"active\" displays that term as prefix instead, wikilinked to 'floruit'; \"active-no\" or \"active-off\" displays prefix 'active' in plain text ",
 
"type": "string",
 
"type": "string",
 
"default": "[[Floruit|fl.]]"
 
"default": "[[Floruit|fl.]]"
Line 169: Line 219:
 
"sfx": {
 
"sfx": {
 
"label": "Suffix",
 
"label": "Suffix",
"description": "Adds an era suffix; options are: \"ad\", \"bc\", \"bce\", or \"ce\"; displays in uppercase; requires a 'date' value",
+
"description": "Adds era suffix(es); options are: \"ad\", \"bc\", \"bce\", or \"ce\" for stand-alone dates, or for the end date in formatted ranges; in formatted ranges that straddle eras set this to \"b-a\" for a Dionysian era straddle, or to \"b-c\" for a Common Era straddle; displays in uppercase; requires a 'date' value; may require an 'end date' value",
 
"type": "string"
 
"type": "string"
 
},
 
},
 
"sfx-lk": {
 
"sfx-lk": {
 
"label": "Suffix link",
 
"label": "Suffix link",
"description": "Set to \"yes\" to wikilink the era suffix; requires a suffix",
+
"description": "Set to \"yes\" to wikilink the era suffix(es); requires suffix(es)",
 
"type": "boolean",
 
"type": "boolean",
 
"default": "no link"
 
"default": "no link"
 +
},
 +
"date2": {
 +
"aliases": [
 +
"2"
 +
],
 +
"label": "End date",
 +
"type": "string",
 +
"suggested": true,
 +
"description": "End time-period or date for a formatted range; requires a 'date' value; may be required by other options"
 +
},
 +
"unit": {
 +
"label": "Date unit",
 +
"type": "string",
 +
"description": "Set to \"c\" or \"m\" to add 'century' or 'millennium' respectively, after a stand-alone date or after the end date in a formatted range; set to \"c-c\" or \"m-m\" to add the units after both dates in a formatted range; requires a 'date' value; may require an 'end date' value"
 
}
 
}
 
},
 
},
Line 182: Line 246:
 
"paramOrder": [
 
"paramOrder": [
 
"date",
 
"date",
 +
"date2",
 +
"pfx1",
 +
"pfx2",
 
"b",
 
"b",
 
"ca",
 
"ca",
"pfx1",
+
"unit",
"pfx2",
 
 
"sfx",
 
"sfx",
 
"sfx-lk",
 
"sfx-lk",

Revision as of 14:36, 29 September 2016

Template floruit (or any of its aliases) may be used to format the display of time periods or eras during which people, ideas, theories, or political, cultural or religious movements etc., may have been active or popular. It utilizes "fl.", an abbreviation of floruit or "flourished" (in Latin), as a prefix to the relevant date(s); a special option may instead employ "active" as prefix. The prefix is wikilinked to floruit by default, but different or additional display options may be used. Please also see Script error: No such module "Section link". for possible usage exceptions.

Usage

Structure

For presentation purposes only, in the box below [brackets] indicate parameter values; variables are italicized; explanatory text is in (parentheses).

Full parameter set in horizontal format
{{floruit/sandbox|date= (or) [date-value]|date2= (or) [end-date-value]|b= |ca= |pfx1= |pfx2= |unit= |sfx= |sfx-lk= |sortable= |wrap= }}

Copy a blank version to use. All parameter names must be in lowercase. Use the "|" (pipe) character between each parameter. Leading and trailing spaces ( ) are trimmed from parameter values; therefore, parameters will not display if they are only populated by spaces. Misspelled or undefined parameters are ignored. Delete unused parameters or options, and explanatory text. See Script error: No such module "Section link". for important details.

By default, the date or range is prefixed with the abbreviation "fl.", wikilinked to its expanded form (floruit); optionally, the prefix may be replaced by "active" in special cases. Displayable template values are separated by whitespace characters of varying lengths. Formatted date ranges are separated by a spaced en dash. Line wrap and word wrap is off. Optionally, the floruit date may be set to be sortable.[lower-alpha 1] In most cases, usage errors will result in display of relevant error messages.

Applicability

This template may be used when exact or complete date information Template:Ordered list By definition, the relevant date(s) may be month, year, decade, or century ranges, or may otherwise be inexact or approximate. When the template is applied to persons with known occupations, the prefix option "active" is recommended; see WP:APPROXDATE for additional guidance.

Exceptions

Normally, this template should not be used when exact, complete dates need to be indicated, such as a person's birth and death dates, or an organization's founding and dissolution dates. However, it may be used in similar cases if exact or reliable date information is unavailable, or if providing such detail is unnecessary.

Parameters

All parameters are optional; some options may depend on other parameters. Use of parameters date, and (additionally, for date ranges) date2, is suggested. Incorrect parameter values will be flagged under almost all usage scenarios (see Script error: No such module "Section link".).
Parameter names are in bold below, for presentation only.

Date formatting parameters

Suggested:

  • date or [1] (stand-alone date, or start date for range)Template:Spnd the time period (or the start of a time period) during which the subject is known to have been active or popular. Values may be in any relevant date unit. You may also use this parameter as a free-form field, for stand-alone dates or for date ranges; such ranges must be separated by a spaced en dash where applicable (WP:APPROXDATE). For time periods not delimited with start and end dates (such as "1990s" or "21st century") use this parameter only; in ranges with start and end dates, the additional parameter date2 below may be used, and is recommended. Apply any of Wikipedia's acceptable date formats, but please follow the relevant format established in the article, if any. Depending on the prefix used (parameter pfx2 below), the value of date may be preceded by a narrow no-break space, or by a no-break space. A value for this parameter may be required by other options.
Note: You may treat date as an unnamed parameter, and insert only its desired value.
Note: When date is not utilized, displayed output may vary according to user formatting.
 for examples see here (named and unnamed) and here (not used)
  • date2 or [2] (end date for range)Template:Spnd use to format the end date or period for ranges delimited with start and end dates; this parameter is recommended when depicting such ranges. Values may be in any relevant date unit. Requires a start date (parameter date). A spaced en dash is used as the range separator. A value for this parameter may be required by other options.
Note: You may treat date2 as an unnamed parameter, and insert only its desired value.
 for examples see here (named and unnamed)

Optional:

  • ca (circa)Template:Spnd use for circa dates; the additional prefix "c.", preceded by a narrow no-break space, is inserted before the relevant date(s) ( c.).
    • set |ca=yes or |ca=date to apply circa independently of any parameter; or to apply to just parameter date when used as a stand-alone (or free-form) date; or, when date is used as the start date in a formatted range
    • set |ca=date2 in formatted ranges only; applies to the end date (parameter date2)
    • set |ca=both in formatted ranges only, as above, but applies to both start and end date (parameters date and date2)
 for examples see here (stand-alone date), here (start date in range), here (end date in range), and here (start and end date in range)

Conditional (requires a value for parameter date):

Note: When using sortable, year values less than 1000 require leading zeroes up to the century digit, e.g. "050". Era suffixes (via parameter sfx below) are ignored.
 for an example see here (with additional options)

Prefix formatting parameters

Optional:

  • pfx1 (prefix style)Template:Spnd use this parameter to italicize the prefix display, by setting |pfx1=italics.
 for an example see here (with additional options)
  • pfx2 (prefix link)Template:Spnd alias lk. The abbreviation "fl.", wikilinked to floruit and followed by a narrow no-break space, is used as the default prefix; use this parameter to change the default by inserting one of the following values:
    • set |pfx2=abbr to display a tooltip when the pointer hovers over "fl.", expanding it to "floruit"; tooltip display may depend on browser and/or operating system version
    • set |pfx2=no or |pfx2=off to display "fl." in plain text; use to avoid overlinking when this template is used repeatedly in the body of an article (Script error: No such module "Section link".)
    • set |pfx2=active to replace "fl." with "active", wikilinked to floruit and followed by a no-break space; recommended when referring to persons with known occupations
    • set |pfx2=active-no or |pfx2=active-off to use "active" as above, but to display it in plain text
Template:See section Template:See section Template:See section

Suffix formatting parameters

Conditional (require a value for parameter date; may require a value for parameter date2):

  • sfx (suffix)Template:Spnd use this parameter to add an era suffix preceded by a no-break space to the floruit date or range. Displays in plain text, but you may use the dependent parameter sfx-lk Template:See section to display with an appropriate wikilink. The available options conform to the default calendar era. If parameter unit is specified (Template:See section), the suffix follows the unit value. When using this parameter with formatted ranges the value applies to the end date only, except when the date range straddles eras.
    • set |sfx=ad to display the suffix AD (Anno Domini) after parameter date when used as a stand-alone (or free-form) date; or, in formatted ranges, after the end date (parameter date2)
    • set |sfx=bc as above, but displays the suffix BC (Before Christ)
    • set |sfx=bce as above, but displays the suffix BCE (Before Common Era)
    • set |sfx=ce as above, but displays the suffix CE (Common Era)
    • set |sfx=b-a in formatted ranges only, to denote they straddle eras; displays BC after the start date (parameter date) and AD after the end date (parameter date2)
    • set |sfx=b-c in formatted ranges only, as above, but displays BCE after the start date and CE after the end date
 for examples see here (free-form range), here (end date in range), and here (start and end date in range straddle eras)
  • sfx-lk (suffix link)Template:Spnd use to wikilink the suffix to the appropriate page, by setting |sfx-lk=yes;[lower-alpha 2] parameter sfx is required.
 for an example see here

Other parameters

Conditional (require a value for parameter date; may require a value for parameter date2):

  • b (brackets)Template:Spnd use b to display the template's output in parentheses, by setting |b=yes.
 for an example see here
  • unit (date unit)Template:Spnd use this parameter to specify a date unit for the floruit date or range, preceded by a no-break space. When using this parameter with formatted ranges, the value applies to the end date, or to both start and end date.
    • set |unit=c to add "century" after parameter date when it is a stand-alone (or free-form) date; or, in formatted ranges, to add the unit after the end date (parameter date2)
    • set |unit=m as above, but adds "millennium" instead
    • set |unit=c-c in formatted ranges only; adds "century" after both the start and the end date (date and date2)
    • set |unit=m-m in formatted ranges only, as above, but adds "millennium" instead
 for examples see here (stand-alone date), here (end date in range), and here (start and end date in range)

Optional:

  • wrap (word wrap)Template:Spnd by default, template output displays without word wrapping. To turn word wrap on, set |wrap=yes; in order to conform to WP:MOS, some parameters values may display with no-wrap separators.
 for an example see here

Examples

  • Decade range, stand-alone
{{floruit/sandbox|date=2000s}}
or
{{floruit/sandbox|2000s}} (note)
Either generates: fl. 2000s
  • Decade range, formatted, in parentheses
{{floruit/sandbox|date=2000|date2=2010|b=yes}}
or
{{floruit/sandbox|2000|2010|b=yes}} (note)
Either generates: fl. 2000 – c. 2010
  • Circa decade range, stand-alone
{{floruit/sandbox|date=2000s|ca=yes}}
Generates: fl.
  • Circa start date for formatted decade range
{{floruit/sandbox|2000|2010|ca=date}}
Generates: fl. 2000 – c. 2010
  • Circa end date for century range, with date unit
{{floruit/sandbox|date=20th|date2=21st|ca=date2|unit=c}}
Generates: fl.
  • Circa formatted century range, with date unit
{{floruit/sandbox|date=20th|date2=21st|ca=both|unit=c}}
Generates: fl.
  • Prefix only, in plain text
{{floruit/sandbox|pfx2=no}} 2010s (note)
Generates: fl. 2010s
  • Year range, formatted, prefix with tooltip
{{floruit/sandbox|date=2010|date2=2016|pfx2=abbr}}
Generates: fl.
  • "Active" prefix, formatted range
{{floruit/sandbox|date=January 2000|date2=April 2001|pfx2=active}}
Generates: fl.
  • Suffix, free-form decade range
{{floruit/sandbox|date=2000s to 2010s|sfx=ce}}
Generates: fl.
  • Suffix for end date, formatted mixed-unit range
{{floruit/sandbox|date=1990s|date2=before 2010|sfx=ce}}
Generates: fl.
  • Suffix, formatted century range straddles eras, with date units
{{floruit/sandbox|date=1st|date2=1st|unit=c-c|sfx=b-a}}
Generates: fl.
  • Suffix wikilinked, "active" prefix in plain text, formatted decade range with circa start date, in parentheses
{{floruit/sandbox|date=2000s|date2=2010s|b=yes|pfx2=active-no|ca=yes|sfx=ce|sfx-lk=yes}}
Generates: fl.
  • Date unit, stand-alone century
{{floruit/sandbox|date=21st|unit=c}}
Generates: fl.
  • Date units, formatted century range
{{floruit/sandbox|date=20th|date2=21st|unit=c-c}}
Generates: fl.
  • Sortable year, word wrap is on, prefix italicized, and suffix
{{floruit/sandbox|date=050|sortable=yes|pfx1=italics|sfx=bce|wrap=yes}} (note)
Generates: fl.

Error messages

Multiple errors are flagged per parameter; errors involving the same parameter may be mutually exclusive. Errors may also be conditional, dependent on the options utilized and/or required; for example, when a correct value for "circa" is specified for the end date of a formatted range, but no such range is utilized.
Messages replace the relevant parameter value(s), and appear under the following conditions:[lower-alpha 3]

Parameters b, ca, pfx1, pfx2, unit, sortable and wrap

  • Incorrect value: [error in template {{floruit}}: wrong value for the parameter option]

Parameters b, unit, sfx and sortable

  • Date required: [error in template {{floruit}}: parameter option requires a date value]

Parameter date2

  • Start date missing: [error in template {{floruit}}: date range requires a starting date]

Parameter sfx

  • Incorrect or unsupported entry: [error in template {{floruit}}: wrong or unsupported suffix]

Parameter sfx-lk

  • Suffix not defined: [error in template {{floruit}}: suffix link requires suffix]

Parameter sortable

  • Incorrect date format:[lower-alpha 4] [error in template {{floruit}}: wrong date format for the sortable option]

Redirects

{{floruit}} has the following redirects:

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for floruit

Formats the display of periods of activity or popularity for people, ideas, or movements

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Date or start datedate 1

Time-period or era; may be stand-alone or the start date for a formatted range; may be required by other options

Stringsuggested
End datedate2 2

End time-period or date for a formatted range; requires a 'date' value; may be required by other options

Stringsuggested
Prefix stylepfx1

Set to "italics" to render the floruit prefix in italics

Stringoptional
Prefix linkpfx2 lk

Use to change the default display of the prefix fl.: "abbr" replaces wikilink to 'floruit' with a tooltip; "no" or "off" renders fl. in plain text; "active" displays that term as prefix instead, wikilinked to 'floruit'; "active-no" or "active-off" displays prefix 'active' in plain text

Default
[[Floruit|fl.]]
Stringoptional
Bracketsb

Set to "yes" to display output in parentheses; requires a 'date' value

Default
no parentheses
Booleanoptional
Circaca

Set to "yes" or "date" for circa stand-alone dates or for circa start dates in formatted ranges; set to "date2" for circa end date in formatted ranges; set to "both" for circa formatted ranges; may require 'date' and 'end date' values

Default
no circa
Stringoptional
Date unitunit

Set to "c" or "m" to add 'century' or 'millennium' respectively, after a stand-alone date or after the end date in a formatted range; set to "c-c" or "m-m" to add the units after both dates in a formatted range; requires a 'date' value; may require an 'end date' value

Stringoptional
Suffixsfx

Adds era suffix(es); options are: "ad", "bc", "bce", or "ce" for stand-alone dates, or for the end date in formatted ranges; in formatted ranges that straddle eras set this to "b-a" for a Dionysian era straddle, or to "b-c" for a Common Era straddle; displays in uppercase; requires a 'date' value; may require an 'end date' value

Stringoptional
Suffix linksfx-lk

Set to "yes" to wikilink the era suffix(es); requires suffix(es)

Default
no link
Booleanoptional
Sortablesortable

Set to "yes" to sort the date correctly within tables; works with properly formatted dates only; requires a 'date' value

Default
no sorting
Booleanoptional
Word wrapwrap

Set to "yes" to turn word wrap on

Default
no wrap
Booleanoptional

See also

Footnotes

  1. 1.0 1.1 1.2 Template {{dts}} (date time sorting) has been embedded in code and becomes active when the sortable option is used.
  2. Any other value is ignored silently.
  3. When error messages appear in live usage, the included template link to {{floruit}} is active.
  4. Trap for related {{dts}} native errors.[lower-alpha 1]