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

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

الگوداده چیست؟[ویرایش]

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

بدون الگوداده[ویرایش]

VisualEditor - Template without TemplateData.png

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

VisualEditor - Template without TemplateData2.png

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

با الگوداده[ویرایش]

VisualEditor - Template with TemplateData1.png

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

VisualEditor - Template with TemplateData2.png

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

افزودن الگوداده[ویرایش]

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

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

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

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

جستارهای وابسته[ویرایش]