Nwuan a̱tyin ka a li Ta‌̱mpi‌̱let: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}}
{{COinS safe|n|addtext=<br />The CS1 and CS2 templates have limited [[Help:Citation_Style_1#Date_format_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 ''[[wikt:circa#English|circa]]'': {{circa}} By default the abbreviation is marked with an HTML <code>&lt;abbr&gt;</code> tag, which in most browsers renders as a [[tooltip]] when hovered.

===Examples===
{| class="wikitable"
|-
! Syntax
! What it looks like
! Notes
|-
| <code><nowiki>{{circa|1325}}</nowiki></code>
| {{circa|1325}}
| Default style: no line break allowed; thin space
|-
| <code><nowiki>{{circa|1325|lk=yes}}</nowiki></code>
| {{circa|1325|lk=yes}}
| Replace abbreviation tooltip with a link to Wiktionary instead 
|-
| <code><nowiki>{{circa|1325|lk=no}}</nowiki></code>
| {{circa|1325|lk=no}}
| No abbreviation tooltip at all
|-
| <code><nowiki>{{circa|1000|1050}}</nowiki></code>
| {{circa|1000|1050}}
| For a range with both dates uncertain. No tooltip on the second instance of "c."
|-
| <code><nowiki>{{circa|1000–1050}}</nowiki></code>
| {{circa|1000–1050}}
| Another option for a range; but, per [[MOS:CIRCA]], prefer <code><nowiki>{{circa|1000|1050}}</nowiki></code> 
|}

===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|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 absent, or set to "{{para|lk|abbr}}", the abbreviation is rendered with the HTML <code>&lt;abbr&gt;</code> element. If it is set to "{{para|lk|yes}}" or "{{para|lk|on}}", it is rendered as "{{circa|lk=yes}}", with a wikilink to the ''[[:wikt:circa]]'' article in Wiktionary and ''not'' an abbreviation element. <code>lk=no</code> can be used to avoid [[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}}.

{{circa/doc/sortable}}

==Tracking categories==
*{{clc|Pages using circa with unknown parameters}}

==See also==
*{{tl|Born in}}
*{{tl|Died in}}
*{{tl|Floruit}}
*{{tl|Married in}}
*{{tl|Reign}}
*[[Tempore]]

==TemplateData==
{{templatedata header}}
<templatedata>
{
	"params": {
		"1": {
			"label": "year",
			"type": "string",
			"suggested": true,
			"description": "An approximate date",
			"example": "1965"
		},
		"2": {
			"label": "end year",
			"type": "string",
			"description": "Use when the start and end dates of a range are both approximate.",
			"example": "1980"
		},
		"sortable": {
			"label": "sortable",
			"description": "Set to “yes” for values in sortable tables",
			"suggestedvalues": [
				"yes"
			],
			"default": "yes"
		},
		"lk": {
			"label": "link",
			"description": "If ‘on’, a link is added to the wiktionary article for circa. If ‘off’, the c. does not link or tooltip “circa”. Should be set to ‘off’ for the second and subsequent uses of this template. (Values ‘yes’ or ‘no’ may also be used.)",
			"type": "string",
			"suggestedvalues": [
				"on",
				"off"
			]
		}
	},
	"paramOrder": [
		"1",
		"2",
		"lk",
		"sortable"
	],
	"description": "This template generates an abbreviation for circa."
}
</templatedata>

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

}}</includeonly>