עזרה:תבניות – הבדלי גרסאות

{{קיצור דרך|[[וק:עת]]}}

{{חב"דפדיה - עריכה}}

השימוש בשיטה זו דומה ליצירת [[עזרה:קישורים|קישור]], אך במקום להוסיף שני זוגות של סוגריים מרובעים משני צִדי המילה (<code><nowiki>[[</nowiki></code> ו־<code><nowiki>]]</nowiki></code>) יש להשתמש בשני זוגות של '''סוגריים מסולסלים''' (<code><nowiki>{{</nowiki></code> ו־<code><nowiki>}}</nowiki></code>). ניתן להעתיק בצורה זו את תוכנו של כל דף בכל [[עזרה:מרחב שם|מרחב שם]], אך נהוג להעתיק דפים מתוך המרחב "תבנית", שנוצר לשם כך. ההסברים שלהלן מתבססים על שימוש במרחב שם זה. לגבי שימוש בשיטה זו לדפים מסוגים אחרים ראו [[#התייחסות לדף רגיל כאל תבנית|בהמשך]].

==יצירת תבנית חדשה==

===הסבר טכני===

;יצירת תבנית: תבנית היא [[עזרה:מרחב שם|אחד מסוגי הדפים הקיימים בחב"דפדיה]]: כדי ליצור תבנית חדשה, יש '''[[חב"דפדיה:איך ליצור דף חדש|ליצור דף חדש]]''' שבו יוכנס תוכן התבנית (ראו הסבר בקישור). תבנית נמצאת במרחב שם "תבנית:".

:<code><nowiki>{{/הוראות שימוש}}</nowiki></code>

===אשף התבניות===

===הגדרת פרמטרים לתבנית ===

====פרמטר שמי====

==== שינוי פרמטרים בתבנית קיימת ====

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

====הגדרת תבנית כפרמטר====

{{מסגרת|'''שימו לב:''' בעת שימוש בתגית {{קוד|<nowiki><noinclude></nowiki>}}, יש לוודא כי היא ממוקמת '''בצמוד''' ל[[תו (מחשב)|תו]] האחרון שרוצים שייכלל בדפים המכילים את התבנית. לדוגמה, מיקום תגית {{קוד|<nowiki><noinclude></nowiki>}} לאחר ירידת שורה יוביל להכללת שורת רווח מיותרת בדפים המכילים את התבנית, ואף עלול לגרום לבעיות [[עימוד]] בין מלל הערך ל[[עזרה:טבלאות|טבלה]] שמקורה בתבנית.}}

===== הערה מוסתרת בתבנית =====

:<code><nowiki><noinclude><!-- טקסט ההערה --></noinclude></nowiki></code>

וזאת כדי למנוע את הכללת הטקסט המוסתר (המיועד למתכנת) בכל הטמעה של התבנית בדפי חב"דפדיה.

לשם כך, פותחו בחב"דפדיה שני כלים המסייעים לבדוק קוד של תבנית בטרם שמירתו:

# '''תצוגה מקדימה של הדף עם התבנית הזאת''' – אפשרות חדשה, שנוספה בעת עריכת דפים ב[[עזרה:מרחב שם|מרחב]] התבניות, ומופיעה בתחתית דף העריכה (מתחת לכפתורי השמירה הרגילים). אפשרות זו היא הפשוטה והמהירה מבין השתיים.

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

| colspan="2" style="text-align: center;" | {{{אתר אינטרנט}}}

|}

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

==תיעוד תבנית==

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

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

כחלק מההסבר, ניתן לעשות שימוש בתגיות "<nowiki><code>" ו-"&lt;nowiki&gt;</nowiki>" (חפשו מידע בדף "[[עזרה:תחביר ויקי]]") כדי להדגים דרכים שונות להשתמש בתבנית, כפי שנעשה בדף זה. ניתן להיעזר גם בתבנית {{תב|אופן השימוש}}.