איך ליצור תבנית: הבדלים בין גרסאות בדף

קפיצה לניווט קפיצה לחיפוש
הוסרו 1,632 בתים ,  5 בפברואר 2017
אין תקציר עריכה
אין תקציר עריכה
אין תקציר עריכה
שורה 1: שורה 1:
{{ויקיפדיה - עריכה}}
{{ויקיפדיה - עריכה}}
'''תבנית''' (ב[[אנגלית]]: Template) היא שיטת [[עזרה:עריכת דף|עריכה]] בו[[ויקיפדיה|ויקיפדיה]], המאפשרת הצגת תוכן דף מסוים בדף אחר, ללא צורך להעתיקו. תבנית היא דף, שכתוב בצורה רגילה ([[עזרה:תחביר ויקי|תחביר ויקי]]), שאפשר "לשתול" בכל דף בוויקיפדיה, ומוצג כפי שהוא בזמן אמת. השימוש בתבנית מרכז טקסט במקום אחד, מונע כפילויות, מקל על ביצוע עדכונים ושינויים בדפים רבים בו-זמנית ושומר על [[ויקיפדיה:אחידות|אחידות]] בדפי ויקיפדיה.
'''תבנית''' היא שיטת [[עזרה:עריכת דף|עריכה]] ב[[חב"דפדיה]], המאפשרת הצגת תוכן דף מסוים בדף אחר, ללא צורך להעתיקו. תבנית היא דף, שכתוב בצורה רגילה ([[עזרה:תחביר ויקי|תחביר ויקי]]), שאפשר "לשתול" בכל דף בחב"דפדיה, ומוצג כפי שהוא בזמן אמת. השימוש בתבנית מרכז טקסט במקום אחד, מונע כפילויות, מקל על ביצוע עדכונים ושינויים בדפים רבים בו-זמנית ושומר על אחידות בדפי וחב"דפדיה.


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


==יצירת תבנית חדשה==
==יצירת תבנית חדשה==
{{מסגרת|'''שימו לב:''' ליצירת תבנית חדשה בוויקיפדיה ולהכנסת שינוי מהותי בתבנית קיימת משמש הדף [[ויקיפדיה:תבנית/אולם דיונים]]. טרם פתיחת דיון, מומלץ להתייעץ לגבי קיומה של תבנית או הצורך בתבנית חדשה בו[[ויקיפדיה:דלפק ייעוץ]].}}


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


יצירת תבנית חדשה:
יצירת תבנית חדשה:
שורה 37: שורה 36:


===קווים מנחים בתכנון תבניות===
===קווים מנחים בתכנון תבניות===
* ליצירת תבנית חדשה בוויקיפדיה או להכנסת שינוי מהותי בתבנית קיימת משמש הדף "'''[[ויקיפדיה:תבנית/אולם דיונים]]'''".
* טרם פתיחת דיון, מומלץ להתייעץ לגבי קיומה של תבנית כזו או הצורך בתבנית חדשה ב"[[ויקיפדיה:דלפק ייעוץ]]".
* ככלל, '''תבניות ניווט''' תוכנסנה למרחב הערכים רק כאשר יש בהן תועלת לניווט, לכן תבנית שאין בה לפחות 5 ערכים קיימים (כחולים) לא תוצג במרחב הערכים. כמו כן, עליהן לענות על הכללים של [[ויקיפדיה:לולאת נושא]].
* עבור פרמטרים שנפוצים בתבניות רבות נהוג להשתמש בשמות זהים על מנת להקל על העורכים ולאפשר שימוש אחיד לדוגמה:
* עבור פרמטרים שנפוצים בתבניות רבות נהוג להשתמש בשמות זהים על מנת להקל על העורכים ולאפשר שימוש אחיד לדוגמה:
**{{V}} תמונה, כיתוב {{X}} תצלום, צילום מסך, תמונה מייצגת, כתובית, כיתובית, כותרת תמונה, תיאור תמונה
**{{V}} תמונה, כיתוב {{X}} תצלום, צילום מסך, תמונה מייצגת, כתובית, כיתובית, כותרת תמונה, תיאור תמונה
**{{V}} סמל, כיתוב סמל {{X}} לוגו, סמליל, תמונה, כיתוב, כיתוב לוגו
**{{V}} סמל, כיתוב סמל {{X}} לוגו, סמליל, תמונה, כיתוב, כיתוב לוגו
**{{V}} מפה, כיתוב מפה {{X}} תצלום, תמונה, כתובית, כיתוב, כותרת מפה, תיאור מפה
**{{V}} מפה, כיתוב מפה {{X}} תצלום, תמונה, כתובית, כיתוב, כותרת מפה, תיאור מפה
*'''[[עזרה:שימוש במידע מוויקינתונים#שימוש בתבניות|המלצות הנוגעות לשילוב מידע מוויקינתונים]]''' - ובפרט יש לאפשר לדרוס בצורה מקומית שדות שנלקחים מוויקינתונים.


===לאחר יצירת התבנית===
===לאחר יצירת התבנית===
לאחר יצירת התבנית, יש ליצור [[הנדסת תוכנה|תיעוד]] כראוי, על מנת להקל על השימוש בה. להרחבה, ראה [[#תיעוד תבנית|סעיף בהמשך]].
לאחר יצירת התבנית, יש ליצור תיעוד כראוי, על מנת להקל על השימוש בה. להרחבה, ראה [[#תיעוד תבנית|סעיף בהמשך]].


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


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


==דרכים שונות להוספת תבנית אל דף וקישור אליה==
==דרכים שונות להוספת תבנית אל דף וקישור אליה==
קישור מהצורה <code><nowiki>{{שם התבנית הרצויה}}</nowiki></code> ישתול את תוכן התבנית בדף, בעוד קישור מהצורה <code><nowiki>[[תבנית:שם התבנית הרצויה]]</nowiki></code> יהווה [[עזרה:קישורים|קישור פנימי]], המוביל אל דף התבנית.
קישור מהצורה <code><nowiki>{{שם התבנית הרצויה}}</nowiki></code> ישתול את תוכן התבנית בדף, בעוד קישור מהצורה <code><nowiki>[[תבנית:שם התבנית הרצויה]]</nowiki></code> יהווה [[עזרה:איך ליצור קישור|קישור פנימי]], המוביל אל דף התבנית.


===העתקת קוד המקור של התבנית ===
===העתקת קוד המקור של התבנית ===
שורה 67: שורה 62:
:<code><nowiki>[[file:@@@.svg| -at- |link=|13px]]</nowiki></code>
:<code><nowiki>[[file:@@@.svg| -at- |link=|13px]]</nowiki></code>


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


ניתן לעשות באפשרות זו שימוש במקרים שבהם אין צורך לעדכן שנית את הטקסט, וכל המטרה היא לחסוך פעולת "העתק-הדבק". שימוש מאסיבי ב-<code>ס:</code> היכן שאין צורך שתהיה תבנית מעודכנת עשוי להקטין את העומס על [[שרת HTTP|שרתי]] ויקיפדיה. מנגד, החסרון הוא חוסר הדינמיות של תכונה זו: אם תתבצע עריכה בדף התבנית, השינוי לא ישתקף (יתעדכן) בדף אליו הועתקה התבנית. שימוש בתכונה זו לא מומלץ אפוא ב[[:קטגוריה:תבניות ניווט|תבניות ניווט]] בערכים.
ניתן לעשות באפשרות זו שימוש במקרים שבהם אין צורך לעדכן שנית את הטקסט, וכל המטרה היא לחסוך פעולת "העתק-הדבק". שימוש מאסיבי ב-<code>ס:</code> היכן שאין צורך שתהיה תבנית מעודכנת עשוי להקטין את העומס על [[שרת HTTP|שרתי]] ויקיפדיה. מנגד, החסרון הוא חוסר הדינמיות של תכונה זו: אם תתבצע עריכה בדף התבנית, השינוי לא ישתקף (יתעדכן) בדף אליו הועתקה התבנית. שימוש בתכונה זו לא מומלץ אפוא ב[[:קטגוריה:תבניות ניווט|תבניות ניווט]] בערכים.
שורה 102: שורה 97:


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


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


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


====שיבוץ דף משנה בדף האב====
====שיבוץ דף משנה בדף האב====
ישנו תחביר מקוצר לשילוב של [[עזרה:דף משנה|דף משנה]] בדף האב שלו. במקום לרשום את שם הדף המלא, ניתן לרשום רק את שם דף המשנה, לאחר <code>/</code> ([[לוכסן]]). שימושי במיוחד עם דפי [[עזרה:תבניות#תיעוד תבנית|תיעוד]] ודוגמאות של תבניות, הכתובים בדפי משנה.
ישנו תחביר מקוצר לשילוב של [[עזרה:דף משנה|דף משנה]] בדף האב שלו. במקום לרשום את שם הדף המלא, ניתן לרשום רק את שם דף המשנה, לאחר <code>/</code> (לוכסן). שימושי במיוחד עם דפי [[עזרה:תבניות#תיעוד תבנית|תיעוד]] ודוגמאות של תבניות, הכתובים בדפי משנה.


לדוגמה, כדי לשבץ בדף "[[תבנית:ניווט קבוצות]]" את תוכן דף המשנה "[[תבנית:ניווט קבוצות/הוראות שימוש]]", די לכתוב בו:
לדוגמה, כדי לשבץ בדף "[[תבנית:ניווט קבוצות]]" את תוכן דף המשנה "[[תבנית:ניווט קבוצות/הוראות שימוש]]", די לכתוב בו:

תפריט ניווט