پرش به محتوا

ویکی‌پدیا:الگوداده

از ویکی‌پدیا، دانشنامهٔ آزاد
(تغییرمسیر از ویکی‌پدیا:TemplateData)

الگوداده چیست؟

[ویرایش]

الگوداده توضیحات استاندارد شدۀ از یک الگو است، که در ویرایشگر دیداری به صورت پیش‌فرض، و در ویرایشگر ویکی‌متن ۲۰۱۷ و ابزارهای دیگر به‌ صورت اختیاری برای بهبود تجربۀ ویرایش-الگو برای کاربر استفاده می‌شود. هم ویرایشگر دیداری و هم ویرایشگر ویکی‌متن ۲۰۱۷ دارای یک برنامۀ جادویی برای ویرایش الگو هستند، اما برای اینکه برنامۀ جادویی بیشتر کاربردی باشد، نیاز است تا اطلاعاتی خاصی به کاربر دربارۀ الگو ارائه دهد، مثل توضیحاتی کوتاه از هدف الگو و پارامترهایش. این اطلاعات که به طور رسمی (توسط هر ویرایشگر ویکی) مدون شده‌اند از الگوداده استفاده می‌کنند.

بدون الگوداده

[ویرایش]

بدون الگوداده، در هنگام افزودن الگوی جدید هر پارامتر باید به صورت دستی افزوده شود.

هیچ اطلاعاتی در مورد اینکه مقدار پارامتر چه باید باشد ارائه نشده است.

با الگوداده

[ویرایش]

با الگوداده، فهرستی از پارامترهای پشتیبانی شده (و توضیحات‌شان) برای الگوها ارائه می‌شود.

الگوداده بافت هر پارامتر را مشخص می‌کند، و تغییردادن الگوها را برای کاربران آسان‌تر می‌کند.

افزودن الگوداده

[ویرایش]

هرکسی می‌تواند با افزودن الگوداده به الگوها کمک کند (به ویژه آنهایی که معروف هستند، مثل جعبه‌های اطلاعات) تا اینکه آنها ویرایش در ویرایشگر دیداری را آسان‌تر کنند. در زیر یک نمونۀ کوچک، که روی صفحۀ توضیحات الگو قرار می‌گیرد، آمده است:

<templatedata>{
  "description": "insert description here",
  "params": {
    "first parameter": {
      "label": "x",
      "description": "x",
      "type": "string",
      "default": "default value",
      "required": false
    }
  }
}</templatedata>

شما همچنین می‌توانید الگوداده را با یک رابط کاربر گرافیکی، با فشار دادن دکمه‌ای که در بالای صفحه ویرایش ظاهر می‌شود، اضافه یا ویرایش کنید: مدیریت الگوداده

خودآموز الگوداده جزئیات چگونگی افزودن اطلاعات الگوداده به یک الگو را شرح می‌دهد.

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

[ویرایش]