قالب:Circa/doc
This is a documentation subpage for قالب:Circa. It may contain usage information, categories and other content that is not part of the original قالب page. |
This template is used on 61,000+ pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
This template should not be used in citation templates such as Citation Style 1 and Citation Style 2, because it includes markup that will pollute the COinS metadata they produce; see Wikipedia:COinS. |
Usage
تعديلThis template generates an abbreviation for circa: حوالى By default the abbreviation is marked with <abbr>
.
Examples
تعديلSyntax | What it looks like | Notes |
---|---|---|
{{Circa}} 1325
|
حوالى 1325 | Default style; line break allowed between "حوالى" and "1325"; normal-width space |
{{Circa|1325}}
|
حوالى 1325 | Default style: no line break allowed; thin space |
{{Circa|1325|i=yes}}
|
حوالى 1325 | With italic "c.", though italics are discouraged at WP:YEAR |
{{Circa|1325|lk=abbr}}
|
حوالى 1325 | With abbreviation marking only (default) |
{{Circa|1325|lk=yes}}
|
حوالى 1325 | With link only |
{{Circa|1325|lk=no}}
|
حوالى 1325 | With neither link nor abbreviation marking |
{{Circa|1350|cap=yes}}
|
حوالى 1350 | Starting with capital letter |
{{Circa|1000|1050}}
|
حوالى 1000 – ح. 1050 | For ranges |
{{c.|1325}}
|
حوالى 1325 | Shorthand for {{Circa|1325|lk=no}}
|
{{c.|1000|1050}}
|
حوالى 1000 – ح. 1050 | Shorthand for {{Circa|1000|1050|lk=no}}
|
Parameters
تعديلUsing the date itself as parameter (for example, "{{Circa|1956}}
", giving "حوالى 1956"), web browsers do not insert a line break anywhere in the string. By contrast, "{{Circa}} 1956
" allows a line break between the "حوالى" and the number. Also, with the date as a parameter a thinner space is used with many browsers:
- "حوالى 1956" is generated by "
{{Circa|1956}}
". - "حوالى 1956" is generated by "
{{Circa}} 1956
".
If the parameter |i=
is set to a non-empty value, the "c." is put in italics: for example, "{{Circa|i=''}}
" generates "حوالى" instead of "حوالى".
If the parameter |lk=
(for "link") is set as "|lk=no
" or "|lk=off
", the abbreviation is rendered as "حوالى", without a wikilink or abbreviation element. If it is set to "|lk=abbr
", it is rendered with the abbreviation element but without the wikilink. If it is set to "|lk=yes
" or "|lk=on
", it is rendered as "حوالى", with a wikilink to the Circa article and not an abbreviation element. Otherwise, the abbreviation is marked with the "<abbr>
" element, as in "حوالى", and linked to the Circa article. The lk
parameter can be used to avoid overuse of "<abbr>
" or overlinking when this template is used repeatedly in the body of an article. A convenient way of doing this is to use {{Circa}} the first time, and {{c.}} thereafter. For example:
[[Dionysius Exiguus]] was born {{Circa|470}}, lived in Rome from {{c.|500}}, and died {{c.|544}}.
- → Dionysius Exiguus was born حوالى 470, lived in Rome from حوالى 500, and died حوالى 544.
If the parameter "cap=yes
" is specified, the result starts with a capital letter.
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 | حوالى 1510 | 1510 حوالى |
Baz | 1956 | 1956 |
"Col 1" uses {{Circa}} 1510
, and does not sort correctly. "Col 2" uses {{Circa|1510|sortable=yes}}
, and does sort correctly. This works because {{Circa|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.