עריכת הדף "עזרה:אשף התבניות" (פסקה)

== דף המשנה ==
יש לאשף שני מודי עבודה: מוד עבודה "מלא" עבור תבניות נתמכות, ומוד עבודה שני ("פשוט" או "raw") עבור כל השאר. במוד העבודה הפשוט, האשף ממצה את הפרמטרים מדף התבנית, אך ללא הבנה מה כל פרמטר עושה. אין הבחנה, למשל, בין פרמטרים שחיוניים לתבנית לפרמטרים אופציונליים. גם סדר הפרמטרים שהאשף מציג הוא לפי סדר הופעתם בקוד של תבנית, ולאו דווקא סדר הגיוני.

כדי להעביר תבנית למוד העבודה המלא, יש להכין לה דף משנה בשם "תבנית:שם התבנית/פרמטרים", ובו רשימת הפרמטרים עם תיאור, וכן תכונות נוספות. 

דף המשנה "פרמטרים" מכיל טבלה. '''חשוב''': התאים בטבלה מופרדים על ידי ||, ולא בירידת שורה ו- | יחיד.

הטורים של הטבלה הם:
# שם הפרמטר
# תיאור
# אופציות, מופרדות על ידי נקודה-פסיק (";"). האופציות הנתמכות כעת הן:
## "'''ברירת מחדל'''=" - ערך ברירת מחדל
## "'''אפשרויות'''=": הערכים השונים מופרדים בפסיקים. במידה ויש יותר מאפשרות אחת, שדה זה יופיע כתפריט נגלל. אם יש אפשרות יחידה, השדה הופך לתיבת סימון. אפשרות זו מכבדת את ברירת המחדל: במקרה של אפשרות יחידה, ברירת המחדל תגרום לתיבה להופיע כמסומנת.
## "'''שדה חובה'''": שדות המסומנים כ"חובה" יוקפו במסגרת אדומה, וכל עוד שכל השדות הללו לא מולאו, לא ניתן ללחוץ על "אישור".
## "'''מספר שורות'''" (עם או בלי ערך - ללא ערך ברירת המחדל היא 5). אפשרות זו מיועדת עבור פרמטרים שערכיהם עשויים לכלול מספר שורות.
## "'''תלוי'''" - שם שדה אחר שהשדה הזה תלוי בו. שימושי בתבניות בהן יש שדות רבים מסוג "מפלגה1, מפלגה2, מפלגה3" וכדומה, כאשר מספר המפלגות משתנה. במצב כזה אפשר לשים בטור של מפלגה5 "תלוי=מפלגה4". באופן כזה הטופס יכיל רק מה שרלוונטי (כלומר, ברגע שהמשתמש יתחיל למלא את "מפלגה4", תתווסף לטופס שורה עבור "מפלגה5"). בדומה, אם יש למשל "אלבום קודם" ו-"תאריך אלבום קודם", ניתן להגדיר את השדה השני כתלוי בראשון.
## "'''תאריך'''" - בלחיצה על השדה ייפתח וידג'ט של תאריך. עדיין ניתן למלא את השדה באופן ידני.
## "'''משני'''" - אם יש שדות המסומנים "משני", שדות אלו יהיו מוסתרים כאשר הטופס נפתח, ומעל השדות תתווסף תיבת סימון "הראה את כל הפרמטרים". סימון התיבה יגרום להופעת השדות עם הסימון "משני". 
הערה: כל הפרמטרים צריכים להיכתב ללא גרשיים. לדוגמה: ברירת מחדל = 10.

טבלת פרמטרים לדוגמה, המדגימה את השימוש באופציות השונות:

{| class = "wikitable"
|-
! שם הפרמטר !! תיאור !! אופציות
|-
|סוג || פרמטר זה יכול לקבל ערך מתוך רשימה מוגבלת. שימוש באופציה "אפשרויות" גורמת לכך שהכנסת הנתונים מתבצעת על ידי בחירה מתפריט. בין האפשרויות מפרידים פסיקים. || אפשרויות=מיני-אלבום, EP, הופעה, אוסף, מארז תקליטורים, גרסאות כיסוי, פסקול, וידאו, רמיקס 
|- 
| אפשרות יחידה || גם שדה זה מסומן עם "אפשרויות", אך מכיוון שיש רק אפשרות אחת, במקום תפריט נגלל תופיע תיבת סימון. || אפשרויות=כן 
|-
| חייבים || פרמטר זה הוא פרמטר חובה, כלומר אין להשאירו ריק. השדה באשף יהיה מוקף במסגרת אדומה, וכל עוד אין בפרמטר הזה ערך, כפתור "אישור" לא יהיה פעיל || שדה חובה
|-
| סיפור || פרמטר זה מקבל תוכן ארוך יחסית, ולכן באשף נקצה לשדה מספר שורות (ללא קשר להופעת התוכן בתבנית עצמה: לצורך שבירת שורות בתבנית כפי שתופיע לקוראים, יש להשתמש ב{{תב|ש}}). אם לא נוסיף מספר (בדוגמה - 7), האשף יקצה לשדה 5 שורות. כשמשתמשים ב"שורות", אם העורך רושם יותר שורות מהמספר שהוגדר, השדה יצמיח פס גלילה אנכי. || מספר שורות = 7
|-
| זכייה ראשונה || שדה מסוג "תאריך". לחיצה על השדה תפתח ווידג'ט "תאריך", אך ניתן גם למלא את תוכן השדה ידנית. || תאריך
|-
| זכייה שנייה || רק אם המשתמשת מילאה "זכייה ראשונה" יש טעם להציע לה למלא גם "זכייה שנייה". כאשר משתמשים במספר אופציות, מפרידים ביניהן בעזרת נקודה-פסיק: ; || תלוי=זכייה ראשונה ; תאריך
|-
| לאום || יש תבניות בהן אם לא ממלאים פרמטר מסוים, התבנית משתמשת בערך ברירת מחדל. אם הערך שנמלא באשף זהה לערך ברירת המחדל, האשף ישמיט את הפרמטר הזה לחלוטין || ברירת מחדל = פרסי
|-
|שם החתול || שדה זה הוא "משני", ולכן לא יופיע בעת פתיחת הטופס. כאשר יש שדה משני אחד או יותר, תופיע בראש הטופס תיבת סימון "הראה את כל הפרמטרים". סימון התיבה יגרום להופעת השדות המסומנים "משני". שדה שמסומן גם "משני" וגם "תלוי", יופיע רק כאשר מתקיימים שני התנאים: התיבה מסומנת והשדה בו תלוי שדה זה אינו ריק. || משני
|}