View source for Template:Circa/doc

{{Documentation subpage}}
<!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]). -->
{{High-use| 19039 }}
{{COinS safe|n|addtext=<br />The CS1 and CS2 templates have limited [[Help:Citation_Style_1#CS1_compliance_with_Wikipedia's_Manual_of_Style|support]] for <code>c.</code> as an abbreviation in the date fields.}}

==Usage==
This template generates an abbreviation for ''[[circa]]'': {{circa}} By default the abbreviation is marked with <code>&lt;abbr&gt;</code>.

===Examples===
{| class="wikitable"
|-
! Syntax
! What it looks like
! Notes
|-
| <code><nowiki>{{circa}} 1325</nowiki></code>
| {{circa}} 1325
| Default style; line break allowed between "{{circa}}" and "1325"; normal-width space
|-
| <code><nowiki>{{circa|1325}}</nowiki></code>
| {{circa|1325}}
| Default style: no line break allowed; thin space
|-
| <code><nowiki>{{circa|1325|i=yes}}</nowiki></code>
| {{circa|1325|i=yes}}
| With italic "''c.''", though italics are discouraged at [[MOS:CIRCA]]
|-
| <code><nowiki>{{circa|1325|lk=abbr}}</nowiki></code>
| {{circa|1325|lk=abbr}}
| With abbreviation marking only (default)
|-
| <code><nowiki>{{circa|1325|lk=yes}}</nowiki></code>
| {{circa|1325|lk=yes}}
| With link only
|-
| <code><nowiki>{{circa|1325|lk=no}}</nowiki></code>
| {{circa|1325|lk=no}}
| With neither link nor abbreviation marking
|-
<!-- feature not implemented
| <code><nowiki>{{circa|1350|cap=yes}}</nowiki></code>
| {{circa|1350|cap=yes}}
| Starting with capital letter
|-
-->
| <code><nowiki>{{circa|1000|1050}}</nowiki></code>
| {{circa|1000|1050}}
| For ranges
|}

===Parameters===
Using the date itself as parameter (for example, "<code><nowiki>{{circa|1956}}</nowiki></code>", giving "{{circa|1956}}"), web browsers do not insert a line break anywhere in the string. By contrast, "<code><nowiki>{{circa}} 1956</nowiki></code>" allows a line break between the "{{circa}}" and the number. Also, with the date as a parameter a thinner space is used with many browsers:

* "{{circa|1956}}" is generated by "<code><nowiki>{{circa|1956}}</nowiki></code>".
* "{{circa}} 1956" is generated by "<code><nowiki>{{circa}} 1956</nowiki></code>".

If the parameter {{para|i}} is set to a non-empty value, the "c." is put in italics: for example, "<code><nowiki>{{circa|i=''}}</nowiki></code>" generates "{{circa|i=''}}" instead of "{{circa}}".

If the parameter {{para|lk}} (for "link") is set as "{{para|lk|no}}" or "{{para|lk|off}}", the abbreviation is rendered as "{{circa|lk=no}}", without a wikilink or abbreviation element. If it is set to "{{para|lk|abbr}}", it is rendered with the abbreviation element but without the wikilink. If it is set to "{{para|lk|yes}}" or "{{para|lk|on}}", it is rendered as "{{circa|lk=yes}}", with a wikilink to the ''[[circa]]'' article and ''not'' an abbreviation element. Otherwise, the abbreviation is marked with the "<code>&lt;abbr&gt;</code>" element, as in "{{circa}}", ''and'' linked to the [[circa]] article. The <code>lk</code> parameter can be used to avoid overuse of "<code>&lt;abbr&gt;</code>" or [[WP:Overlinking|overlinking]] when this template is used repeatedly in the body of an article. For example:

* <code><nowiki>[[Dionysius Exiguus]] was born {{circa|470}}, lived in Rome from {{circa|lk=no|500}}, and died {{circa|lk=no|544}}.</nowiki></code>
*:→ [[Dionysius Exiguus]] was born {{circa|470}}, lived in Rome from {{circa|lk=no|500}}, and died {{circa|lk=no|544}}.

If the parameter "<code>cap=yes</code>" is specified, the result starts with a capital letter.

{{circa/doc/sortable}}

==See also==
*[[Tempore]]
*{{tl|Floruit}}
*{{tl|Reign}}

<includeonly>{{Sandbox other||
<!-- Categories go below this line, please; interwikis go to Wikidata, thank you! -->
[[Category:Time and date abbreviation templates]]

}}</includeonly>
<templatedata>
{
	"params": {
		"1": {
			"label": "year",
			"type": "string",
			"suggested": true
		},
		"2": {
			"label": "end year",
			"type": "string"
		},
		"sortable": {},
		"i": {
			"label": "italicize?",
			"description": "If non-empty, italicizes 'c.'",
			"example": "yes",
			"type": "string"
		},
		"lk": {
			"label": "link?",
			"description": "If 'yes' or 'on', links to 'circa' article. If 'no' or 'off', does not title 'circa'.",
			"example": "no",
			"type": "string"
		}
	},
	"paramOrder": [
		"sortable",
		"1",
		"i",
		"lk",
		"2"
	]
}
</templatedata>