عبد العزيز: /* بيانات القالب */تنسيق ويكي - إزالة الفراغات الزائدة من القوالب

2023-09-13T10:44:20Z

بيانات القالب: تنسيق ويكي - إزالة الفراغات الزائدة من القوالب

→ نسخة أقدم	نسخة 14:44، 13 سبتمبر 2023
(لا فرق)

عبد العزيز: /* بيانات القالب */تنسيق ويكي - إزالة الفراغات الزائدة من القوالب

2023-09-13T10:44:20Z

بيانات القالب: تنسيق ويكي - إزالة الفراغات الزائدة من القوالب

صفحة جديدة

{{صفحة توثيق فرعية}}
{{Lua|Module:Currency|Module:Currency/Presentation}}
{{Lua sidebar}}


Formats a currency value with the appropriate symbol which is linked to the article about the currency. If no currency is specified, the template will show the amount in [[دولار أمريكي|United States dollars]].

== الاستخدام ==
Using unnamed parameters:
:<code><nowiki>{{</nowiki>currency|{{Var|value}}|{{Var|code}}|first=|linked=|fmt=|passthrough=}}</code>
Using named parameters:
:<code><nowiki>{{</nowiki>currency|amount={{Var|value}}|code={{Var|code}}|first=|linked=|passthrough=}}</code>
where:
:{{Var|value}} is a number with or without comma separators; may be followed by an optional quantifier: 'thousand', 'million', 'M', 'billion', 'B', or 'trillion'
:{{Var|code}} is an [[أيزو 4217|ISO 4217 currency code]] or one of the supported non-standard codes listed below
:{{وسيط|first}} when set to any value produces a long-form currency name
:{{وسيط|linked}} when set to <code>no</code> disables wikilinks on the rendered currency symbol or long-form currency name
:{{وسيط|fmt}} specifies how {{Var|value}} digit-groups are separated:
::<code>commas</code> (default) separates {{Var|value}} digit-groups with commas; this is the default, same as when {{وسيط|fmt}} is empty or omitted
::<code>gaps</code> separates {{Var|value}} digit-groups with narrow gaps
::<code>none</code> renders {{Var|value}} without digit grouping
Note: Using both named and unnamed parameters may produce unexpected results. In this example, the template expects the first unnamed parameter to be a value number:
::<code><nowiki>{{Currency|amount=1000|GBP}}</nowiki></code>
:::{{Currency|amount=1000|GBP}}
:{{وسيط|passthrough}} specifies whether or not the template should attempt to parse the number according to {{وسيط|fmt}} or just put whatever string is provided in {{وسيط|amount}} directly after the currency sign. Should have value of either {{وسيط|passthrough|yes}} or {{وسيط|passthrough|no}}

When using parameter names, {{وسيط|amount}} and {{وسيط|code}} are preferred. The template will also accept {{وسيط|Amount}} and {{وسيط|type}} and {{وسيط|Type}}, though.

== Supported non-standard currency codes ==
=== Codes that can be translated to ISO 4217 currencies ===
These non-standard codes are aliases of standard [[أيزو 4217]] codes.
{{Div col|colwidth=15em}}
*EGE
*EU
*EURO
*FRW
*KSH
*NEP
*POUND
*POUND STERLING
*RMB
*TSH
*UK
* الولايات المتحدة
* الولايات المتحدة
*U.S.
*USA
*USH
{{Div col end}}

=== Other non-standard codes ===
These codes either do not have a matching ISO 4217 currency code or are alternate versions of existing ISO 4217 codes or support unique aspects of a currency.

* BITCOIN – no matching ISO 4217 code
* BTC – no matching ISO 4217 code
* DKK2 – alternate version of DKK
* FRF – historical
* GRD – historical
* LSL2 – plural version of LSL
* LTL – historical
* NOK2 – alternate version of NOK
* SEK2 – alternate version of SEK
* SZL2 – plural version of SZL
* الولايات المتحدة$ - special case: like the standard codes "USD" (and "$"), but only displays "$" instead of the longer "US$" (for articles where displaying "US$" might appear inappropriately long, but the template should still link to "United States dollar" to avoid any ambiguity)
* XBT – no matching ISO 4217 code

== أمثلة ==
Currencies other than the [[دولار أمريكي]] can be rendered by using the appropriate [[أيزو 4217|ISO 4217 currency code]]
*<code><nowiki>{{Currency|1000|BMD}}</nowiki></code> ينتج ← {{Currency|1000|BMD}} for the [[دولار برمودي]]
*<code><nowiki>{{Currency|1000|BDT}}</nowiki></code> ينتج ← {{Currency|1000|BDT}} for the [[تاكا بنغلاديشي]]
*<code><nowiki>{{Currency|1000|AMD}}</nowiki></code> ينتج ← {{Currency|1000|AMD}} for the [[درام أرميني]]

Some of the more well known currencies also provide the ability to use common abbreviations or full names.
*<code><nowiki>{{Currency|1000|US}}</nowiki></code> ينتج ← {{Currency|1000|us}}
*<code><nowiki>{{Currency|1000|United States}}</nowiki></code> ينتج ← {{Currency|1000|United States}}
*<code><nowiki>{{Currency|1,000|JPY}}</nowiki></code> ينتج ← {{Currency|1,000|JPY}}

Parameter names can also be used, if preferred:
*<code><nowiki>{{Currency|amount=1000|code=US}}</nowiki></code> ينتج ← {{Currency|amount=1000|code=US}}
*<code><nowiki>{{Currency|1000|code=euro}}</nowiki></code> ينتج ← {{Currency|1000|code=euro}}

Negative amount:
*<code><nowiki>{{Currency|amount=-1000|code=US}}</nowiki></code> ينتج ← {{Currency|amount=-1000|code=US}}

Text quantifiers:
*<code><nowiki>{{Currency|1000 million|code=euro}}</nowiki></code> ينتج ← {{Currency|1000 million|code=euro}}
*<code><nowiki>{{Currency|1000M|code=euro}}</nowiki></code> ينتج ← {{Currency|1000M|code=euro}}

The first use of a currency should show the value and the full name of the currency, so if the "first" parameter is defined then that is what will be given.
*<code><nowiki>{{Currency|1000|cve|first=yes}}</nowiki></code> ينتج ← {{Currency|1000|cve|first=yes}}
*<code><nowiki>{{Currency|1000|cve}}</nowiki></code> ينتج ← {{Currency|1000|cve}}

Because the symbol for the currencies DKK, NOK, and SEK may be ambiguous, these may be represented in two ways:
*For DKK:
*:<code><nowiki>{{Currency|1000|dkk}}</nowiki></code> ينتج ← {{Currency|1000|dkk}}
*:<code><nowiki>{{Currency|1000|dkk2}}</nowiki></code> ينتج ← {{Currency|1000|dkk2}}
*For NOK:
*:<code><nowiki>{{Currency|1000|NOK}}</nowiki></code> ينتج ← {{Currency|1000|NOK}}
*:<code><nowiki>{{Currency|1000|NOK2}}</nowiki></code> ينتج ← {{Currency|1000|NOK2}}
*For SEK:
*:<code><nowiki>{{Currency|1000|SEK}}</nowiki></code> ينتج ← {{Currency|1000|SEK}}
*:<code><nowiki>{{Currency|1000|SEK2}}</nowiki></code> ينتج ← {{Currency|1000|SEK2}}

Similarly, some currencies use different symbols for single and plural amounts:
*:<code><nowiki>{{Currency|1|LSL}}</nowiki></code> ينتج ← {{Currency|1|LSL}}
*:<code><nowiki>{{Currency|1000|LSL2}}</nowiki></code> ينتج ← {{Currency|1000|LSL2}}
*::''The template does not currently make this distinction automatically so it is the responsibility of the editor using these kinds of codes to get the code right.''

Digit grouping:
*{{وسيط|fmt|commas}}
*:<code><nowiki>{{Currency|1000 million|code=euro|fmt=commas}}</nowiki></code> ينتج ← {{Currency|1000 million|code=euro|fmt=commas}}
*{{وسيط|fmt|gaps}}
*:<code><nowiki>{{Currency|1000 million|code=euro|fmt=gaps}}</nowiki></code> ينتج ← {{Currency|1000 million|code=euro|fmt=gaps}}
*{{وسيط|fmt|none}}
*:<code><nowiki>{{Currency|1000 million|code=euro|fmt=none}}</nowiki></code> ينتج ← {{Currency|1000 million|code=euro|fmt=none}}

Passthrough:
*{{وسيط|passthrough|yes}}
*:<code><nowiki>{{Currency|6 million|PHP|passthrough=yes}}</nowiki></code> ينتج ← {{Currency|6 million|PHP|passthrough=yes}}
*:<code><nowiki>{{Currency|6 trillion|PHP|passthrough=yes}}</nowiki></code> ينتج ← {{Currency|6 trillion|PHP|passthrough=yes}}
*:<code><nowiki>{{Currency|6 tn|PHP|passthrough=yes}}</nowiki></code> ينتج ← {{Currency|6 tn|PHP|passthrough=yes}}
*{{وسيط|passthrough|no}}
*:<code><nowiki>{{Currency|6 million|PHP|passthrough=no}}</nowiki></code> ينتج ← {{Currency|6 million|PHP|passthrough=no}}
*:<code><nowiki>{{Currency|6 trillion|PHP|passthrough=no}}</nowiki></code> ينتج ← {{Currency|6 trillion|PHP|passthrough=no}}
*:<code><nowiki>{{Currency|6 tn|PHP|passthrough=no}}</nowiki></code> ينتج ← {{Currency|6 tn|PHP|passthrough=no}} (error expected, as template doesn't know how to parse {{كود|6 tn}} to {{كود|6,000,000,000,000}})
*''Use sparingly! Usually you want {{وسيط|fmt}} instead. {{وسيط|passthrough}} should only be used in ways compatible with [[MOS:CURRENCY]].''

== Error messages ==
{{Tlc|currency}} can produce several error message. These are:
*<nowiki>{{Currency}}</nowiki> – invalid code – the value in the second unnamed parameter or assigned to {{وسيط|code}} cannot be found in the template's list of codes. Make sure that the assigned code is a correct ISO 4217 currency code or one of the supported non-standard codes listed above.
*<nowiki>{{Currency}}</nowiki> – invalid amount – the value in the first unnamed parameter or assigned to {{وسيط|amount}} contains one or more characters that is not a minus sign, a digit, comma, or decimal point, or has some text that is not one of the permitted quantifiers. Make sure that comma separators group three digits and that the number has only one decimal point. Make sure that the amount and code parameters are either both named ({{وسيط|amount}} and {{وسيط|code}}) or both unnamed.
*<nowiki>{{Currency}}</nowiki> – definition missing position – an internal error that should only occur when an editor is mucking about in [[وحدة:Currency/Presentation]]. It indicates that [[وحدة:Currency]] doesn't know where to place the currency's symbol in relation to its value.
*<nowiki>{{Currency}}</nowiki> – definition missing page – an internal error that should only occur when an editor is mucking about in Module:Currency/Presentation. It indicates that Module:Currency doesn't have a page that it can use to link the currency's symbol or name.

== بيانات القالب ==
{{رأس بيانات القالب}}
<templatedata>
{
"format": "inline",
"params": {
"1": {
"aliases": [
"amount",
"Amount"
],
"label": "Amount",
"description": "The value in the given currency",
"required": true,
"type": "line"
},
"2": {
"aliases": [
"code",
"type",
"Type"
],
"label": "Currency",
"description": "The currency represented. Should be a valid ISO 4217 code or one of the special codes listed on the template’s page",
"example": "USD",
"default": "USD",
"suggested": true,
"type": "line"
},
"first": {
"label": "Long form",
"description": "When set to any value, produces a long-form currency name. This should be used for the first mention of a currency within the article",
"type": "line"
},
"linked": {
"label": "Link currency",
"description": "Whether to link to the article on that currency. “no” suppresses the link, any other value displays it",
"example": "no",
"default": "yes",
"type": "line"
},
"fmt": {
"label": "Format",
"description": "Specifies how value digit-groups are separated: commas, gaps or none",
"example": "gaps",
"default": "commas",
"type": "line"
},
"passthrough": {
"label": "Passthrough",
"description": "If \"yes\", put the string in Amount directly after its symbol without turning it into a number.",
"example": "yes",
"default": "no",
"type": "line"
}
}
}
</templatedata>

== طالع أيضاً ==
* [[أرابيكا:Manual of Style (dates and numbers)#Currencies]] for important usage pattern instructions.
* {{قا|Formatprice}}, a template that handles rounding and "big number" formatting
* {{قا|تضخم}}, a template that adjusts historical costs to current (or other-year) equivalent value
* {{Tlx|ص.م عملة}}
<includeonly>{{ملعب أخر||
[[تصنيف:قوالب عملات]]
[[تصنيف:قوالب مالية]]

}}</includeonly>

قالب:Currency/شرح - تاريخ المراجعة

عبد العزيز: /* بيانات القالب */تنسيق ويكي - إزالة الفراغات الزائدة من القوالب

عبد العزيز: /* بيانات القالب */تنسيق ويكي - إزالة الفراغات الزائدة من القوالب