پرش به محتوا

الگو: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}} ۴۶٬۳۶۰٫۶۷

ورودی نامعتبر (نمایش خطاها)

[ویرایش | اشتراک‌گذاری]
کدخروجی (نمونهٔ خطا)
{{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=، صفحه را در رده:صفحه‌های دارای خطا در الگوی تورم قرار می‌دهد:

  1. پارامتر الزامی وارد نشده — یکی از پارامترهای شاخص، مقدار یا سال آغاز خالی است.
  2. شاخص ناشناخته — کد کشور وارد شده در فهرست شاخص‌های شناخته‌شده نیست.
  3. داده‌های غیرعددی — یکی از پارامترهای عددی یک عدد معتبر نیست.
  4. مقدار خارج از مرز — سال آغاز یا پایان خارج از بازهٔ قابل محاسبه برای آن شاخص است.

جستارهای وابسته

[ویرایش | اشتراک‌گذاری]
  • {{Inflation/year}} — برمی‌گرداند جدیدترین سال در دسترس برای یک شاخص.
  • {{Inflation-year}} — همان، با قالب‌بندی متفاوت.
  1. ↑ «اخیراً» بسته به این که جدول داده برای هر کشور چگونه ساخته شده و آیا جدول‌های درونی هر ژانویه به‌روز شده‌اند بستگی دارد.