Fyrimynd:Circa/doc
Hetta er ein dokumentatión undirsíða til Fyrimynd:Circa. Hon inniheldur kunning um nýtsluna, bólkar og um annað innihald, ið ikki er við í uppruna fyrimynd síðuni. |
Henda fyrimynd verður nýtt á nógvum síðum, so broytingar á síðuni verða lagdar til merkis víða. Vinarliga royn broytingarnar á tíni egnu sandkassa-síðu ella á /sandbox ella /testcases undirsíðum hjá fyrimyndini, ella í einari brúkaraundirsíðu, og umhugsa at kjakast um broytingar á kjaksíðuni áðrenn tú goymir broytingarnar á sjálvari fyrimyndini. |
Henda fyrimynd eigur ikki at verða nýtt í sitat-fyrimyndum sum t.d. Citation Style 1 og Citation Style 2, av tí at tað inniheldur merking ið oyðileggur COinS metadata, ið tey framleiða; sí COinS in Wikipedia. The CS1 and CS2 templates support c. as an abbreviation in the date fields. |
Nýtsla
rættaThis template generates an abbreviation for circa: uml. By default the abbreviation is marked with <abbr>
.
Dømi
rættaSyntax | What it looks like | Notes |
---|---|---|
{{Circa}} 1325
|
uml. 1325 | Default style; line break allowed between "uml." and "1325"; normal-width space |
{{Circa|1325}}
|
uml. 1325 | Default style: no line break allowed; thin space |
{{Circa|1325|i=yes}}
|
uml. 1325 | With italic "c.", though italics are discouraged at WP:YEAR |
{{Circa|1325|lk=abbr}}
|
uml. 1325 | With abbreviation marking only (default) |
{{Circa|1325|lk=yes}}
|
uml. 1325 | With link only |
{{Circa|1325|lk=no}}
|
Uml. 1325 | With neither link nor abbreviation marking |
{{Circa|1350|cap=yes}}
|
uml. 1350 | Starting with capital letter |
{{Circa|1000|1050}}
|
uml. 1000 – c. 1050 | For ranges |
{{c.|1325}}
|
Uml. 1325 | Shorthand for {{Circa|1325|lk=no}}
|
{{c.|1000|1050}}
|
Uml. 1000 – c. 1050 | Shorthand for {{Circa|1000|1050|lk=no}}
|
Parameters
rættaUsing the date itself as parameter (for example, "{{Circa|1956}}
", giving "uml. 1956"), web browsers do not insert a line break anywhere in the string. By contrast, "{{Circa}} 1956
" allows a line break between the "uml." and the number. Also, with the date as a parameter a thinner space is used with many browsers:
- "uml. 1956" is generated by "
{{Circa|1956}}
". - "uml. 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 "uml." instead of "uml.".
If the parameter |lk=
(for "link") is set as "|lk=no
" or "|lk=off
", the abbreviation is rendered as "Uml.", 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 "uml.", with a wikilink to the Circa article and not an abbreviation element. Otherwise, the abbreviation is marked with the "<abbr>
" element, as in "uml.", 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 uml. 470, lived in Rome from Uml. 500, and died Uml. 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 | uml. 1510 | 1510 | uml.
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.