نمایش مبدأ برای الگو:Marriage/توضیحات

This template specifies in a structured form the particulars of a [[ازدواج]]: the names of the spouses, the period of the marriage, and the location of the ceremony where the two were joined. This adds the ability to [[هم‌کنش‌پذیری]] with net applications that understand relationships between people and time and place information. For instance, seeing a 1000 foot view of a location of a wedding described in Iranpedia article is a single click away. This is possible with Google / MapQuest / Yahoo! used directly from Iranpedia articles when viewed with a [[microformat]]s aware browser. Unlike {{tl|coord}}, no intermediate jumps are necessary, and simple text descriptions may be used to describe the location. This is not limited to map applications and it is currently thought that this functionality will be standard in browsers in the 2010 time frame.  For step by step information on how to enable this functionality, [[User:J JMesserly/start-date wtf|see instructions here]]. If the individuals specified in the template consider themselves to be in a marriage as defined in the article [[ازدواج]], then this template is applicable.  

Usage: 

The template {{tlx|marriage}} would typically be in an infobox, such as in {{tlx|Infobox person}}'s spouse field. However, it may be used anywhere in an article.  

===Parameters===

{| class="wikitable"
! colspan="3" style="text-align:left;" | Parameter !! Default
|-
| width="60" style="vertical-align:top;" | Optional ||width="100" style="vertical-align:top;" align="center" | ''show'' || If present this text is displayed in place of anything else.|| align="center" style="vertical-align:top;"| &ndash;
|-
| Required || width="100" align="center" | 1 ||  Name of the person to whom the subject is married. Alias parameter: "spouse". || align="center" style="vertical-align:top;"| &ndash;
|-
| Required || width="100" align="center" | 2 ||  Date the marriage began. Alias parameter: "date". || align="center" style="vertical-align:top;"| &ndash;
|-
| Optional || width="100" align="center" | 3 ||  Date the marriage was dissolved or one of the spouses died. Alias parameter: "end". || align="center" style="vertical-align:top;"| –
|-
| Optional || width="100" align="center" | ''reason'' || Reason for the end of marriage. Should be one of "divorced" or "widowed". || align="center" style="vertical-align:top;"| –
|-
| Optional ||width="100" align="center"| ''spouse2'' ||  Name of the second person that appears in the Marriage description. If omitted, the name of the article is assumed to refer to this person. || align="center" style="vertical-align:top;"| article name
|-
| colspan=4 align="center" | '''Location of the ceremony''' (optional; a wide variety of location information may be specified in any combination).
|-
| style="vertical-align:top;" | Optional || style="vertical-align:top;" align="center" | ''locality1''         || Catch-all specifier for any location. Examples: a building, facility, square, county, mountain, valley. Any geographical area or locality in which the named item is physically located or with which it is associated in some other important way. (Also supports locality2 & locality3.)  ||align="center" style="vertical-align:top;"| &ndash;
|-
| style="vertical-align:top;" | Optional ||style="vertical-align:top;" align="center" | ''street-address1''    || First street address line. (3 lines supported, named street-address2... and so on.) ||align="center" style="vertical-align:top;"| &ndash;
|-
| style="vertical-align:top;" | Optional ||style="vertical-align:top;";" align="center"| ''city'' ''town''     || (Aliases) Same as locality.  ||align="center" style="vertical-align:top;"| &ndash;
|-
| style="vertical-align:top;" | Optional ||align="center" style="vertical-align:top;"| ''region''  || State, province, department, oblast, or other subnational governmental unit. ||align="center" style="vertical-align:top;"| &ndash;
|-
| style="vertical-align:top;" | Optional ||style="vertical-align:top;"" align="center"| ''state''        || (Alias) Same as region.  ||align="center" style="vertical-align:top;"| &ndash;
|-
| style="vertical-align:top;" | Optional ||style="vertical-align:top;"" align="center"| ''province''        || (Alias) Same as region.  ||align="center" style="vertical-align:top;"| &ndash;
|-
| style="vertical-align:top;" | Optional ||align="center" style="vertical-align:top;"| ''country-name''  || Country. ||align="center" style="vertical-align:top;"| &ndash;
|-
| Optional ||width="100" align="center"| ''uncertain'' || If set to "y", the location is to be interpreted as "in the vicinity of", rather than to be regarded as a precise point. (Class assigned: "label".)  ||align="center" style="vertical-align:top;"| &ndash;
|-
| Optional ||width="100" align="center"| ''lat'' || Latitude. Numeric decimal value only, no compass directions. [[سامانه ژئودتیک جهانی ۱۹۸۴]] values. Used for the purpose of exporting [[Geo (microformat)|geo]] values as part of the [[hCard]]. Users that don't understand why they would want to do that should use {{tl|coord}} instead. ||align="center" style="vertical-align:top;"| &ndash;
|-
| Optional ||width="100" align="center"| ''lon'' || Longitude. Numeric decimal value only, no compass directions. ||align="center" style="vertical-align:top;"| &ndash;
|}

==Example usage==

The typical use of {{tlx|marriage}} is to specify a spouse in an article. See: [[جوزف نیدهام]], spouse parameter:
:<code><nowiki>{{marriage|Lu Gwei-Djen|1989|1991}}</nowiki></code>
::'''Full dates are supported in any format with standard output as years only'''
:<code><nowiki>{{marriage|Michelle Obama|October 3, 1992}}</nowiki></code> produces {{marriage|Michelle Obama|October 3, 1992}}

Example demonstrating multiple options:
<pre style="overflow:scroll;">{{marriage|Michelle Obama|October 3, 1992|show=[[میشل اوباما]] <small>(m. 1992)</small>|spouse2=Barack Obama
|street-address1=Trinity United Church of Christ|street-address2=400 W. 95th Street|city=Chicago
|lat=41.7219|lon=-87.6342}}</pre>
produces {{marriage|Michelle Obama|October 3, 1992|show=[[میشل اوباما]] <small>(m. 1992)</small>|spouse2=Barack Obama|street-address1=Trinity United Church of Christ|street-address2=400 W. 95th Street|city=Chicago|lat=41.7219|lon=-87.6342}}

<includeonly>

<!-- Categories -->

{{DEFAULTSORT:{{PAGENAME}}}}
[[رده:توضیحات داده‌های الگو|{{PAGENAME}}]]
[[رده:الگو:قالب‌بندی و عملکرد ایران‌پدیا|{{PAGENAME}}]]
<!--- Interwiki --->

</includeonly>