עזרה:תבניות: הבדלים בין גרסאות בדף
תוכן שנמחק תוכן שנוסף
זמני, עד שהדף יועתק מוויקיפדיה |
העתקה מוויקיפדיה העברית, בשינויים המתבקשים |
||
שורה 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>
כאשר במקום "שם התבנית הרצויה" יש לכתוב את שם התבנית. רצוי שהשם יהיה בעברית.
לאחר שעשיתם זאת, שמרו את הדף ותקבלו קישור אדום כזה:
<div style="color: #ba0000;">
:תבנית:שם התבנית הרצויה
</div>
לחצו על הקישור וערכו את התוכן בו כמו כל דף רגיל. בכל מקום שבו תרצו להוסיף את התבנית, כתבו את הטקסט <code><nowiki>{{שם התבנית הרצויה}}</nowiki></code>. התוכן שהזנתם לתבנית יופיע בדף באופן אוטומטי.
===דוגמה===
אם רוצים לכתוב תבנית תחת השם "חדש" יש לכתוב:
:<code><nowiki>[[תבנית:חדש]]</nowiki></code>
לאחר הכתיבה מקבלים את התוצאה הבאה:
<div style="color: #ba0000;">
:תבנית:חדש
</div>
לחיצה על הקישור תפתח דף עריכה חדש. יש לערוך אותו כמו כל דף רגיל, ולשמור בסיום העריכה.
בכל מקום בו יש להוסיף את תבנית, יש לכתוב את הטקסט:
:<code><nowiki>{{חדש}}</nowiki></code>.
כדי לערוך את תוכנה של תבנית קיימת, אפשר לעשות זאת ע"י עריכת דף המכיל את התבנית: מתחת לאזור העריכה תופיע רשימה של תבניות המופיעות בדף. שימו לב כי קישור מהצורה <code><nowiki>{{שם התבנית הרצויה}}</nowiki></code> ישתיל את תוכן התבנית בדף בעוד קישור מהצורה <code><nowiki>[[תבנית:שם התבנית הרצויה]]</nowiki></code> יוביל לדף התבנית.
==יצירת תבנית פרמטרית==
ישנה אפשרות ליצור תבניות בעלות פרמטרים, שאותם ניתן לשנות בכל דף בו מופיעה התבנית. יצירת תבנית פרמטרית זהה ליצירת תבנית רגילה, ולפיכך יש לבצע את כל השלבים המתוארים בסעיף הקודם. ישנם שני סוגי פרמטרים: פרמטר שמי ופרמטר מספרי.
===פרמטר שמי===
לאחר שנוצרה תבנית, יש לכתוב בה שם פרמטר כאשר הוא ממוקף ב'''שלושה''' סוגרים מסולסלים משני צדדיו (שימו לב: הוספת '''שני''' סוגרים מסולסלים תוביל ליצירת תבנית חדשה נוספת, ועל כך יש להקפיד). דוגמה לצורת כתיבת פרמטר:
:<code><nowiki>{{{פרמטר1}}}</nowiki></code>
השימוש בפרמטר בדף היעד ייעשה עפ"י הסדר הבא:
* שם התבנית
* תו מפריד (<code>|</code>)
* שם הפרמטר
* הסימן <code>=</code>
* ערך הפרמטר.
====דוגמה====
תחביר:
:<code><nowiki>{{שם תבנית|פרמטר1=ערך1|פרמטר2=ערך2|פרמטר3=ערך3}}</nowiki></code>
דוגמה מעשית:
:<code><nowiki>{{חדש|תמונה=פרפר.jpg|שם=משפחת הפרפרים}}</nowiki></code>
ניתן לפרוס את הטקסט הנ"ל במאונך, במידה וישנם פרמטרים רבים. תחביר:
<nowiki>
{{שם תבנית
|פרמטר 1=ערך1
|פרמטר 2=ערך2
|פרמטר 3=ערך3
}}</nowiki>
===פרמטר מספרי===
ניתן לכתוב פרמטרים ללא שם. במקרה כזה יש לתת לפרמטר מספר, כאשר הוא נמצא בין שלושה סוגרים מסולסלים. לדוגמה:
:<code><nowiki>{{{1}}}</nowiki></code>
בתבנית בה מופיעים הפרמטרים <code><nowiki>{{{1}}}</nowiki></code>, <code><nowiki>{{{2}}}</nowiki></code> ו־<code><nowiki>{{{3}}}</nowiki></code> צורת הכתיבה בדף היעד '''לא''' תהיה:
:<code><nowiki>{{שם התבנית|1=ערך1|2=ערך2|3=ערך3}}</nowiki></code>
אלא:
:<code><nowiki>{{שם תבנית|ערך1|ערך2|ערך3}}</nowiki></code>
לדוגמה:
:<code><nowiki>{{חדש|פרפר.jpg|משפחת הפרפרים}}</nowiki></code>
החסרון בשימוש בתבנית כזו הוא שבריבוי פרמטרים, קשה לזכור מה יעודו של כל פרמטר, וקל להתבלבל בהם. מומלץ להשתמש בפרמטר זה רק כאשר יש שימוש בפרמטרים ספורים. חסרון נוסף בשימוש בפרמטרים מספריים הוא שלא ניתן להזין את הסימן שווה (<code>=</code>). לדוגמה, בתבנית <code><nowiki>{{חדש|פרפר.jpg|משפחת הפרפרים = butterfly family}}</nowiki></code> אין פרמטרים שמיים, ואולם, התבנית תתייחס ל-"משפחת הפרפרים" כאל שם של פרמטר, ול-"butterfly family" כאל המידע שמוזן לו. כדי לעקוף בעיה זו, ניתן להזין את הקוד הבא במקום סימני שווה:
{|
| style="direction: ltr;" | <code>&</code><code>#61;</code>
|}
לחילופין, ניתן מלתחילה להגדיר את התבנית עם פרמטרים שמיים. כלומר, התבנית <code><nowiki>{{חדש|תמונה=פרפר.jpg|שם=משפחת הפרפרים = butterfly family}}</nowiki></code> תעבוד מצויין.
ניתן "לערבב" בתבנית אחת את הפרמטרים מסוג שם ומסוג מספר ביחד.
===שינויי פרמטרים בתבנית קיימת===
'''שימו לב:''' במקרה שמשנים בתבנית קיימת את מספר הפרמטרים, או שמשנים את הסדר שלהם, השינוי יבוא לידי ביטוי בכל הדפים שבהם הוכנסה התבנית לפני השינוי וזה עלול ליצור תוצאות לא צפויות ובלתי רצויות, כגון, הוצאת דברים מהקשרם או הופעת טקסט מיותר.
כדאי לתת על כך את הדעת בזמן שמשנים את התבנית ובכך ניתן למנוע את הבעיה לפני שנוצרה.
===הגדרת ברירת מחדל לפרמטר===
ניתן להגדיר ברירת מחדל לפרמטר כך שאם לא יוכנס ערך לפרמטר יופיע טקסט ברירת המחדל. כדי להגדיר ברירת מחדל לפרמטר כלשהו, לדוגמה, ל-<code><nowiki>{{{שם הסרט}}}</nowiki></code> יש להוסיף קו אנכי (<nowiki>|</nowiki>) ולאחריו את טקסט ברירת המחדל באופן הבא:
:<code><nowiki>{{{שם הסרט|טקסט ברירת מחדל}}}</nowiki></code>
דוגמה נפוצה לשימוש בברירת המחדל היא באמצעות שימוש בתבניות קבועות של המערכת, כגון <code><nowiki>{{שם הדף}}</nowiki></code> המחזיר את שם הדף. הקוד
:<code><nowiki>{{{שם הסרט| {{שם הדף}} }}}</nowiki></code>
מאפשר לעורכים למלא את שם הסרט, ואם פרמטר זה נותר ריק, ישמש שם הדף במקומו של הפרמטר.
==<code>ס:</code>==
הוספת הכיתוב "<code>ס:</code>" לפני שם של תבנית (או שם של דף כאשר הוא מוקף בסוגריים מסולסלים) גורמת להעתקת הדף בשלמותו מתוך דף המקור, כך שבעיון חוזר בדף העריכה לא ניתן יהיה לדעת שנעשה שימוש בתבנית כלשהי. לדוגמה, אם ניקח את התבנית {{תב|@}}, הוספת ה-"<code>ס:</code>" תיראה כך:
:<code><nowiki>{{ס:@}}</nowiki></code>
במילים אחרות, מדובר בפעולה הזהה להעתקת תוכן התבנית בעזרת "העתק-הדבק".
להמחשת הרעיון, ניתן לגשת ל[[ויקיציטוט:ארגז חול|ארגז החול]], שם להוסיף את התבנית {{תב|@}}, ואז לשמור את הדף. תבנית זו מוסיפה תמונה קטנה בצורת סימן "@". אם נערוך את ארגז החול בשנית, נמצא את הטקסט שהוספנו ללא שינוי. כעת נוסיף "<code>ס:</code>" אחרי הסוגרים המסולסלים ולפני שם הדף (במקרה זה, שם הדף הוא "@") ונשמור את הדף בפעם השנייה. הדף נראה ללא שינוי, אולם אם נכנס שוב לדף העריכה, נמצא כי הטקסט ששמרו שונה, ועכשיו מופיע הטקסט שגרם לתמונה להופיע, טקסט שהופיע בדף המקור, ב-{{תב|@}}.
ניתן לעשות באפשרות זו שימוש במקרים בהם אין צורך לעדכן שנית את הטקסט, וכל המטרה היא לחסוך פעולת "העתק-הדבק". שימוש מסיבי ב-"<code>ס:</code>" היכן שאין צורך שתהיה תבנית מעודכנת עשוי להקטין את העומס על השרת. מנגד, החסרון הוא חוסר הדינמיות של תכונה זו: אם תתבצע עריכה בדף התבנית, השינוי לא ישתקף בדף אליו הועתקה התבנית. שימוש בתכונה זו לא מומלץ איפוא בתבניות ניווט בערכים.
קיים גם מספר מועט של תבניות שמחייבות שימוש בתכונה זו, כדוגמת {{[[תבנית:הבהרת חשיבות|הבהרת חשיבות]]}} או {{[[תבנית:ציר זמן|ציר זמן]]}}, אשר בהעדר שימוש בתכונה לא יוצגו כראוי.
==השוואה==
להלן השוואה בין תבנית רגילה, ו-"<code>ס:</code>".
{| border="3"
|-
! צורת הכתיבה
! תצוגה בגלישה
! מבט אל דף העריכה
|-
|
<code><nowiki>{{לשון זכר}}</nowiki></code>
|
{{לשון זכר}}
|
<div style="border: 1px dashed blue; height: 100px; width: 251px; overflow: auto;">
<nowiki>{{לשון זכר}}</nowiki>
</div>
|-
|
<code><nowiki>{{ס:לשון זכר}}</nowiki></code>
|
{{לשון זכר}}
|
<div style="border: 1px dashed blue; height: 100px; width: 251px; overflow: auto;">
<nowiki><div> <small> <center>'''הבהרה''': כדי למנוע סרבול מיותר, וכמקובל בשפה העברית, ננקטת לעתים לשון זכר בהתייחסות<BR> אל כלל הגולשות והגולשים ובמתן שמות לערכים. אנא קבלו זאת בהבנה!</center> </small> </div></nowiki>
</div>
|}
==התייחסות לדף רגיל כאל תבנית==
אפשר להתייחס לכל דף כאילו היה תבנית, באמצעות מיקוף בשני סוגריים מסולסלים והקדמת נקודתיים לשם.
:<code><nowiki>{{:שם ערך}}</nowiki></code>
אם, לדוגמה, ברצונכם להעתיק את כל תוכן הערך [[עברית]] לדף מסוים, כתבו בדף היעד את הטקסט:
:<code><nowiki>{{:עברית}}</nowiki></code>
שימו לב לסימן הנקודותיים ( : ) המופיע לפני שם הערך (עברית, במקרה זה). במידה ויתבצע שינוי בערך "עברית", השינוי ישתקף בצורה אוטומטית גם בדף היעד, בלי שנעשה בו עצמו אף שינוי.
בדרך דומה ניתן להעתיק את תוכנם של דפים אחרים, שאינם נמצאים במרחב השם המרכזי. לדוגמה: כדי להעתיק את כל תוכנו של דלפק היעוץ לדף מסוים, יש להקיש בו את הטקסט הבא:
:<code><nowiki>{{ויקיציטוט:דלפק ייעוץ}}</nowiki></code>
'''שימו לב''' שבמקרה זה לא נוספו נקודותיים לפני המילה "ויקיציטוט:". ניתן להעתיק בצורה דומה טקסטים ממרחבי שם אחרים, כדוגמת "משתמש:", "קטגוריה:", "שיחת ויקיציטוט:" וכד'.
גם במקרה של שימוש כזה בתבניות ניתן להשתמש ב־"[[#ס:|ס:]]" וב[[#יצירת תבנית פרמטרית|פרמטרים]].
==דפי הפניה==
ברגע שיוצרים דף הפניה מתבנית לתבנית, ויקיציטוט יתייחס לדף ההפניה באותו האופן שבו הוא מתייחס לתבנית עצמה.
== תכנים שיופיעו בתבנית בלבד או שיופיעו רק בדפים המכילים את התבנית ==
לעתים יש צורך שתוכן מסוים יוצג בתבנית בלבד, ולא בדפים המכילים אותה (כגון הסברים לשימוש בתבנית, הקטגוריה של התבנית, קישורי בינוויקי, או הצבעת מחיקה על תבנית). במקרים אלו יש להשתמש בתג <code><nowiki><noinclude></nowiki></code> באופן הבא:
:<code><nowiki><noinclude></nowiki></code>תוכן שמופיע בתבנית בלבד, ולא בדפים המכילים אותה.<code><nowiki></noinclude></nowiki></code>
לעתים מעוניינים במצב ההפוך; שתוכן יוצג בדפים המכילים את התבנית, אך לא בתבנית עצמה. במקרים אלו יש להשתמש בתג <code><nowiki><includeonly></nowiki></code> באופן הבא:
:<code><nowiki><includeonly></nowiki></code>תוכן שלא מופיע בתבנית, אבל מופיע בדפים המכילים אותה.<code><nowiki></includeonly></nowiki></code>
==טבלאות==
פעמים רבות יש צורך ליצור טבלה בתוך תבנית, אך לעיתים יש גם צורך להסתיר את התאים שאינם בשימוש. לפני קריאת פרק זה, מומלץ להכיר כיצד לבנות [[עזרה:טבלאות|טבלאות]] בשפת ויקי.
{| class="wikitable" align="left"
! colspan="2" | {{{שם הסרט}}}
|-
| ז'אנר || {{{ז'אנר}}}
|-
| אורך || {{{אורך}}}
|-
| תאריך השקה || {{{תאריך השקה}}}
|-
| colspan="2" style="text-align: center;" | {{{אתר אינטרנט}}}
|}
הטבלה משתמשת בשני אמצעים עיקריים: בתבנית <code><nowiki>{{!}}</nowiki></code>, שמציגה קו אנכי (<code><nowiki>|</nowiki></code>) ובהוראת תנאי מסוג <code><nowiki>{{#תנאי:הפרמטר לבדיקה|מה לכתוב אם הפרמטר קיים|מה לכתוב אם הפרמטר אינו קיים}}</nowiki></code>. נמחיש כיצד לבנות טבלה מסודרת באמצעות דוגמה: אנו מעוניינים ליצור את הטבלה שמשמאל עבור ערכי סרטים. כפי שניתן לראות, כל התאים בטבלה זו מוצגים. כעת נשנה את כל הפרמטרים, מלבד הפרמטר "שם הסרט", כך שאם יהיו ריקים, לא תוצג השורה שלהם כלל.
עבור כל שורה שבה שתי עמודות, יש להשתמש בקוד הבא:
:<code><nowiki>{{#תנאי:{{{פרמטר|<noinclude>-</noinclude>}}} |</nowiki></code>
:<code><nowiki>{{!}} פרמטר</nowiki></code>
:<code><nowiki>{{!}} {{{פרמטר}}}</nowiki></code>
:<code><nowiki>{{!}}-</nowiki></code>
:<code><nowiki>}}</nowiki></code>
כאשר את הכיתוב "פרמטר" יש לשנות לשם הפרמטר. בשורה האחרונה, עם הפרמטר "אתר אינטרנט", ישנה עמודה אחת בלבד שתוכנה מיושר לאמצע. עבור שורות מסוג זה, נשתמש בקוד הבא:
:<code><nowiki>{{#תנאי:{{{פרמטר|<noinclude>-</noinclude>}}} |</nowiki></code>
:<code><nowiki>{{!}} colspan="2" סגנון {{!}} {{{פרמטר}}}</nowiki></code>
:<code><nowiki>{{!}}-</nowiki></code>
:<code><nowiki>}}</nowiki></code>
כאשר את הכיתוב "פרמטר" יש לשנות לשם הפרמטר, ואת הכיתוב "סגנון" יש להחליף בסגנון הרצוי, כלומר, במקרה שלנו, יישור לאמצע. לבסוף, לגבי הפרמטר הראשון, נשתמש בברירת המחדל, כך שאם לא ניתן שם הסרט, נשתמש בשם הערך במקום. הקוד המלא לדוגמה זו ותוצאותו, להלן:
{| border="1" align="left"
|
:<code><nowiki>{| class="wikitable" align="left"</nowiki></code>
:<code><nowiki>! colspan="2" | {{{שם הסרט| {{שם הדף}} }}}</nowiki></code>
:<code><nowiki>{{!}}- </nowiki></code>
:<code><nowiki>{{#תנאי:{{{ז'אנר|<noinclude>-</noinclude>}}} | </nowiki></code>
:<code><nowiki>{{!}} ז'אנר</nowiki></code>
:<code><nowiki>{{!}} {{{ז'אנר}}} </nowiki></code>
:<code><nowiki>{{!}}- </nowiki></code>
:<code><nowiki>}}</nowiki></code>
:<code><nowiki>{{#תנאי:{{{אורך|<noinclude>-</noinclude>}}} | </nowiki></code>
:<code><nowiki>{{!}} אורך</nowiki></code>
:<code><nowiki>{{!}} {{{אורך}}} </nowiki></code>
:<code><nowiki>{{!}}- </nowiki></code>
:<code><nowiki>}}</nowiki></code>
:<code><nowiki>{{#תנאי:{{{תאריך השקה|<noinclude>-</noinclude>}}} | </nowiki></code>
:<code><nowiki>{{!}} תאריך השקה</nowiki></code>
:<code><nowiki>{{!}} {{{תאריך השקה}}} </nowiki></code>
:<code><nowiki>{{!}}- </nowiki></code>
:<code><nowiki>}}</nowiki></code>
:<code><nowiki>{{#תנאי:{{{אתר אינטרנט|<noinclude>-</noinclude>}}} | </nowiki></code>
:<code><nowiki>{{!}} colspan="2" style="text-align: center;" {{!}} {{{אתר אינטרנט}}} </nowiki></code>
:<code><nowiki>}}</nowiki></code>
:<code><nowiki>|}</nowiki></code>
|
{| class="wikitable" align="left"
! colspan="2" | {{{שם הסרט| {{שם הדף}} }}}
{{!}}-
{{#תנאי:{{{ז'אנר|<noinclude>-</noinclude>}}} |
{{!}} ז'אנר
{{!}} {{{ז'אנר}}}
{{!}}-
}}
{{#תנאי:{{{אורך|<noinclude>-</noinclude>}}} |
{{!}} אורך
{{!}} {{{אורך}}}
{{!}}-
}}
{{#תנאי:{{{תאריך השקה|<noinclude>-</noinclude>}}} |
{{!}} תאריך השקה
{{!}} {{{תאריך השקה}}}
{{!}}-
}}
{{#תנאי:{{{אתר אינטרנט|<noinclude>-</noinclude>}}} |
{{!}} colspan="2" style="text-align: center;" {{!}} {{{אתר אינטרנט}}}
}}
|}
|}
במידה שתשתמשו בקוד זה בתוך תבנית, ולאחר מכן תשתמשו בתבנית זו, תראו כי אם לא תמלאו את הפרמטרים "ז'אנר", "אורך", "תאריך השקה" ו"אתר אינטרנט", לא יוצג השורה שלהם. דוגמה "חיה" לשימוש זה ניתן למצוא בתבנית {{תב|סרט}}. שימו לב שבתבנית זו סגנונות בכל התאים שלו (לכל התאים יש גבול עליון מקווקו).
{{-}}
==ראו גם==
* [[ויקיציטוט:רשימת תבניות|רשימת תבניות]]
* [[עזרה:הוראות תנאי]]
* [[עזרה:משתנים]]
[[קטגוריה:ויקיציטוט - תמיכה טכנית|תבנית]]
[[en:Help:Template]]
| |||