|
imported>Vanisaac |
| (99 intermediate revisions by 17 users not shown) |
| Line 1: |
Line 1: |
| | {{Documentation subpage}} | | {{Documentation subpage}} |
| − | <!--Categories go at the bottom of this page and interwikis go in Wikidata.-->
| + | {{Template shortcut|fl|fl.}} |
| − | <!--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}}.}}
| |
| − | 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.
| |
| | | | |
| | + | <!-- Categories go at the bottom of this page and interwikis go in Wikidata. --> |
| | ==Usage== | | ==Usage== |
| | + | '''''Source:''''' <code><nowiki>{{fl.}}</nowiki> 1234</code>, <code><nowiki>{{fl.|1234}}</nowiki></code> ''or'' <code><nowiki>{{fl.|1234|lk=off}}</nowiki></code> |
| | | | |
| − | ===Structure===
| + | '''''Result:''''' {{fl.}} 1234, {{fl.|1234}} ''or'' {{fl.|1234|lk=off}} |
| − | 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, 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.
| + | This template generates an abbreviation for [[floruit]] ("fl."); by default, it has a mouse-over tooltip explaining its meaning. |
| | | | |
| − | ===Applicability=== | + | ===Parameters=== |
| − | This template may be used when exact or complete date information | + | This template supports an optional (first, unnamed) parameter representing a year. For example, {{tlx|fl.|1956}} renders to give {{fl.|1956}}. This differs from <code><nowiki>{{fl.}} 1956</nowiki></code> in that <code><nowiki>{{fl.|1956}}</nowiki></code> puts a [[non-breaking space]] in between the "fl." and the number, which prevents the web browsers from inserting a line break there. |
| − | {{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===
| + | {{Circa/doc/sortable}} |
| − | 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==
| + | If the {{para|lk}} (as in "link") parameter is set to {{para|lk|off}}, then the abbreviation will be rendered as {{fl.|lk=off}} (without a wikilink). Otherwise, the link is displayed. (This can be used to avoid [[WP:Overlinking|overlinking]] when this template is used repeatedly in the body of an article.) |
| − | 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===
| + | Potential future parameters could add articles to appropriate categories, e.g. [[:Category:Year of birth missing]]. |
| − | 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|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.
| |
| − | :{{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 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}}.
| |
| − | :{{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}}]] | |
| − | | |
| − | ===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}}]]
| |
| − | *{{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]].
| |
| − | **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==
| |
| − | *{{anchor|dec}}{{strong|Decade range}}
| |
| − | :<code><nowiki>{{floruit|date=2010s}}</nowiki></code>
| |
| − | :or
| |
| − | :<code><nowiki>{{floruit|2010s}}</nowiki></code> ([[#unnamed|{{em|note}}]])
| |
| − | :Either generates: {{floruit|2010s}}
| |
| − | *{{anchor|brc}}{{strong|Decade range, in parentheses}}
| |
| − | :<code><nowiki>{{floruit|date=2010s|b=yes}}</nowiki></code>
| |
| − | :or
| |
| − | :<code><nowiki>{{floruit|2010s|b=yes}}</nowiki></code>
| |
| − | :Either generates: {{floruit|2010s|b=yes}}
| |
| − | *{{anchor|plain}}{{strong|Prefix only, in plain text}}
| |
| − | :<code><nowiki>{{floruit|pfx2=no}} 2010s</nowiki></code> ([[#space|{{em|note}}]])
| |
| − | :Generates: {{floruit|pfx2=no}} 2010s
| |
| − | *{{anchor|ttip}}{{strong|Year range, prefix with tooltip}}
| |
| − | :<code><nowiki>{{floruit|date=2010{{en dash}}16}}|pfx2=abbr}}</nowiki></code>
| |
| − | :Generates: {{floruit|date=2010{{en dash}}16|pfx2=abbr}}
| |
| − | *{{anchor|circa}}{{strong|Circa century and suffix}}
| |
| − | :<code><nowiki>{{floruit|date=21st century|ca=yes|sfx=ce}}</nowiki></code>
| |
| − | :Generates: {{floruit|date=21st century|ca=yes|sfx=ce}}
| |
| − | *{{anchor|suf-lk}}{{strong|Suffix wikilinked, prefix in plain text, circa century, in parentheses}}
| |
| − | :<code><nowiki>{{floruit|date=21st century|b=yes|ca=yes|pfx2=no|sfx=ce|sfx-lk=yes}}</nowiki></code>
| |
| − | :Generates: {{floruit|date=21st century|b=yes|pfx2=no|ca=yes|sfx=ce|sfx-lk=yes}}
| |
| − | *{{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}}]])
| |
| − | :Generates: {{floruit|date=050|sortable=yes|pfx1=italics|sfx=bce|wrap=yes}}
| |
| − | | |
| − | ==Error messages==
| |
| − | Multiple errors are flagged per parameter; errors involving the same parameter may be mutually exclusive.</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.}}
| |
| − | {{crlf|2}}
| |
| − | {{strong|Parameters {{bxt|b}}, {{bxt|ca}}, {{bxt|pfx1}}, {{bxt|pfx2}}, {{bxt|sortable}}}} and {{bxt|wrap}}
| |
| − | *Incorrect value: {{error|message={{small|[error in template {{tl2|floruit}}: wrong value for the {{var|relevant-parameter}} option]}}}}
| |
| − | {{strong|Parameters {{bxt|b}}, {{bxt|sfx}}}} and {{bxt|sortable}}
| |
| − | *Date required: {{error|message={{small|[error in template {{tl2|floruit}}: {{var|relevant-parameter}} 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 circa"
| |
| − | },
| |
| − | "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; works with single dates only; requires a 'date' value",
| |
| − | "type": "boolean",
| |
| − | "default": "no sorting"
| |
| − | },
| |
| − | "b": {
| |
| − | "label": "Brackets",
| |
| − | "description": "Set to \"yes\" to display output in parentheses; requires a 'date' value",
| |
| − | "type": "boolean",
| |
| − | "default": "no parentheses"
| |
| − | },
| |
| − | "wrap": {
| |
| − | "label": "Word wrap",
| |
| − | "description": "Set to \"yes\" to turn word wrap on",
| |
| − | "type": "boolean",
| |
| − | "default": "no wrap"
| |
| − | },
| |
| − | "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"
| |
| − | },
| |
| − | "sfx-lk": {
| |
| − | "label": "Suffix link",
| |
| − | "description": "Set to \"yes\" to wikilink the era suffix; requires a suffix",
| |
| − | "type": "boolean",
| |
| − | "default": "no link"
| |
| − | }
| |
| − | },
| |
| − | "description": "Formats the display of periods of activity or popularity for people, ideas, or movements",
| |
| − | "paramOrder": [
| |
| − | "date",
| |
| − | "b",
| |
| − | "ca",
| |
| − | "pfx1",
| |
| − | "pfx2",
| |
| − | "sfx",
| |
| − | "sfx-lk",
| |
| − | "sortable",
| |
| − | "wrap"
| |
| − | ],
| |
| − | "format": "inline"
| |
| − | }
| |
| − | </templatedata>
| |
| | | | |
| | ==See also== | | ==See also== |
| − | *[[Tempore]] | + | * [[Floruit]] |
| − | *{{tl|b.}} | + | * [[Circa]] |
| − | *{{tl|circa}} | + | * {{tl|Circa}} |
| − | *{{tl|reign}} | + | * {{tl|Reign}} |
| − | | |
| − | ==Footnotes==
| |
| − | {{notelist}}
| |
| | | | |
| − | <includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox|| | + | <includeonly>{{Sandbox other|| |
| | <!-- Categories go here and interwikis go in Wikidata. --> | | <!-- Categories go here and interwikis go in Wikidata. --> |
| − | [[Category:Internal link templates]]
| + | [[Category:Time and date abbreviation templates]] |
| − | [[Category:Time, date and calendar templates]] | |
| | }}</includeonly> | | }}</includeonly> |
Usage
Source: {{fl.}} 1234, {{fl.|1234}} or {{fl.|1234|lk=off}}
Result: fl. 1234, fl. 1234 or fl. 1234
This template generates an abbreviation for floruit ("fl."); by default, it has a mouse-over tooltip explaining its meaning.
Parameters
This template supports an optional (first, unnamed) parameter representing a year. For example, {{fl.|1956}} renders to give fl. 1956. This differs from {{fl.}} 1956 in that {{fl.|1956}} puts a non-breaking space in between the "fl." and the number, which prevents the web browsers from inserting a line break there.
If the parameter "sortable=yes" is specified, the template generates invisible text that will cause the output to work in sortable tables, at the cost of causing problems for visually-impaired readers. Compare "Col 1" and "Col 2" in the following table:
| Title |
Col 1 |
Col 2
|
| Foo |
1066 |
1066
|
| Bar |
fl. 1510 |
1510fl. 1510
|
| Baz |
1956 |
1956
|
| Jaz |
fl. 410 |
410fl. 410
|
"Col 1" uses {{Floruit}} 1510, and does not sort correctly. "Col 2" uses {{Floruit|1510|sortable=yes}}, and does sort correctly. This works because {{Floruit|1510|sortable=yes}} inserts an invisible span element at the start of the cell: <span style="display:none;">1510</span>. Although it is not rendered, it is still seen by the sorting code and makes sorting work.
The downside of this approach is that the invisible text is still rendered by screen readers that are used by visually impaired readers, and by text browsers such as Lynx, so the table will become garbled for readers who are using assistive technology or text browsers.
If the |lk= (as in "link") parameter is set to |lk=off, then the abbreviation will be rendered as fl. (without a wikilink). Otherwise, the link is displayed. (This can be used to avoid overlinking when this template is used repeatedly in the body of an article.)
Potential future parameters could add articles to appropriate categories, e.g. Category:Year of birth missing.
See also