עזרה:תבניות

מתוך ויקיפדיה, האנציקלופדיה החופשית

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

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

[עריכה] יצירת תבנית פשוטה

כדי ליצור תבנית חדשה, כתבו במקום כלשהו (ארגז החול, למשל) את הטקסט הבא:

{{שם התבנית הרצויה}}

או:

[[תבנית:שם התבנית הרצויה]]

כאשר במקום "שם התבנית הרצויה" יש לכתוב את שם התבנית. רצוי שהשם יהיה בעברית.

לאחר שעשיתם זאת, שמרו את הדף ותקבלו קישור אדום כזה:

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

[עריכה] דוגמה

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

[[תבנית:חדש]]

לאחר הכתיבה מקבלים את התוצאה הבאה:

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

בכל מקום בו יש להוסיף את תבנית, יש לכתוב את הטקסט:

{{חדש}}.

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

[עריכה] יצירת תבנית פרמטרית

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

[עריכה] פרמטר שמי

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

{{{פרמטר1}}}

השימוש בפרמטר בדף היעד ייעשה עפ"י הסדר הבא:

• שם התבנית
• תו מפריד (|)
• שם הפרמטר
• הסימן =
• ערך הפרמטר.

[עריכה] דוגמה

תחביר:

{{שם תבנית|פרמטר1=ערך1|פרמטר2=ערך2|פרמטר3=ערך3}}

דוגמה מעשית:

{{חדש|תמונה=פרפר.jpg|שם=משפחת הפרפרים}}

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

{{שם תבנית |פרמטר 1=ערך1 |פרמטר 2=ערך2 |פרמטר 3=ערך3 }}

[עריכה] פרמטר מספרי

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

{{{1}}}

בתבנית בה מופיעים הפרמטרים {{{1}}}, {{{2}}} ו־{{{3}}} צורת הכתיבה בדף היעד לא תהיה:

{{שם התבנית|1=ערך1|2=ערך2|3=ערך3}}

אלא:

{{שם תבנית|ערך1|ערך2|ערך3}}

לדוגמה:

{{חדש|פרפר.jpg|משפחת הפרפרים}}

החסרון בשימוש בתבנית כזו הוא שבריבוי פרמטרים, קשה לזכור מה יעודו של כל פרמטר, וקל להתבלבל בהם. מומלץ להשתמש בפרמטר זה רק כאשר יש שימוש בפרמטרים ספורים. חסרון נוסף בשימוש בפרמטרים מספריים הוא שלא ניתן להזין את הסימן שווה (=). לדוגמה, בתבנית {{חדש|פרפר.jpg|משפחת הפרפרים = butterfly family}} אין פרמטרים שמיים, ואולם, התבנית תתייחס ל-"משפחת הפרפרים" כאל שם של פרמטר, ול-"butterfly family" כאל המידע שמוזן לו. כדי לעקוף בעיה זו, ניתן להזין את הקוד הבא במקום סימני שווה:

לחילופין, ניתן מלתחילה להגדיר את התבנית עם פרמטרים שמיים. כלומר, התבנית {{חדש|תמונה=פרפר.jpg|שם=משפחת הפרפרים = butterfly family}} תעבוד מצויין.

ניתן "לערבב" בתבנית אחת את הפרמטרים מסוג שם ומסוג מספר ביחד.

[עריכה] שינויי פרמטרים בתבנית קיימת

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

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

[עריכה] הגדרת ברירת מחדל לפרמטר

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

[עריכה] דוגמה לשימוש בתבנית

כתיבה של אנגלית בזרימה משמאל לימין ובכיוון משמאל לימין נתקלת בבעיה בוויקיפדיה.

<div dir=ltr align=left>
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Morbi congue bibendum massa. Nunc odio tortor, elementum ac, laoreet eget, porta at, lorem.
</div>

זוהי דרך מסורבלת מעט לפתרון הבעיה. דרך פשוטה תהיה ליצור תבנית עם פרמטר מספרי, ששמה יהיה תבנית:ltr.

<div dir=ltr align=left>
{{{1}}}
</div>

{{ltr|
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Morbi congue bibendum massa. Nunc odio tortor, elementum ac, laoreet eget, porta at, lorem.
}}

[עריכה] דוגמה נוספת לפרמטר שמי

התבנית מיון, המיועדת להצגה של פרטי חיות.

{|  border="1" cellspacing="0" align="left" cellpadding="2" style="margin-right: 0.5em;" 
!  align="center" bgcolor=pink | '''{{{שם}}}'''
|- 
|  align="center" | {{{תמונה}}}
|- 
!  align="center" bgcolor=pink | [[מיון עולם הטבע|מיון מדעי]]
|- 
| 
{|  align="center" 
| ממלכה:
| {{{ממלכה}}}
|- 
| מערכה:
| {{{מערכה}}}
|- 
| מחלקה:
| {{{מחלקה}}}
|- 
| סדרה:
| {{{סדרה}}}
|- 
| משפחה:
| {{{משפחה}}}
|- 
| סוג:
| {{{סוג}}}
|- 
| מין:
| {{{מין}}}
|}
|- 
!  align="center" bgcolor="pink" | '''שם מדעי'''
|- 
!  align="center" | [[wikispecies:{{{שם_מדעי}}}|{{{שם_מדעי}}}]]
|}

שימוש בתבנית מיון באופן הבא:	יתן את התוצאה הבאה בעמוד:
{{מיון| |שם=אריה |תמונה=[[תמונה:Lion in Kenya.jpg|250px]] |ממלכה=[[בעלי חיים]] |מערכה=[[מיתרניים]] |מחלקה=[[יונקים]] |סדרה=[[טורפים (סדרת יונקים)|]] |משפחה=[[חתוליים]] |סוג=[[פנתר]] |מין='''אריה''' |שם_מדעי= Panthera leo }}	אריה מיון מדעי ממלכה: בעלי חיים מערכה: מיתרניים מחלקה: יונקים סדרה: טורפים משפחה: חתוליים סוג: פנתר מין: אריה שם מדעי Panthera leo

[עריכה] הערות

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

|תמונה=

• אם בוחרים כשמות פרמטרים מספרים (1, 2, 3, 4 וכד'), ניתן להסתפק גם בכתיבה כזו:

{{מיון|
|אריה
|[[תמונה:Lion in Kenya.jpg]]
|[[בעלי חיים]]
|[[מיתרניים]]
|[[יונקים]]
|[[טורפים (סדרת יונקים)|]]
|[[חתוליים]]
|[[פנתר]]
|'''אריה'''
|Panthera leo
}}

שימו לב שכאשר יש מספר כה רב של פרמטרים, רצוי שלא להשתמש בשיטה זו. הדבר יוצר בלבול בעת עריכת הדף.

[עריכה] ס:

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

[עריכה] דוגמה

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

[עריכה] יתרונות

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

[עריכה] חסרונות

אם תתבצע עריכה בדף התבנית, השינוי לא ישתקף בדף אליו הועתקה התבנית.

[עריכה] msgnw

הוספת הטקסט msgnw לפני שם התבנית יגרום לטקסט המקור של התבנית להופיע בדף היעד. במילים אחרות, התבנית מופיעה כאילו שנוספו לה תגי <nowiki> בכל שורה.

[עריכה] יתרונות

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

[עריכה] חסרונות

מכיוון שלא משתמשים באפשרות זו, אין לה ממש חסרונות.

[עריכה] השוואה

להלן השוואה בין תבנית רגילה, "ס:" ו־msgnw.

[עריכה] התייחסות לדף רגיל כאל תבנית

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

{{:שם ערך}}

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

{{:עברית}}

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

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

{{ויקיפדיה:דלפק יעוץ}}

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

גם במקרה של שימוש כזה בתבניות ניתן להשתמש ב־msgnw, ב־subst ובפרמטרים.

[עריכה] דפי הפניה

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

[עריכה] קטגוריות וקישורים בין לשוניים

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

<noinclude>
[[en:Template name]]
[[קטגוריה:שם קטגוריה]]
</noinclude>

[עריכה] ראו גם

• רשימת תבניות
• עזרה:הוראות תנאי