الگو:Inflation
| این الگو از ویژگی و دستورهای پیچیده استفاده میکند.
توصیه میشود پیش از ویرایش الگو با دستورهای الگو و توابع تجزیهکننده آشنا شوید. اگر ویرایشتان باعث بروز مشکلات غیرمنتظره شد، خواهشمند است آن را بهسرعت برگردانید، زیرا ممکن است این الگو در شمار زیادی صفحه ظاهر شود. بهیاد داشته باشید که شما میتوانید آزمایش انجام دهید، اما باید همهٔ بهسازیها را پیش از آنکه در اینجا اعمال کنید، در هر دو صفحهٔ تمرین و آزمایشی یا فضای کاربریتان بیازمایید. |
این الگو با گرفتن یک کد کشور (مانند US برای ایالات متحده آمریکا یا UK برای بریتانیا)، یک مقدار به پول رایج آن کشور، و یک سال آغاز، نرخ تورم را با استفاده از شاخص قیمت مصرفکننده آن کشور تا «اخیراً» اعمال میکند.[۱]
این الگو معادل Template:Inflation در ویکیپدیای انگلیسی است. دقت کنید که پروندههای دادهٔ مورد نیاز برای کشور مورد نظر، باید همانند آنچه در اینجا میبینید، بهصورت زیرصفحههای این الگو بر حسب کد کشور (پارامتر اول الگو) موجود باشند.
کاربرد
[ویرایش | اشتراکگذاری]نحو
[ویرایش | اشتراکگذاری]{{Inflation|country_code|value|start_year|r=digit}}
{{Inflation|country_code|value|start_year|end_year|r=digit}}
یا با نامهای فارسی پارامترها:
{{Inflation|شاخص=کد کشور|مقدار=مقدار|سال آغاز=سال آغاز|گرد=رقم}}
پارامترها
[ویرایش | اشتراکگذاری]|۱=/|index=/|شاخص=(اجباری) — کد کشور یا شاخص؛ برای فهرست کامل به جدول زیر نگاه کنید.|۲=/|value=/|مقدار=(اجباری) — مقدار پولی به ارز آن کشور.|۳=/|start_year=/|سال آغاز=(اجباری) — سال آغاز محاسبه.|۴=/|end_year=/|سال پایان=(اختیاری) — سال پایان محاسبه؛ پیشفرض بالاترین سال در دسترس شاخص.|r=/|گرد=— رقم گرد کردن نتیجه؛ پیشفرض0(بدون رقم اعشار).|fmt=/|فرمت=— قالب خروجی؛raw(پیشفرض)،eq(برابر با …) یامعادل.|orig=/|اولیه=— اگرyesیابلهباشد، مقدار اصلی هم در پرانتز نمایش داده میشود.|cursign=/|نماد ارز=— نماد ارز؛ پیشفرض$.|nocat=/|بیرده=— اگر مقدار داده شود، خطاها در ردههای ردیابی قرار نمیگیرند (برای صفحههای توضیحات و آزمایش).
کدهای کشور پشتیبانیشده
[ویرایش | اشتراکگذاری]کشورهایی که دارای جدول دادهٔ کامل (هم الگو:Inflation/XX هم الگو:Inflation/XX/dataset) هستند و الگو میتواند برای آنها محاسبه انجام دهد:
| نام کشور | کد کشور | کمینهٔ |سال آغاز= |
|---|---|---|
| استرالیا | AU | ۱۹۰۱ |
| کانادا | CA | ۱۹۱۶ |
| آلمان | DE | ۱۸۸۲ |
| هند | IN | ۱۹۵۸ |
| ایران | IR | ۱۳۱۵ |
برای کشورهای دیگر تنها زیرصفحهٔ /startyear روی ویکیپدیای فارسی موجود است؛ پیش از اضافهکردن پشتیبانی کامل برای کشور جدید، باید دادگان آن از ویکیپدیای انگلیسی واردات شوند.
|end_year=اگر داده شود، باید بزرگتر (دیرتر) از|start_year=باشد ولی بیشتر از بزرگترین سال موجود در شاخص نباشد.|r=رقم گرد کردن مقدار را تعیین میکند؛ اگر داده نشود، به0(بدون اعشار) پیشفرض میشود. برای جزئیات بیشتر به بخش نکتهها در پایین نگاه کنید.
نمونهها
[ویرایش | اشتراکگذاری]کاربرد درست
[ویرایش | اشتراکگذاری]| کد | خروجی |
|---|---|
{{Inflation|DE|1000000|2000}} |
۱٬۱۷۰٬۶۷۷ |
{{Inflation|IR|1000|1380|1400}} |
۴۶٬۳۶۱ |
{{Inflation|US|1000000|1990|2005|r=2}} |
۱٬۴۹۴٬۹۰۵٫۷۶ |
{{Inflation|UK|1000000|1323|1978|r=-3}} |
۱۴۰٬۱۰۸٬۰۰۰ |
{{Inflation|IR|1000|1380|1400|نماد ارز=ریال}} |
۴۶٬۳۶۱ |
{{Inflation|شاخص=IR|مقدار=1000|سال آغاز=1380|سال پایان=1400|گرد=2}} |
۴۶٬۳۶۰٫۶۷ |
ورودی نامعتبر (نمایش خطاها)
[ویرایش | اشتراکگذاری]توجه: نمونههای زیر عمداً نادرستاند تا نشان دهند الگو در صورت ورودی نامعتبر چه پیامی نمایش میدهد. خطاهایی که در ستون «خروجی» میبینید بخشی از سند آموزشاند، نه نقصی در الگو. همگی با nocat=1 صدا زده شدهاند تا صفحهٔ توضیحات در رده ردیابی خطا قرار نگیرد. |
| کد | خروجی (نمونهٔ خطا) |
|---|---|
{{Inflation|nocat=1}} |
خطا هنگام استفاده از {{تورم}}: وارد کردن |شاخص= (پارامتر ۱)، |مقدار= (پارامتر ۲) و |سال آغاز= (پارامتر ۳) الزامی است. |
{{Inflation|abc|nocat=1}} |
خطا هنگام استفاده از {{تورم}}: وارد کردن |مقدار= (پارامتر ۲) و |سال آغاز= (پارامتر ۳) الزامی است. |
{{Inflation|DE|1000000|nocat=1}} |
خطا هنگام استفاده از {{تورم}}: وارد کردن |سال آغاز= (پارامتر ۳) الزامی است. |
{{Inflation|US|1000000|1200|3000|nocat=1}} |
خطا هنگام استفاده از {{تورم}}: |سال آغاز=1200 (پارامتر ۳) کوچکتر از قدیمیترین سال در دسترس (۱۶۳۴) در شاخص «US» است و |سال پایان=3000 (پارامتر ۴) بزرگتر از بالاترین سال در دسترس (۲۰۲۵) در شاخص «US» است. |
{{Inflation|UK|1000000|2005|2004|nocat=1}} |
خطا هنگام استفاده از {{تورم}}: |سال آغاز=2005 (پارامتر ۳) بزرگتر از |سال پایان=2004 (پارامتر ۴). |
نکتهها
[ویرایش | اشتراکگذاری]تبدیل ارز
[ویرایش | اشتراکگذاری]این الگو مستقل از ارز است، یعنی خودکار میان ارزهای مختلف تبدیل نمیکند. برای نمونه اگر بخواهید بدانید ۱٬۰۰۰ مارک آلمان در سال ۱۹۶۰ امروز چقدر میارزد، فراخوانی {{Inflation|DE|1000|1960|r=2}} نتیجهای (۴٬۰۶۲٫۹۳) را همچنان به مارک باز میگرداند، نه یورو. در صورت نیاز به تبدیل ارز، باید آن را بهصورت دستی انجام دهید.
گرد کردن
[ویرایش | اشتراکگذاری]پارامتر |r= / |گرد= رقم گرد کردن را تعیین میکند:
r=0— به نزدیکترین عدد صحیح گرد میشود (پیشفرض)r=2— تا دو رقم اعشار گرد میشودr=-3— تا نزدیکترین هزار گرد میشود
پنهان کردن رده ردیابی خطا
[ویرایش | اشتراکگذاری]هنگام آزمایش یا توضیح خطاها در صفحههای مستندات، میتوانید با افزودن |nocat=1 یا |بیرده=1 از قرار گرفتن صفحه در رده ردیابی خطا جلوگیری کنید.
خطاهای ممکن
[ویرایش | اشتراکگذاری]این الگو خطاهای زیر را بهصورت قابلخوانش تولید میکند و در صورت نبود |nocat=، صفحه را در رده:صفحههای دارای خطا در الگوی تورم قرار میدهد:
- پارامتر الزامی وارد نشده — یکی از پارامترهای شاخص، مقدار یا سال آغاز خالی است.
- شاخص ناشناخته — کد کشور وارد شده در فهرست شاخصهای شناختهشده نیست.
- دادههای غیرعددی — یکی از پارامترهای عددی یک عدد معتبر نیست.
- مقدار خارج از مرز — سال آغاز یا پایان خارج از بازهٔ قابل محاسبه برای آن شاخص است.
رده ردیابی
[ویرایش | اشتراکگذاری]جستارهای وابسته
[ویرایش | اشتراکگذاری]- {{Inflation/year}} — برمیگرداند جدیدترین سال در دسترس برای یک شاخص.
- {{Inflation-year}} — همان، با قالببندی متفاوت.
منابع
[ویرایش | اشتراکگذاری]- ↑ «اخیراً» بسته به این که جدول داده برای هر کشور چگونه ساخته شده و آیا جدولهای درونی هر ژانویه بهروز شدهاند بستگی دارد.