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

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

==== תכנים שיופיעו רק בדפים המכילים את התבנית ====
לעתים, מעוניינים במצב ההפוך; שתוכן מסוים יוצג או ייכלל בדפים המכילים את התבנית, אך לא בדף התבנית עצמה (למשל, קטגוריות תחזוקה – אין צורך שהתבנית עצמה תופיע ברשימת הדפים שיש לתחזק, אלא רק הדפים שבהם היא נוספה (לצורך כך, ניתן להיעזר גם בתבנית: {{תב|קטגוריה בתבנית}})). במקרים אלו יש להשתמש בתגית <code><nowiki><includeonly></nowiki></code> (בעברית: כְּלוֹל רק) באופן הבא:
:<code><nowiki><includeonly>תוכן שלא מופיע בדף התבנית, אבל מופיע בדפים המכילים אותה.‎</includeonly>‎</nowiki></code>

'''המלצה:''' ככלל, מאחר שאת דף התבנית נהוג לפתוח ישר עם קוד התבנית (לפני התיעוד והוראות השימוש), מומלץ לפתוח כל כתיבת תבנית בתגית <code><nowiki>‎<includeonly>‎</nowiki></code>.