Difference between revisions of "Template:Floruit/sandbox"
(Shortly.) |
(Rewrite with error checks etc.) |
||
| Line 1: | Line 1: | ||
| − | <!--Begin {{floruit/sandbox}}.--><includeonly>{{#ifeq:{{{wrap|}}}|yes||<span style="white-space:nowrap;">}}{{#if:{{{b|}}}|{{#if:{{{1|{{{date|}}}}}}|{{#ifeq:{{{b|}}}|yes|(|{{error|message={{small|[error in template {{tl2|floruit}}: wrong bracket option]}}}} }}|{{error|message={{small|[error in template {{tl2|floruit}}: bracket option requires a date value]}}}} }}|}}{{#if:{{{pfx1|}}}|{{#ifeq:{{{pfx1|}}}|italics|<em>|{{error|message={{small|[error in template {{tl2|floruit}}: wrong prefix-style option]}}}} }}}}{{#if:{{{pfx2|}}}|{{#switch:{{{pfx2|{{{lk|}}}}}}|no|off=fl.|abbr={{abbr|fl.|floruit}}|{{error|message={{small|[error in template {{tl2|floruit}}: wrong prefix-link option]}}}}}}|[[Floruit|fl.]]}}{{#ifeq:{{{pfx1|}}}|italics|</em>}}{{#if:{{{ca|}}}|{{#ifeq:{{{ca|}}}|yes| c.| {{error|message={{small|[error in template {{tl2|floruit}}: wrong circa option]}}}}}}}}{{#if:{{{ | + | <!--Begin {{floruit/sandbox}}.--><includeonly>{{#if:{{{wrap|}}}|{{#ifeq:{{{wrap|}}}|yes||{{error|message={{small|[error in template {{tl2|floruit}}: wrong value for the wrap option]}}}} }}|<span style="white-space:nowrap;">}}{{#if:{{{b|}}}|{{#if:{{{1|{{{date|}}}}}}|{{#ifeq:{{{b|}}}|yes|(|{{error|message={{small|[error in template {{tl2|floruit}}: wrong value for the bracket option]}}}} }}|{{error|message={{small|[error in template {{tl2|floruit}}: bracket option requires a date value]}}}} }}|}}{{#if:{{{pfx1|}}}|{{#ifeq:{{{pfx1|}}}|italics|<em>|{{error|message={{small|[error in template {{tl2|floruit}}: wrong value for the prefix-style option]}}}} }}}}{{#if:{{{pfx2|}}}|{{#switch:{{{pfx2|{{{lk|}}}}}}|no|off=fl.|abbr={{abbr|fl.|floruit}}|{{error|message={{small|[error in template {{tl2|floruit}}: wrong value for the prefix-link option]}}}}}}|[[Floruit|fl.]]}}{{#ifeq:{{{pfx1|}}}|italics|</em>}}{{#if:{{{ca|}}}|{{#ifeq:{{{ca|}}}|yes| c.| {{error|message={{small|[error in template {{tl2|floruit}}: wrong value for the circa option]}}}}}}}}{{#if:{{{sortable|}}}|{{#if:{{{1|{{{date|}}}}}}|{{#ifeq:{{{sortable|}}}|yes| {{dts|{{{1|{{{date|}}}}}}}}| {{error|message={{small|[error in template {{tl2|floruit}}: wrong value for the sortable option]}}}}}}| {{error|message={{small|[error in template {{tl2|floruit}}: sortable option requires a date value]}}}}}}| {{{1|{{{date|}}}}}}}}{{#if:{{{sfx|}}}|{{#if:{{{1|{{{date|}}}}}}| {{#switch:{{{sfx|}}}|ad={{#ifeq:{{{sfx-lk|}}}|yes|[[Anno Domini|AD]]|AD}}|bc={{#ifeq:{{{sfx-lk|}}}|yes|[[Anno Domini|BC]]|BC}}|bce={{#ifeq:{{{sfx-lk|}}}|yes|[[Common Era|BCE]]|BCE}}|ce={{#ifeq:{{{sfx-lk|}}}|yes|[[Common Era|CE]]|CE}}|{{error|message={{small|[error in template {{tl2|floruit}}: wrong or unsupported suffix]}}}}}}|{{error|message={{small|[error in template {{tl2|floruit}}: suffix option requires a date value]}}}}}}|{{#if:{{{sfx-lk|}}}| {{error|message={{small|[error in template {{tl2|floruit}}: suffix link requires suffix]}}}}}}}}{{#if:{{{1|{{{date|}}}}}}|{{#ifeq:{{{b|}}}|yes|)}}}}{{#ifeq:{{{wrap|}}}|yes||</span>}}</includeonly><!--End {{floruit/sandbox}}.--><noinclude>{{floruit/sandbox|2010s}}<br/>{{floruit/sandbox|2010s|b=y}}<br/> |
| − | {{floruit/sandbox|2010s}}<br/>{{floruit/sandbox|2010s|b=y}}<br/> | ||
{{floruit/sandbox|pfx2=n|2010}}<br/> | {{floruit/sandbox|pfx2=n|2010}}<br/> | ||
{{floruit/sandbox|2010s|b=yes|sfx=ad|sfx-lk=yes}}<br/> | {{floruit/sandbox|2010s|b=yes|sfx=ad|sfx-lk=yes}}<br/> | ||
{{floruit/sandbox|sfx=ad|sfx-lk=yes}}<br/> | {{floruit/sandbox|sfx=ad|sfx-lk=yes}}<br/> | ||
| − | {{floruit/sandbox | + | {{floruit/sandbox|b=y}}<br/> |
| − | {{floruit/sandbox|ca= | + | {{floruit/sandbox|b=yes}}<br/> |
| − | {{floruit/sandbox| | + | {{floruit/sandbox|ca=yes|sfx=ad}}<br/> |
| + | {{floruit/sandbox|2010|sortable=y|sfx=ad}}<br/> | ||
| + | {{floruit/sandbox|wrap=no}}<br/> | ||
| + | {{Documentation|content= | ||
| + | <!--Categories go at the bottom of this page and interwikis go in Wikidata.--> | ||
| + | <!--Partly based on documentation for {{cl|Citation Style 1 templates}}.--> | ||
| + | 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. | ||
| − | </noinclude> | + | ==Usage== |
| + | |||
| + | ===Structure=== | ||
| + | For presentation purposes only, in the box below [brackets] indicate parameter values; variables are {{em|italicized}}; explanatory text is in (parentheses). | ||
| + | {{csdoc|usage full}} | ||
| + | :<code><nowiki>{{floruit|date= (or) </nowiki>[{{var|date-value}}]<nowiki>|ca= |sortable= |pfx1= |pfx2= |sfx= |sfx-lk= |b= |wrap= }}</nowiki></code> | ||
| + | {{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 ( ) 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, displayable values are separated by a [[whitespace character]]s of varying lengths; [[Line wrap and word wrap|word wrapping]] is off. Template {{tl|dts}} (date time sorting) has been embedded in code and becomes active when the {{em|floruit}} date is (optionally) set to be sortable. 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 | ||
| + | {{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. | ||
| + | |||
| + | ===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; 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. | ||
| + | |||
| + | ===Date formatting parameters=== | ||
| + | Suggested: | ||
| + | *{{bxtn|date}}{{spaced en dash}} the time period during which the subject is known to have been active or popular. Dated in year(s), decade(s), centuries or other time units, including ranges. May be any one of Wikipedia's [[MOS:DATEFORMAT|acceptable date formats]], but please follow the relevant format established in the article, if any. Depending on the template options used, {{em|this parameter may require a value}}. | ||
| + | :{{em|id=unnamed|Note1:}} You may treat {{bxt|date}} as an unnamed parameter, and insert only its desired value. | ||
| + | :{{em|id=space|Note2:}} 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. | ||
| + | :{{en dash}}{{nbsp}}{{em|for examples see}} [[#dec|{{em|here}}]] {{em|(unnamed) and}} [[#plain|{{em|here}}]] {{em|(not used)}} | ||
| + | Optional: | ||
| + | *{{bxtn|ca}} (circa){{spaced en dash}}set {{para|ca|yes}} for [[circa]] dates; the additional prefix "c.", preceded by a [[thin space]], is inserted before the date ( c.). | ||
| + | :{{en dash}}{{nbsp}}{{em|for an example see}} [[#circa|{{em|here}}]] | ||
| + | Conditional: | ||
| + | *{{bxtn|sortable}}{{spaced en dash}} set {{para|sortable|yes}} to format the {{bxt|date}} value(s) so that they are displayed properly within [[WP:TABLESORT|sortable table]]s; {{em|requires a value for parameter}} {{bxt|date}}. | ||
| + | :{{em|id=sort|Note3:}} To sort correctly, parameter {{bxt|sortable}} wraps template {{tl|dts}} around the date value(s); it works best with single-date values. {{em|Do not}} embed templates as values to {{bxt|date}} when {{bxt|sortable}} is used; results may be unpredictable. Note {{tlf|dts}} has other shortcomings. | ||
| + | :{{en dash}}{{nbsp}}{{em|for an example see}} [[#sort|{{em|here}}]] | ||
| + | |||
| + | ===Prefix formatting parameters=== | ||
| + | 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}}. | ||
| + | :{{en dash}}{{nbsp}}{{em|for an example see}} [[#sort|{{em|here}}]] | ||
| + | *{{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: | ||
| + | **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}}). | ||
| + | :{{en dash}}{{nbsp}}{{em|for examples see}} [[#ttip|{{em|here}}]] {{em|(tooltip) and}} [[#plain|{{em|here}}]] {{em|(plain text)}} | ||
| + | |||
| + | ===Other parameters=== | ||
| + | Conditional ({{em|require a value for parameter}} {{bxt|date}}): | ||
| + | *{{bxtn|b}} (brackets){{spaced en dash}} 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}}]] | ||
| + | *{{bxtn|sfx}} (suffix): use this parameter to append an era suffix (preceded by a no-break space) to the year of birth. 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]]. | ||
| + | **set {{para|sfx|ad}} to display the suffix AD ([[Anno Domini]]) | ||
| + | **set {{para|sfx|bc}} to display the suffix BC ([[Anno Domini|Before Christ]]) | ||
| + | **set {{para|sfx|bce}} to display the suffix BCE ([[Common Era|Before Common Era]]) | ||
| + | **set {{para|sfx|ce}} to display the suffix CE ([[Common Era]]) | ||
| + | :{{en dash}}{{nbsp}}{{em|for an example see}} [[#circa|{{em|here}}]] | ||
| + | *{{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: | ||
| + | *{{bxtn|wrap}} (word wrap){{spaced en dash}} by default, template output displays without word wrapping; to turn word wrap on, set {{para|wrap|yes}}. | ||
| + | :{{en dash}}{{nbsp}}{{em|for an example see}} [[#sort|{{em|here}}]] | ||
| + | |||
| + | ==Examples== | ||
| + | Some of the following examples may utilize additional, embedded templates, in order to enhance presentation or clarity. Such practice is optional. | ||
| + | *{{anchor|dec}}{{strong|Decade, prefix wikilinked}} | ||
| + | :<code><nowiki>{{floruit/sandbox|date=2010s}}</nowiki></code> | ||
| + | :or | ||
| + | :<code><nowiki>{{floruit/sandbox|2010s}}</nowiki></code> ([[#unnamed|{{em|note}}]]) | ||
| + | :Either generates: {{floruit/sandbox|2010s}} | ||
| + | *{{anchor|brc}}{{strong|As above, in parentheses}} | ||
| + | :<code><nowiki>{{floruit/sandbox|date=2010s|b=yes}}</nowiki></code> | ||
| + | :or | ||
| + | :<code><nowiki>{{floruit/sandbox|2010s|b=yes}}</nowiki></code> | ||
| + | :Either generates: {{floruit/sandbox|2010s|b=yes}} | ||
| + | *{{anchor|plain}}{{strong|Prefix only, in plain text}} | ||
| + | :<code><nowiki>{{floruit/sandbox|pfx2=no}} 2010s</nowiki></code> ([[#space|{{em|note}}]]) | ||
| + | :Generates: {{floruit/sandbox|pfx2=no}} 2010s | ||
| + | *{{anchor|ttip}}{{strong|Year range, prefix with tooltip}} | ||
| + | :<code><nowiki>{{floruit/sandbox|date={{dash year|2010|2016}}|pfx2=abbr}}</nowiki></code> | ||
| + | :Generates: {{floruit/sandbox|date={{dash year|2010|2016}}|pfx2=abbr}} | ||
| + | :{{en dash}}{{nbsp}}{{em|uses}} {{tl|dash year}} {{em|to format year range ([[#sort|note]])}} | ||
| + | *{{anchor|circa}}{{strong|Circa century, prefix wikilinked, and suffix}} | ||
| + | :<code><nowiki>{{floruit/sandbox|date=21st century|ca=yes|sfx=ce}}</nowiki></code> | ||
| + | :Generates: {{floruit/sandbox|date=21st century|ca=yes|sfx=ce}} | ||
| + | *{{anchor|suf-lk}}{{strong|Circa century, suffix wikilinked, in parentheses}} | ||
| + | :<code><nowiki>{{floruit/sandbox|date=21st century|b=yes|ca=yes|pfx2=no|sfx=ce|sfx-lk=yes}}</nowiki></code> | ||
| + | :Generates: {{floruit/sandbox|date=21st century|b=yes|pfx2=no|ca=yes|sfx=ce|sfx-lk=yes}} | ||
| + | *{{anchor|sort}}{{strong|Sortable, single year, prefix italicized with tooltip, word wrap is on}} | ||
| + | :<code><nowiki>{{floruit/sandbox|date=2016|sortable=yes|pfx1=italics|pfx2=abbr|wrap=yes}}</nowiki></code> | ||
| + | :Generates: {{floruit/sandbox|date=2016|sortable=yes|pfx1=italics|pfx2=abbr|wrap=yes}} | ||
| + | *{{strong|As above, in parentheses}} | ||
| + | :<code><nowiki>{{floruit/sandbox|date=2016|sortable=yes|pfx1=italics|pfx2=abbr|b=yes|wrap=yes}}</nowiki></code> | ||
| + | :Generates: {{floruit/sandbox|date=2016|sortable=yes|pfx1=italics|pfx2=abbr|b=yes|wrap=yes}} | ||
| + | |||
| + | ==Error messages== | ||
| + | Multiple errors are flagged per parameter; errors involving the same parameter may be mutually exclusive.</br> | ||
| + | Messages may replace or precede 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.}} | ||
| + | {{crlf|2}} | ||
| + | {{strong|Parameters {{bxt|wrap}}, {{bxt|b}}, {{bxt|pfx1}}, {{bxt|pfx2}}, {{bxt|ca}}, and {{bxt|sortable}}}} | ||
| + | *Incorrect value: {{error|message={{small|[error in template {{tl2|floruit}}: wrong value for the {{var|parameter-name}} option]}}}} | ||
| + | {{strong|Parameters {{bxt|b}}, {{bxt|sortable}}, and {{bxt|sfx}}}} | ||
| + | *Date required: {{error|message={{small|[error in template {{tl2|floruit}}: {{var|parameter-name}} option requires a date value]}}}} | ||
| + | {{strong|Parameter {{bxt|sfx}}}} | ||
| + | *Incorrect or unsupported entry: {{error|message={{small|[error in template {{tl2|floruit}}: wrong or unsupported suffix]}}}} | ||
| + | {{strong|Parameter {{bxt|sfx-lk}}}} | ||
| + | *Suffix not defined: {{error|message={{small|[error in template {{tl2|floruit}}: suffix link requires suffix]}}}} | ||
| + | |||
| + | ==Redirects== | ||
| + | <!--This section is linked from within this document ([[MOS:HEAD]])--> | ||
| + | {{tlf|floruit}} has the following [[Wikipedia:redirect|redirect]]s: | ||
| + | *{{tl|fl.}} | ||
| + | *{{tl|flor}} | ||
| + | *{{tl|flor.}} | ||
| + | *{{tl|flourished}} | ||
| + | *{{tl|flr}} | ||
| + | |||
| + | ==TemplateData== | ||
| + | {{TemplateDataHeader|floruit}} | ||
| + | <templatedata> | ||
| + | { | ||
| + | "params": { | ||
| + | "ca": { | ||
| + | "label": "Circa", | ||
| + | "description": "Set to \"yes\" for circa date(s)", | ||
| + | "type": "boolean", | ||
| + | "default": "no" | ||
| + | }, | ||
| + | "date": { | ||
| + | "aliases": [ | ||
| + | "1" | ||
| + | ], | ||
| + | "label": "Date", | ||
| + | "description": "Time-period or era, may be a single date or a range", | ||
| + | "type": "string", | ||
| + | "suggested": true | ||
| + | }, | ||
| + | "sortable": { | ||
| + | "label": "Sortable", | ||
| + | "description": "Set to \"yes\" to sort the date correctly within tables; requires a 'date' value", | ||
| + | "type": "boolean", | ||
| + | "default": "no" | ||
| + | }, | ||
| + | "b": { | ||
| + | "label": "Brackets", | ||
| + | "description": "Set to \"yes\" to display output in parentheses; requires a 'date' value", | ||
| + | "type": "boolean", | ||
| + | "default": "no" | ||
| + | }, | ||
| + | "wrap": { | ||
| + | "label": "Word wrap", | ||
| + | "description": "Set to \"yes\" to turn word wrap on", | ||
| + | "type": "boolean", | ||
| + | "default": "no" | ||
| + | }, | ||
| + | "pfx1": { | ||
| + | "label": "Prefix style", | ||
| + | "description": "Set to \"italics\" to render the prefix 'fl.' in italics", | ||
| + | "type": "string" | ||
| + | }, | ||
| + | "pfx2": { | ||
| + | "aliases": [ | ||
| + | "lk" | ||
| + | ], | ||
| + | "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", | ||
| + | "type": "string", | ||
| + | "default": "[[Floruit|fl.]]" | ||
| + | }, | ||
| + | "sfx": { | ||
| + | "label": "Suffix", | ||
| + | "description": "Adds an era suffix; options are: \"ad\", \"bc\", \"bce\", or \"ce\"; displays in uppercase; requires a 'date' value", | ||
| + | "type": "string" | ||
| + | } | ||
| + | }, | ||
| + | "description": "Formats the display of periods of activity or popularity for people, ideas, or movements", | ||
| + | "paramOrder": [ | ||
| + | "date", | ||
| + | "ca", | ||
| + | "sortable", | ||
| + | "pfx1", | ||
| + | "pfx2", | ||
| + | "sfx", | ||
| + | "b", | ||
| + | "wrap" | ||
| + | ], | ||
| + | "format": "inline" | ||
| + | } | ||
| + | </templatedata> | ||
| + | |||
| + | ==See also== | ||
| + | *[[Tempore]] | ||
| + | *{{tl|b.}} | ||
| + | *{{tl|circa}} | ||
| + | *{{tl|reign}} | ||
| + | |||
| + | ==Footnotes== | ||
| + | {{notelist}} | ||
| + | |||
| + | }}</noinclude> | ||
Revision as of 20:11, 20 September 2016
fl. 2010s
[error in template {{floruit}}: wrong value for the bracket option] fl. 2010s
[error in template {{floruit}}: wrong value for the prefix-link option] 2010
(fl. 2010s AD)
fl. [error in template {{floruit}}: suffix option requires a date value]
[error in template {{floruit}}: bracket option requires a date value] fl.
[error in template {{floruit}}: bracket option requires a date value] fl.
fl. c. [error in template {{floruit}}: suffix option requires a date value]
fl. [error in template {{floruit}}: wrong value for the sortable option] AD
[error in template {{floruit}}: wrong value for the wrap option] fl.
| 50px | This is the template sandbox page for Template:Floruit (diff). |
The 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). The prefix abbreviation is wikilinked to floruit by default, but users may employ different or additional display options. Please also see Script error: No such module "Section link". for possible usage exceptions.
Contents
Usage
Structure
For presentation purposes only, in the box below [brackets] indicate parameter values; variables are italicized; explanatory text is in (parentheses).
|
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, displayable values are separated by a whitespace characters of varying lengths; word wrapping is off. Template {{dts}} (date time sorting) has been embedded in code and becomes active when the floruit date is (optionally) set to be sortable. 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. 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; use of parameter date is suggested, as some options depend on it. Incorrect values will be flagged under almost all usage scenarios (see Script error: No such module "Section link".). Parameter names are in bold; explanatory or expanded text may follow, in parentheses.
Date formatting parameters
Suggested:
- dateTemplate:Spaced en dash the time period during which the subject is known to have been active or popular. Dated in year(s), decade(s), centuries or other time units, including ranges. May be any one of Wikipedia's acceptable date formats, but please follow the relevant format established in the article, if any. Depending on the template options used, this parameter may require a value.
- Note1: You may treat date as an unnamed parameter, and insert only its desired value.
- Note2: If 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.
- – for examples see here (unnamed) and here (not used)
Optional:
- ca (circa)Template:Spaced en dashset
|ca=yesfor circa dates; the additional prefix "c.", preceded by a thin space, is inserted before the date ( c.).
- – for an example see here
Conditional:
- sortableTemplate:Spaced en dash set
|sortable=yesto format the date value(s) so that they are displayed properly within sortable tables; requires a value for parameter date.
- Note3: To sort correctly, parameter sortable wraps template {{dts}} around the date value(s); it works best with single-date values. Do not embed templates as values to date when sortable is used; results may be unpredictable. Note {{dts}} has other shortcomings.
- – for an example see here
Prefix formatting parameters
Optional:
- pfx1 (prefix style)Template:Spaced en dash use this parameter to italicize the display of the prefix "fl.", by setting
|pfx1=italics.
- – for an example see here
- pfx2 (prefix link)Template:Spaced en dash alias lk. By default, the prefix is wikilinked to floruit; use this parameter to change the default by inserting one of the following values:
- set
|pfx2=abbrto 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=noor|pfx2=offto 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
Other parameters
Conditional (require a value for parameter date):
- b (brackets)Template:Spaced en dash use b to display the template's output in parentheses, by setting
|b=yes.
- – for an example see here
- sfx (suffix): use this parameter to append an era suffix (preceded by a no-break space) to the year of birth. Displays in plain text, but you may use the dependent parameter sfx-lk (see below) to display with an appropriate wikilink. The available options conform to the default calendar era.
- set
|sfx=adto display the suffix AD (Anno Domini) - set
|sfx=bcto display the suffix BC (Before Christ) - set
|sfx=bceto display the suffix BCE (Before Common Era) - set
|sfx=ceto display the suffix CE (Common Era)
- set
- – for an example see here
- sfx-lk (suffix link): use to wikilink the suffix to the appropriate page, by setting
|sfx-lk=yes;[lower-alpha 1] parameter sfx is required.
- – for an example see here
Optional:
- wrap (word wrap)Template:Spaced en dash by default, template output displays without word wrapping; to turn word wrap on, set
|wrap=yes.
- – for an example see here
Examples
Some of the following examples may utilize additional, embedded templates, in order to enhance presentation or clarity. Such practice is optional.
- Decade, prefix wikilinked
- As above, in parentheses
{{floruit/sandbox|date=2010s|b=yes}}- or
{{floruit/sandbox|2010s|b=yes}}- Either generates: (fl. 2010s)
- Prefix only, in plain text
{{floruit/sandbox|pfx2=no}} 2010s(note)- Generates: fl. 2010s
- Year range, prefix with tooltip
{{floruit/sandbox|date={{dash year|2010|2016}}|pfx2=abbr}}- Generates: fl. 2010–16
- – uses {{dash year}} to format year range (note)
- Circa century, prefix wikilinked, and suffix
{{floruit/sandbox|date=21st century|ca=yes|sfx=ce}}- Generates: fl. c. 21st century CE
- Circa century, suffix wikilinked, in parentheses
{{floruit/sandbox|date=21st century|b=yes|ca=yes|pfx2=no|sfx=ce|sfx-lk=yes}}- Generates: (fl. c. 21st century CE)
- Sortable, single year, prefix italicized with tooltip, word wrap is on
{{floruit/sandbox|date=2016|sortable=yes|pfx1=italics|pfx2=abbr|wrap=yes}}- Generates: fl. 2016
- As above, in parentheses
{{floruit/sandbox|date=2016|sortable=yes|pfx1=italics|pfx2=abbr|b=yes|wrap=yes}}- Generates: (fl. 2016)
Error messages
Multiple errors are flagged per parameter; errors involving the same parameter may be mutually exclusive.
Messages may replace or precede the relevant parameter value(s), and appear under the following conditions:[lower-alpha 2]
Parameters wrap, b, pfx1, pfx2, ca, and sortable
- Incorrect value: [error in template
{{floruit}}: wrong value for the parameter-name option]
Parameters b, sortable, and sfx
- Date required: [error in template
{{floruit}}: parameter-name option requires a date value]
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]
Redirects
{{floruit}} has the following redirects:
- {{fl.}}
- {{flor}}
- {{flor.}}
- {{flourished}}
- {{flr}}
TemplateData
TemplateData for floruit
Formats the display of periods of activity or popularity for people, ideas, or movements
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Date | date 1 | Time-period or era, may be a single date or a range | String | suggested |
| Circa | ca | Set to "yes" for circa date(s)
| Boolean | optional |
| Sortable | sortable | Set to "yes" to sort the date correctly within tables; requires a 'date' value
| Boolean | optional |
| Prefix style | pfx1 | Set to "italics" to render the prefix 'fl.' in italics | String | optional |
| Prefix link | pfx2 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
| String | optional |
| Suffix | sfx | Adds an era suffix; options are: "ad", "bc", "bce", or "ce"; displays in uppercase; requires a 'date' value | String | optional |
| Brackets | b | Set to "yes" to display output in parentheses; requires a 'date' value
| Boolean | optional |
| Word wrap | wrap | Set to "yes" to turn word wrap on
| Boolean | optional |
See also
Footnotes
- ↑ Any other value is ignored silently.
- ↑ When error messages appear in live usage, the included template link to {{floruit}} is active.
| The above documentation is transcluded from Template:Floruit/doc. (edit | history) Editors can experiment in this template's sandbox (edit | diff) and testcases (create) pages. Subpages of this template. |