Difference between revisions of "Template:Floruit/doc"

From blackwiki
Jump to navigation Jump to search
imported>Comp.arch
(This is used (only?) for years? Strange to have a 5-digit example then.. Forward-looking much?)
imported>Vanisaac
m (→‎See also: clean up per WP:CAT#T and WP:AWBREQ add template:Sandbox other)
 
(158 intermediate revisions by 22 users not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
 +
{{Template shortcut|fl|fl.}}
 +
 
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. -->
 
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. -->
 
==Usage==
 
==Usage==
Line 6: Line 8:
 
'''''Result:''''' {{fl.}} 1234, {{fl.|1234}} ''or'' {{fl.|1234|lk=off}}
 
'''''Result:''''' {{fl.}} 1234, {{fl.|1234}} ''or'' {{fl.|1234|lk=off}}
  
This template generates an abbreviation for [[floruit]] ("fl."), linked by default.
+
This template generates an abbreviation for [[floruit]] ("fl."); by default, it has a mouse-over tooltip explaining its meaning.
  
 
===Parameters===
 
===Parameters===
This template supports an optional (first, unnamed) parameter representing a year. For example, <code><nowiki>{{fl.|1956}}</nowiki></code> 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.
+
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.
  
 
{{Circa/doc/sortable}}
 
{{Circa/doc/sortable}}
  
If the parameter lk (for link) is set to <code>lk=off</code>, 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.)
+
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.)
  
 
Potential future parameters could add articles to appropriate categories, e.g. [[:Category:Year of birth missing]].
 
Potential future parameters could add articles to appropriate categories, e.g. [[:Category:Year of birth missing]].
 
===Redirects===
 
{{tl|Floruit}} can be replaced with the redirects:
 
* {{tl|fl.}}
 
* {{tl|flor}}
 
* {{tl|flor.}}
 
* {{tl|flr}}
 
  
 
==See also==
 
==See also==
Line 30: Line 25:
 
* {{tl|Reign}}
 
* {{tl|Reign}}
  
<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>

Latest revision as of 04:54, 25 April 2020

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