עזרה:תבניות

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

כדי ליצור תבנית חדשה יש לפתוח דף במרחב השם "תבנית:" ולהכניס בו את הקוד של התבנית. לאחר מכן אפשר לשלב אותה בדפים אחרים בעזרת כתיבה של {{שם התבנית}} במקום הרצוי.

תכננו תבניות פשוטות וברורות. יש ליצור תיעוד ברור, לקטלג אותן בקטגוריות מתאימות ולבדוק התאמה לשימוש נרחב. לפני פרסום רצוי לבחון שינוי בטיוטה או בארגז החול של התבניות.

יש להוסיף דף תיעוד שיסביר למשתמשים איך להשתמש בתבנית. במקרים מסוימים צריך לקבל אישור באולם התבניות לפני שימוש נרחב.

כתיבה של {{שם}} משחררת את תוכן התבנית בדף. כתיבת תבנית:שם התבנית יוצרת קישור פנימי לדף התבנית ולא תשתיל את התוכן.

הוספת הקידומת ס: (מקביל ל-subst:) לפני שם התבנית גורמת להעתקה חד־פעמית של התוכן. ההעתקה לא תתעדכן כשיעודכנו שינויים בתבנית המקורית. זו שיטה שימושית כשאין צורך בעדכונים דינמיים.

תבניות יכולות לקבל פרמטרים, כלומר ערכים שמשפיעים על התצוגה. יש שני סוגים עיקריים: פרמטרים שמיים (מוסיפים על ידי שם) ופרמטרים מספריים (מוסיפים לפי סדר). פרמטרים שמיים נכתבים בתוך התבנית כ-{{{שם}}} (שלושה סוגריים מסולסליים). פרמטרים מספריים מזוהים על ידי מיקום.

ניתן להגדיר ברירת מחדל לפרמטר, כך שאם לא ימולא ערך יופיע טקסט ברירת המחדל. אפשר גם לבדוק האם הוזן ערך באמצעות תנאי פשוטים שבתבנית.

אפשר ליצור תבנית שתשמש כפרמטר של תבנית אחרת. כך נבנים מודולים חוזרים ומורכבים שקשי להפעיל ישירות.

סימנים כמו הקו הניצב (|) והשווה (=) משמשים להפרדת פרמטרים. בתוך תבנית יש לכתוב אותם באופן מיוחד כדי שלא יתפרשו כחלק מהתחביר.

ניתן לערוך תבנית בעמוד התבנית באמצעות "עריכת קוד מקור". בדפים אחרים אפשר ללחוץ על "תבניות המופיעות בדף זה" כדי למצוא את התבניות המוקלדות בעמוד.

לפני שמירה כדאי לבדוק את השפעת השינוי על דפים אחרים. קיימים כלים לכך: תצוגה מקדימה מיוחדת לעריכה במרחב התבניות ו"ארגז חול של תבניות" לבדיקות מורכבות.

ניתן לבנות טבלאות בתוך תבנית ולהסתיר שורות שאינן בשימוש. שימוש בתנאים מאפשר להציג רק שורות עם פרמטרים מלאים.

עדכון תבנית עלול לגרום לתקלות, למשל שהשינוי לא יתעדכן בכל הדפים. לעתים יש לפתוח את דף העריכה ולשמור ללא שינוי כדי לעדכן רשימות מקושרות.

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

השלבים המומלצים הם: בדיקת הצורך, דיון בקהל המתאים, יצירת טיוטה, תיעוד, בדיקות התאמה והנגשה באמצעות אשף התבניות. אישור שונה עשוי להידרש לפי סוג התבנית.

תבנית היא דף שמכניס תוכן לדפים אחרים. כדי להכניס משתמשים כותבים {{שם}}. סוגריים מסולסליים אלה נראים כך: {{...}}.

כדי ליצור תבנית פותחים דף בשם "תבנית:..." וכותבים בו את התוכן.

תבנית יכולה לקבל פרמטרים. פרמטר הוא חלק ריק שניתן למלא בשם=ערך. בפרמטרים שמיים כותבים {{{שם}}} בתוך התבנית.

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

מומלץ לבדוק שינויים בתצוגה מקדימה. יש גם "ארגז חול של תבניות" לבדיקה בטוחה.

כל תבנית צריכה הסבר קצר. שמים דף תיעוד עם דוגמאות. כך אחרים ידעו להשתמש בה.

בין הסימנים שבשימוש יש | ו-=. יש לכתוב אותם בזהירות בתוך תבנית. אפשר גם לשבץ טבלאות ולהסתיר שורות ריקות.

סיכום קצר: תבניות עוזרות לחזור על מידע בקלות. הן מקלות על עדכון ולקחו זמן ללמוד איך להשתמש בהן.