אונטערשייד צווישן ווערסיעס פון "המכלול:מוסטער"

פון המכלול
קפיצה לניווט קפיצה לחיפוש
וויזועלוויקיטעקסט
(אידיש (המשך))
ק (החלפת טקסט – "דרויסנדע" ב־"דרויסנדיגע")
 
(29 מיטלסטע ווערסיעס פון 3 באַניצער נישט געוויזן.)
שורה 1: שורה 1:
{{קיצור דרך|[[מכ:עת]]}}
{{קיצור דרך|[[מכ:עת]]}}
{{המכלול - עריכה}}
{{המכלול - עריכה}}
א '''מוסטער''' (אין [[ענגליש]]: Template; אין [[העברעאיש]]: תבנית) איז א וויקי שפראך מעטאד וואס ערמעגליכט צו צייגן איין בלאט אין א צווייטן בלאט, אן דארפן קאפירן פון אנדערע בלעטער. א מוסטער איז א בלאט געשריבן אין ([[הילף:וויקי סינטאקס|וויקי סינטאקס]]), וואס מען קען "איינפלאנצן" אין יעדן בלאט אין המכלול, און ווערט פארגעשטעלט אין עכטע צייט. זיך באניצן מיט א מוסטער צענטראליזירט טעקסט אין איין פלאץ, פארמיידט דאפלטן, פארגרינגערט אויסצופירן אפדעיטס און רעדאגירונגען אויף פילע בלעטער אויפאמאל און היט אויף [[המכלול:איינהייטליכקייט|איינהייטליכקייט]] אין די המכלול בלעטער.
א '''מוסטער''' (אין [[ענגליש]]: Template; אין [[העברעאיש]]: תבנית) איז א וויקי שפראך מעטאד וואס ערמעגליכט צו צייגן איין בלאט אין א צווייטן בלאט, אן דארפן קאפירן פון אנדערע בלעטער. א מוסטער איז א בלאט געשריבן אין ([[הילף:וויקי סינטאקס|וויקי סינטאקס]]), וואס מען קען "אריינפלעכטן" אין יעדן בלאט אין המכלול, און ווערט פארגעשטעלט אין עכטע צייט. זיך באניצן מיט א מוסטער צענטראליזירט טעקסט אין איין פלאץ, פארמיידט דאפלטן, פארגרינגערט אויסצופירן אפדעיטס און רעדאגירונגען אויף פילע בלעטער אויפאמאל און היט אויף [[המכלול:איינהייטליכקייט|איינהייטליכקייט]] אין די המכלול בלעטער.


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


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


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


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


===קווים מנחים בתכנון תבניות===
===ריכטליניעס ביים בויען מוסטערן===
* ליצירת תבנית חדשה במכלול או להכנסת שינוי מהותי בתבנית קיימת משמש הדף "'''[[המכלול:תבנית/אולם דיונים]]'''".
* צו שאפן א פרישע מוסטער אין מכלול אדער צו מאכן אן ערנסטע טויש אין אן עקזיסטירנדע דינט דער "'''[[המכלול:מוסטער/דיסקוסיע זאל]]'''" בלאט.
* טרם פתיחת דיון, מומלץ להתייעץ לגבי קיומה של תבנית כזו או הצורך בתבנית חדשה ב"[[המכלול:דלפק ייעוץ]]".
* איידער'ן עפענען א דיסקוסיע, איז רעקאמענדירט זיך צו צו באראָטן איבערן עקזיסטענץ פון אזא מוסטער אדער א געברויך פאר א פרישע מוסטער אין "[[המכלול:דיסקוסיע זאל]]".
* ככלל, '''תבניות ניווט''' תוכנסנה למרחב הערכים רק כאשר יש בהן תועלת לניווט, לכן תבנית שאין בה לפחות 5 ערכים קיימים (כחולים) לא תוצג במרחב הערכים. כמו כן, עליהן לענות על הכללים של [[המכלול:לולאת נושא]].
* אין פּרינציפּ, וועלן '''נאוויגאציע מוסטערן''' ארויסגעלייגט ווערן צום בלעטער געביט נאר אויב דאס פארגרינגערט טאקע נאוויגעציע, דערפאר וועט א מוסטער וואס האט ווייניגער פון 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> וועט שאפן אן [[הילף:קישורים|אינערליכע פארבינדונג]], וואס וועט פירן צום מוסטער בלאט.


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


והתוצאה תיראה כך:
רעזולטירן אין...:


{{@}}
{{@}}


והקוד, בזמן עריכה, ייראה כך:
און די קאוד בשעת'ן רעדאגירן, וועט אויסזען אזוי:
:<code><nowiki>[[קובץ:@@@.svg| -at- |link=|13px]]</nowiki></code>
:<code><nowiki>[[טעקע:@@@.svg| -at- |link=|13px]]</nowiki></code>


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


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


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


השם הלועזי המקורי של <code>ס:</code> הוא <code>subst:</code>.
די אריגינעלע ענגלישע נאמען פאר <code>ס:</code> איז <code>subst:</code>.


====השוואה====
====השוואה====
שורה 97: שורה 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> ([[לוכסן]]). ספעציעל ניצבאר פאר [[הילף:מוסטערן#מוסטער דאקומענטאציע|דאקומענטאציע]] און ביישפילן פון מוסטערן, וואס ווערן געשריבן אין אונטער-בלעטער.


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


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


===אשף התבניות===
===מוסטערן וויזערד===
{{הפניה לערך מורחב|עזרה:אשף התבניות}}
{{הפניה לערך מורחב|הילף:מוסטערן וויזערד}}
אחת הדרכים הפשוטות ביותר להוספת תבנית (מורכבת) לדף כלשהו היא באמצעות "אשף התבניות"; בפרט אם הוספו לתבנית תיעוד ותמיכה ייעודיים עבור האשף (ראו "אשף התבניות" תחת פרק "[[#תיעוד תבנית|תיעוד תבנית]]"):
צו פארגרינגערן דאס צולייגן (קאמפליצירטע) מוסטערן צו א בלאט קענט איר זיך באניצן מיט'ן "מוסטערן וויזערד"; ספעציעל אויב איז געווארן צוגעלייגט צום מוסטער דעזיגנירטע דאקומענטאציע און הילף פאר'ן וויזערד (זעט "מוסטערן וויזערד" ביים "[[#מוסטער דאקומענטאציע|מוסטער דאקומענטאציע]]"):
* כדי להיעזר באשף, כאשר נמצאים ב[[עזרה:עריכת דף|מצב עריכה]], יש ללחוץ על הכפתור [[קובץ:Vector toolbar template button.png]] שב[[עזרה:עריכת דף#סרגל העריכה|סרגל הכלים]] העליון. האשף יפתח חלון, שמאפשר להזין את שם התבנית הרצויה מתוך רשימה. לאחר לחיצה על "אישור", תגיעו לאשף עצמו.
* צו ניצן דעם וויזערד, ווען איר זענט אין [[הילף:רעדאגירן א בלאט|רעדאגירן בלאט]], דרוקט דעם קנעפל [[טעקע:Vector toolbar template button.png]] וואס געפינט זיך אין [[הילף:רעדאגירן א בלאט#סרגל העריכה|געצייג בּאַר]] אויבן. דער וויזערד וועט זיך עפענען אין א פענסטער, וואס ערמעגליכט צו אריינפילן די נאמען פון מוסטער וואס איר ווילט - פון א ליסטע. נאכ'ן דרוקן אויף "OK", וועט איר גרייכן דעם וויזערד אליין.
* לחלופין, ניתן לסמן את התבנית כולה, כולל כל הפרמטרים שכבר מולאו בה. האשף יאסוף את הערכים הללו מהדף, ימלא את השדות המתאימים ויציג בפניכם את האשף.
* מען קען אויך טון פארקערט, און אויספילן דעם גאנצן מוסטער, אריינגערעכענט אלע פאראמעטערס. די וויזערד וועט צוזאמנעמען אלע ווערדן וואס איר האט געשריבן, און אנפילן די ריכטיגע קעסטלעך און אייך ווייזן דעם וויזערד.


מידע נוסף ניתן לקרוא בערך המורחב.
טרעפט מער אינפארמאציע און פארברייטערטע ארטיקל.


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


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


{{מסגרת|'''שימו לב:''' יש לקחת בחשבון שהכנסת שינוי בתבנית קיימת תשפיע על דפים רבים, ולכן, יש לוודא היטב שהשינוי לא פוגע בהצגת התבנית או בתפקודה!}}<!-- רעיון-הוספת התבנית בדף התבנית, תחת noninclude ובדיקה בתצוגה מקדימה, כולל עם פרמטרים שונים -->
{{מסגרת|'''פאסט אויף:''' מען דארף נעמען און באטראכט אז טוישן א מוסטער וועט אפעקטירן אסאך בלעטער, און דערפאר דארף מען מאכן זיכער אויף 100% אז דער טויש וועט נישט שעדיגן די אויסקוק אדער אירע פונקציעס!}}<!-- רעיון-הוספת התבנית בדף התבנית, תחת noninclude ובדיקה בתצוגה מקדימה, כולל עם פרמטרים שונים -->


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


{| class="wikitable"
{| class="wikitable"
|-
|-
! הסימן !! אופן כתיבתו בתבנית
! צייכן !! אופן פון שרייבן
|-
|-
| : || <div class="mw-content-ltr"><code>&amp;#58;</code></div>
| : || <div class="mw-content-ltr"><code>&amp;#58;</code></div>
שורה 150: שורה 150:
|}
|}


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


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


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


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


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


השימוש בפרמטר בדף היעד ייעשה על פי הסדר הבא:
זיך באניצן שפעטער מיט'ן פאראמעטער אין ציל בלאט וועט געטון ווערן ווי פאלגענד:


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


תחביר לדוגמה של תבנית עם שלושה פרמטרים:
ביישפיל סינטעקס פון מוסטער מיט דריי פאראמעטערס:
:<code><nowiki>{{שם תבנית|פרמטר1=ערך1|פרמטר2=ערך2|פרמטר3=ערך3}}</nowiki></code>
:<code><nowiki>{{נאמען פון מוסטער|פאראמעטער1=ווערד1|פאראמעטער2=ווערד2|פאראמעטער3=ווערד3}}</nowiki></code>


דוגמה מעשית של תבנית עם שני פרמטרים:
פאקטישע ביישפיל פון מוסטער מיט צוויי פאראמעטערס:
:<code><nowiki>{{חדש|תמונה=פרפר.jpg|שם=משפחת הפרפרים}}</nowiki></code>
:<code><nowiki>{{חדש|תמונה=פרפר.jpg|שם=משפחת הפרפרים}}</nowiki></code>


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


<pre>
<pre>
{{שם תבנית
{{נאמען פון מוסטער
|פרמטר1=ערך1
|פאראמעטער1=ווערד1
|פרמטר2=ערך2
|פאראמעטער2=ווערד2
|פרמטר3=ערך3
|פאראמעטער3=ווערד3
}}</pre>
}}</pre>


====פרמטר מספרי====
====נומער פאראמעטער====
ניתן לכתוב ולהוסיף לתבנית פרמטרים גם ללא שם. במקרה כזה, יש לתת לכל פרמטר מספר סידורי, שיופיע תחום בין שלושה סוגריים מסולסלים. לדוגמה:
מען קען אויך צולייגן צו א מוסטער פאראמעטערס אנע נאמען. אין אזא פאל, דארף מען גיבן פאר יעדע פאראמעטער נומערן אין א סעריע, און ווערן אריינגעשטעלט צווישן דריי פּאָר געקרייזעלטע קלאמערן. ביישפיל:
:<code><nowiki>{{{1}}}</nowiki></code>
:<code><nowiki>{{{1}}}</nowiki></code>


בתבנית בה מופיעים הפרמטרים <code><nowiki>{{{1}}}</nowiki></code>, <code><nowiki>{{{2}}}</nowiki></code> ו-<code><nowiki>{{{3}}}</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=ווערד1|2=ווערד2|3=ווערד3}}</nowiki></code>
אלא:
נאר:
:<code><nowiki>{{שם תבנית|ערך1|ערך2|ערך3}}</nowiki></code>
:<code><nowiki>{{נאמען פון מוסטער|ווערד1|ווערד2|ווערד3}}</nowiki></code>


לדוגמה:
ביישפיל:
:<code><nowiki>{{חדש|פרפר.jpg|משפחת הפרפרים}}</nowiki></code>
:<code><nowiki>{{חדש|פרפר.jpg|משפחת הפרפרים}}</nowiki></code>


החסרון בשימוש בתבנית כזו הוא שבריבוי פרמטרים, קשה לזכור מה ייעודו ומיקומו הנכון של כל פרמטר, וקל להתבלבל בסדר. מאידך, תבנית זו מהירה יותר לשימוש (יש פחות תווים להקלדה) וחוסכת "ביורוקרטיה" מיותרת. מומלץ להשתמש בצורה זו רק כאשר יש שימוש בפרמטרים ספורים. חסרון נוסף בשימוש בפרמטרים מספריים הוא שלא ניתן להזין את הסימן שווה (<code>=</code>). לדוגמה, בתבנית <code><nowiki>{{חדש|פרפר.jpg|משפחת הפרפרים=butterfly family}}</nowiki></code> אין פרמטרים שמיים, ואולם, התבנית תתייחס ל-"משפחת הפרפרים" כאל שם של פרמטר, ול-"butterfly family" כאל הערך שמוזן לו, אך היא כמובן לא תמצא פרמטר בשם "משפחת הפרפרים" ותחזיר הודעת שגיאה. כדי לעקוף בעיה זו, ניתן להזין את הקוד הבא במקום סימני שווה:
די חסרון פון אזא מוסטער איז, אז מיט מערערע פאראמעטערס וועט זיין שווער צו געדענקען די ציל און ריכטיגע פלאץ פון יעדע פאראמעטער, און מען וועט שנעל פארמישט ווערן מיט'ן ריכטיג'ן סדר. פון די אנדערע זייט, איז אזא מוסטער שנעלער צו באניצן (מיט ווייניגער קארעקטערס צו טייפּן) און שפּאָרט איבריגע "ביוראקראטיע". עס איז רעקאמענדירט זיך צו באניצן מיט דעם אופן נאר ווען עס איז דא בלויז געציילטע פאראמעטערס. נאך א חסרון מיט'ן באניצן א נומערירטע מוסטער איז אז מען קען נישט אריינלייגן אן איקוואל צייכן (<code>=</code>). צום ביישפיל, אין מוסטער <code><nowiki>{{חדש|פרפר.jpg|משפחת הפרפרים=butterfly family}}</nowiki></code> איז נישט פארהאן נאמען פאראמעטערס, דאך וועט דער מוסטער זיך באציען צו "משפחת הפרפרים" ווי צו א נאמען פון א פאראמעטער, און צו "butterfly family" ווי דער ווערד אריינגעפילט, אבער עס וועט פארשטייט זיך נישט טרעפן א פאראמעטער מיט'ן נאמען "משפחת הפרפרים" און וועט גיבן א הודעת שגיאה. צו אויסקרויזן דעם פראבלעם, דארף מען זיך באניצן מיט די פאלגענדע קאוד אויפ'ן פלאץ פון סימני שווה:
:<code>&amp;#61;</code>
:<code>&amp;#61;</code>
או להשתמש בתבנית ששמה "=":
אדער זיך באניצן מיט'ן מוסטער "=":
:{{קוד|{{תב|{{=}}}}}}
:{{קוד|{{תב|{{=}}}}}}
לחלופין, ניתן להתייחס לפרמטר המספרי כאילו היה פרמטר שמי, ולציינו במפורש בעת השימוש במוסטער: <code><nowiki>{{חדש|פרפר.jpg|</nowiki>{{כ}}2<nowiki>=משפחת הפרפרים = butterfly family}}</nowiki></code>
נאך א וועג איז זיך צו באציען צום נומער פאראמעטער ווי עס וואלט געווען א נאמען פאראמעטער, און עס ארויסשרייבן ביים ניצן אין מוסטער: <code><nowiki>{{חדש|פרפר.jpg|</nowiki>{{ר}}2<nowiki>=משפחת הפרפרים = butterfly family}}</nowiki></code>


ניתן לשלב בתבנית אחת פרמטרים שמיים ופרמטרים מספריים ביחד. לדוגמה:
מען קען ניצן אין איין מוסטער סיי נאמען פאראמעטערס און סיי נומער פאראמעטערס ביינאזאם. צום ביישפיל:
:<code><nowiki>{{שם תבנית|חיה=חתול|2=שחור|מין=זכר|מבוית}}</nowiki></code>
:<code><nowiki>{{נאמען פון מוסטער|חיה=קאץ|2=שוארץ|מין=זכר|מבוית}}</nowiki></code>


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


====בדיקת קיום פרמטר====
====באקוקן עקזיסטענץ פון פאראמעטער====
{{הפניה לערך מורחב|עזרה:הוראות תנאי#תנאי}}
{{הפניה לערך מורחב|הילף:תנאי באפעלן#תנאי}}


כדי לבדוק האם לתבנית הוזן פרמטר, ניתן לעשות בדיקה באמצעות [[עזרה:הוראות תנאי|הוראת התנאי]] הבא:
צו באקוקן אויב די מוסטער האט אריינגעלייגטע פאראמעטערס, קען מען לאזן לויפן א בדיקה דורך די פאלגדנע [[הילף:תנאי באפעלן|תנאי באפעל]]:
<div class="mw-content-ltr">
<div class="mw-content-ltr">
:<code><nowiki>{{#if: {{{param|}}} | Hooray...! | Darn...! }}</nowiki></code>
:<code><nowiki>{{#if: {{{param|}}} | Hooray...! | Darn...! }}</nowiki></code>
תוצאה: {{#if: {{{param|}}} | Hooray...! | Darn...! }}
רעזולטאט: {{#if: {{{param|}}} | Hooray...! | Darn...! }}
</div>
</div>


או בעברית:
אדער אויף העברעאיש:
:<code><nowiki>{{#תנאי: {{{פרמטר|}}} | יש ערך...! | אין ערך...! }}</nowiki></code>
:<code><nowiki>{{#תנאי: {{{פרמטר|}}} | פארהאן ארטיקל...! | נישטא ארטיקל...! }}</nowiki></code>
תוצאה: {{#תנאי: {{{פרמטר|}}} | יש ערך...! | אין ערך...! }}
רעזולטאט: {{#תנאי: {{{פרמטר|}}} | פארהאן ארטיקל...! | נישטא ארטיקל...! }}


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


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


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


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


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


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


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


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


===טבלאות===
===טבלאות===
שורה 272: שורה 272:
{{הפניה לערך מורחב|עזרה:טבלאות}}
{{הפניה לערך מורחב|עזרה:טבלאות}}


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


{| class="wikitable" align="left"
{| class="wikitable" align="left"
שורה 285: שורה 285:
| colspan="2" style="text-align: center;" | {{{אתר אינטרנט}}}
| colspan="2" style="text-align: center;" | {{{אתר אינטרנט}}}
|}
|}
הטבלה משתמשת בשני אמצעים עיקריים: בתבנית <code><nowiki>{{!}}</nowiki></code>, שמציגה קו אנכי (<code><nowiki>|</nowiki></code>) ובמשפט תנאי מסוג <code><nowiki>{{#תנאי:הפרמטר לבדיקה|מה לכתוב אם הפרמטר קיים|מה לכתוב אם הפרמטר אינו קיים}}</nowiki></code> (ראו סעיף "[[עזרה:תבניות|בדיקת קיום פרמטר]]").
הטבלה משתמשת בשני אמצעים עיקריים: בתבנית <code><nowiki>{{!}}</nowiki></code>, שמציגה קו אנכי (<code><nowiki>|</nowiki></code>) ובמשפט תנאי מסוג <code><nowiki>{{#תנאי:הפרמטר לבדיקה|מה לכתוב אם הפרמטר קיים|מה לכתוב אם הפרמטר אינו קיים}}</nowiki></code> (ראו סעיף "[[הילף:מוסטערן|בדיקת קיום פרמטר]]").


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


• לבסוף, לגבי הפרמטר הראשון, נשתמש בברירת המחדל, כך שאם לא ניתן שם הסרט, נשתמש בשם הערך במקום. הקוד המלא לדוגמה זו ותוצאותו, להלן:
• לבסוף, לגבי הפרמטר הראשון, נשתמש בברירת המחדל, כך שאם לא ניתן שם הסרט, נשתמש בשם הערך במקום. הקוד המלא לדוגמה זו ותוצאותו, להלן:
שורה 308: שורה 308:
|
|
:<code><nowiki>{| class="wikitable" align="left"</nowiki></code>
:<code><nowiki>{| class="wikitable" align="left"</nowiki></code>
:<code>! colspan="2" | <nowiki>{{{שם הסרט| {{שם הדף בלי הסוגריים|}} }}}</nowiki></code>
:<code>! colspan="2" | <nowiki>{{{שם הסרט| {{בלאטנאמען אן קלאמערן|}} }}}</nowiki></code>
:<code><nowiki>{{!}}- </nowiki></code>
:<code><nowiki>{{!}}- </nowiki></code>
:<code><nowiki>{{#תנאי:{{{ז'אנר|<noinclude>-</noinclude>}}} | </nowiki></code>
:<code><nowiki>{{#תנאי:{{{ז'אנר|<noinclude>-</noinclude>}}} | </nowiki></code>
שורה 355: שורה 355:


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


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


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


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


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


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


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


שורה 394: שורה 394:


==ראו גם==
==ראו גם==
* [[עזרה:ארגז חול לתבניות]]
* [[הילף:זאמדקאסטן פאר מוסטערן]]
* [[המכלול:תבנית]]
* [[המכלול:תבנית]]
* [[המכלול:רשימת תבניות]]
* [[המכלול:רשימת תבניות]]
* [[עזרה:אשף התבניות]]
* [[הילף:אשף התבניות]]
* [[עזרה:מילות מפתח]]
* [[הילף:מילות מפתח]]
* [[עזרה:הוראות תנאי]]
* [[הילף:הוראות תנאי]]
* [[המכלול:תבנית/אולם דיונים]]
* [[המכלול:תבנית/אולם דיונים]]
* [[מוסטער:קטגוריה בתבנית]]
* [[מוסטער:קטגוריה בתבנית]]
* [[המכלול:מגבלות המפענח]]
* [[המכלול:מגבלות המפענח]]


== קישורים חיצוניים ==
== דרויסנדיגע לינקס ==
* [[:en:Template:String templates see also text|תבניות לטיפול במחרוזות]], דף ב[[ויקיפדיה האנגלית]]. חלק מתבניות אלה נמצא גם במכלול (ב[[:קאטעגאריע:תבניות לעיבוד מחרוזות]]).
* [[:en:Template:String templates see also text|תבניות לטיפול במחרוזות]], דף ב[[ויקיפדיה האנגלית]]. חלק מתבניות אלה נמצא גם במכלול (ב[[:קאטעגאריע:שנורל מוסטערן]]).
[[קאטעגאריע:המכלול - תמיכה טכנית|תבנית]]
[[קאטעגאריע:המכלול טעכנישע הילף|תבנית]]
[[he:עזרה:תבניות]]
[[he:עזרה:תבניות]]
{{וח}}
{{וח}}

יעצטיגע רעוויזיע זינט 08:22, 8 יולי 2024

עריכת ערכים

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

די באניץ פון דעם מעטאד איז ענליך צו שאפן א לינק, אבער אנשטאט לייגן צוויי פּאָר געקעסטלטע קלאמערן (brackets) ביידע זייטן פונעם ווארט ([[ און ]]) באניצט מען זיך מיט צוויי פּאָר געקרייזלטע קלאמערן (curly brackets) ({{ און }}). מען קען גראדע קאפירן מיט דעם מעטאד די אינהאלט פון סיי וועלכע בלאט אין יעדע געביט, אבער געווענליך וועט מען קאפירן פון די "מוסטער" געביט, וואס איז געווידמעט ספעציעל פאר דעם. די פאלגענדע אנווייזונגען זענען באזירט אויפ'ן באניץ מיט דעם געביט. לגבי זיך באניצן מיט דעם מעטאד פאר אנדערע סארט בלעטער זעט שפעטער.

שאפן א פרישע מוסטער

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

טעכנישע ערקלערונג

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

ביישפיל: אויב וויל מען זיך באניצן מיט א מוסטער "ניי" – גייט מען צו יעדעס פלאץ מען וויל האבן דעם מוסטער, און מען שרייבט די טעקסט: {{ניי}}

וויבאלד אזא מוסטער עקזיסטירט נישט, וועט איר באקומען די פאלגענדע רעזולטאט:

מוסטער:ניי

דרוקן דעם לינק וועט עפענען א רעדאגירן בלאט צו שאפן א מוסטער מיט'ן נאמען "ניי".

ריכטליניעס ביים בויען מוסטערן

  • צו שאפן א פרישע מוסטער אין מכלול אדער צו מאכן אן ערנסטע טויש אין אן עקזיסטירנדע דינט דער "המכלול:מוסטער/דיסקוסיע זאל" בלאט.
  • איידער'ן עפענען א דיסקוסיע, איז רעקאמענדירט זיך צו צו באראָטן איבערן עקזיסטענץ פון אזא מוסטער אדער א געברויך פאר א פרישע מוסטער אין "המכלול:דיסקוסיע זאל".
  • אין פּרינציפּ, וועלן נאוויגאציע מוסטערן ארויסגעלייגט ווערן צום בלעטער געביט נאר אויב דאס פארגרינגערט טאקע נאוויגעציע, דערפאר וועט א מוסטער וואס האט ווייניגער פון 5 עקזיסטירנדע ארטיקלען (בלויע) נישט ווערן ארויסגעלייגט.
  • פאר פאראמעטערס וואס ווערן אפט באניצט אין אסאך מוסטערן איז איינגעפירט זיך צו באניצן מיט די זעלבע נעמען צו פארגרינגערן פאר רעדאגירער און ערמעגליכן איינהייטליכע באניץ. צום ביישפיל:
    • Pictogram voting keep.svg בילד, קעפל Pictogram voting delete.svg פאטאגראף, סקרינשׁאַט, זע בילד, קעפל, בילד קעפל, בילד באשרייבונג
    • Pictogram voting keep.svg סימבאָל, סימבאָל קעפל Pictogram voting delete.svg לאגא, א סימבאָל, בילד, קעפל, לאגא באשרייבונג
    • Pictogram voting keep.svg מאפע, מאפע קעפל Pictogram voting delete.svg פאטאגראף, בילד, קעפל, מאפע קעפל, מאפע באשרייבונג
  • רעקאמענדאציעס וויאזוי צו אריינפלעכטן אינפארמאציע פון וויקידאטא - איבערהויפט ערמעגליכט דאס צו איבערשרייבן לאקאל שטיקלעך גענומען פון וויקידאטא.
  • אין נאוויגאציע מוסטערן וואס מען פלעכט געווענליך אריין אינטן פון בלאט, איז איינגעפירט זיך צו באניצן מיט מוסטער:נאוויגאציע אדער מוסטער:ניווט קבוצות וואס ברענגט איינהייטליכקייט ביי די אויסזען פון נאוויגאציע מוסטערן, און א צייגנדע ראַם וואס מאכט א קלארע אונטערשייד צווישן די מוסטער און די אינהאלט פון בלאט.

נאכ'ן שאפן דעם מוסטער

נאכ'ן שאפן דעם מוסטער, דארף מען עס דאקומענטירן ריכטיג, צו פארגרינגערן איר באניץ. פאר מער, זעט ווייטער.

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

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

די פראצעדור אין קורצן

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

  1. אויסשמועסן דעם געברויך - דיסקוסיע זאַל
  2. פאָרשלאַג אין המכלול:מוסטערן/דיסקוסיע זאַל – פארלאנגט (קלארשטעלונג – מען מוז נישט האבן טעכנישע וויסנשאפט צו עפענען א דיסקוסיע. דער דיסקוסיע איז געמאכט צו לעזן א פראבלעם)
  3. שאפן א טעכנישע לעזונג (רעקאמענדירט ערשט אין א דרעפט אדער אונטער-בלאט)
  4. דאקומענטאציע פאר באניצער און אנדערע רעדאגירער
  5. צוגרייטן פאר ברייטע באניץ – צופאסן צום בדיקת הפרמטרים סיסטעם
  6. מאכן דעם מוסטער צוטריטלעך – צופאסן צום מוסטער וויזערד, צולייגן אין רעלעוואנטע בלעטער

פארשידענע וועגן צו צולייגן מוסטער צו א בלאט און לינקען דערצו

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

קאפירן די קאוד פון מוסטער

צולייגן א קעפל ס: פאר'ן מוסטער נאמען (אדער בלאט נאמען, ווען ארומגענומען מיט געקרייזעלטע קלאמערן) וועט קאפירן דעם פולן בלאט קאוד, איינמאליג און ווערט נישט אפדעיטעד, און ביים איבערקוקן די היסטאריע וועט נישט זיין א וועג צו וויסן אז דאס איז געטון געווארן דורך ניצן א מוסטער. צום ביישפיל, אויב וועלן מיר לייגן דעם מוסטער {{@}}, וועט צולייגן א ס: אזוי:

{{ס:@}}

רעזולטירן אין...:

-at-

און די קאוד בשעת'ן רעדאגירן, וועט אויסזען אזוי:

[[טעקע:@@@.svg| -at- |link=|13px]]

צו אילוסטרירן דעם געדאנק, קענט איר גיין צום זאמדקאסטן, און צולייגן דארט דעם מוסטער {{@}}, און דאן אפהיטן דעם בלאט. די מוסטער לייגט צו א קליינע בילד מיט די אדרעס-צייכן "@". אויב וועלן מיר צוריקגיין רעדאגירן דעם זאמדקאסטן, וועלן מיר טרעפן די טעקסט וואס מיר האבן צוגעלייגט (ד.ה., די מוסטער נאמען) אומגעענדערט. יעצט לאמיר צולייגן א ס: נאך די קלאמערן פאר'ן מוסטער נאמען (און אונזער פאל, "@") און מיר וועלן ווידער אפהיטן דעם בלאט. די בלאט צייגט נאך די זעלבע, אבער אויב גייען מיר יעצט אריין רעדאגירן דעם בלאט, וועלן מיר זען אנדערע טעקסט, און די טעקסט וועט זיין די עצם טעקסט וואס שאפט דעם בילד – די קאוד פון די מוסטער בלאט {{@}}.

דאס קומט צוניץ אין פעלער וואס די טעקסט דארף זיך נישט אפדעיטן, און די גאנצע מטרה איז צו שפּאָרן די "קאפי-פעיסט". ברייטע באניץ מיט'ן ס: דארט וואו עס פעלט זיך נישט אויס קיין אפדעיטס פארגרינגערט די לאסט אויף די המכלול סערווערס. פון די אנדערע זייט, די חסרון פון דעם מעגליכקייט איז אז עס איז סאך ווייניגער דינאמיש: אויב עפעס ווערט געטוישט אין די מוסטער, וועט זיך עס נישט אנזען (ווערן אפדעיטעד) אין די בלאט וואו דער מוסטער איז געווען געשריבן. עס איז נישט רעקאמענדירט זיך צו באניצן מיט דעם מעגליכקייט ביי נאוויגאציע מוסטערן אין ארטיקלען.

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

די אריגינעלע ענגלישע נאמען פאר ס: איז subst:.

השוואה

להלן השוואה בין תבנית רגילה, ותבנית עם התחילית ס::

צורת הכתיבה תצוגה בגלישה מבט אל דף העריכה

{{אחרי התנגשות}}

הוספתי לאחר התנגשות עריכה –

{{אחרי התנגשות}}

{{ס:אחרי התנגשות}}

הוספתי לאחר התנגשות עריכה –

<span style="font-size: 75%">הוספתי לאחר התנגשות עריכה -</span>

ווייטערפירונג בלעטער

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

רעפערירן צו א געווענליכע בלט ווי צו א מוסטער

מען קען זיך באציען צו יעדע בלאט ווי עס זאל ווען זיין א מוסטער, דורכ'ן אריינשטעלן די נאמען אין צוויי געקרייזעלטע קלאמערן און צולייגן ערשט : א (קאלאן) צום נאמען:

{{:נאמען פון בלאט}}

צום ביישפיל, אויב ווילט איר קאפירן דאס גאנצע אינהאלט פון ארטיקל "[[אידיש]" צו א געוויסע בלאט, שרייבט אין ציל בלאט די טעקסט:

{{:אידיש}}

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

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

{{המכלול:הילף טישל}}

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

אריינפלעכטן אונטער-בלאט בדף האב

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

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

{{/הוראות שימוש}}

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

מוסטערן וויזערד

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

  • צו ניצן דעם וויזערד, ווען איר זענט אין רעדאגירן בלאט, דרוקט דעם קנעפל Vector toolbar template button.png וואס געפינט זיך אין געצייג בּאַר אויבן. דער וויזערד וועט זיך עפענען אין א פענסטער, וואס ערמעגליכט צו אריינפילן די נאמען פון מוסטער וואס איר ווילט - פון א ליסטע. נאכ'ן דרוקן אויף "OK", וועט איר גרייכן דעם וויזערד אליין.
  • מען קען אויך טון פארקערט, און אויספילן דעם גאנצן מוסטער, אריינגערעכענט אלע פאראמעטערס. די וויזערד וועט צוזאמנעמען אלע ווערדן וואס איר האט געשריבן, און אנפילן די ריכטיגע קעסטלעך און אייך ווייזן דעם וויזערד.

טרעפט מער אינפארמאציע און פארברייטערטע ארטיקל.

רעדאגירן מוסטערן

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

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

פאסט אויף: מען דארף נעמען און באטראכט אז טוישן א מוסטער וועט אפעקטירן אסאך בלעטער, און דערפאר דארף מען מאכן זיכער אויף 100% אז דער טויש וועט נישט שעדיגן די אויסקוק אדער אירע פונקציעס!

ספעציעלע צייכנס

עטליכע צייכנס דארף מען שרייבן אויף א ספעציעלע וועג כדי זיי זאלן געהעריג צייגן אין א מוסטער:

צייכן אופן פון שרייבן
:
&#58;
;
&#59;
*
&#42;
#
&#35;

דער צייכן | (קו ניצב) טיילט אפ צווישן פאראמעטערס אין א מוסטער (זע ווייטער). אויב וויל מען צולייגן אזא צייכן אין א מוסטער, דארף מען עס שרייבן מיט'ן קאוד {{!}}. ביישפיל: צו שרייבן אין א מוסטער די טעקסט "האולימפיאדה || מדליית זהב לספורטאי ישראלי", דארף מען שרייבן האולימפיאדה {{!}}{{!}} מדליית זהב לספורטאי ישראלי.

נאך א וועג איז זיך צו באניצן מיט די טעגס <nowiki>, אדער מיט'ן מוסטער מוסטער:ללא קוד ויקי.

אנשטעלן פאראמעטערס פאר מוסטער

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

נאמען פאראמעטער

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

פאסט אויף: צולייגן צוויי געקרייזלטע קלאמערן וועט שאפן א פרישע מוסטער, און דערפאר דארף מען שטארק אויפפאסן און ציילן די צאל קלאמערן. ביישפיל וויאזוי צו שרייבן פאראמאטערס:

{{{נאמען פון פאראמעטער}}}

זיך באניצן שפעטער מיט'ן פאראמעטער אין ציל בלאט וועט געטון ווערן ווי פאלגענד:

  1. צוויי עפנענדע (רעכטע) גערייזעלטע קלאמערן (}})
  2. נאמען פון מוסטער
  3. אפטייל צייכן - פּייפּ (|)
  4. נאמען פון פאראמעטער
  5. איקוואל צייכן (=)
  6. ווערד פון פאראמעטער
  7. צוויי פארמאכנדע (לינקע) געקרייזעלטע קלאמערן ({{)

צו צולייגן נאך פאראמעטערס, גייט מען איבער די שטאפלען 3–6.

ביישפיל סינטעקס פון מוסטער מיט דריי פאראמעטערס:

{{נאמען פון מוסטער|פאראמעטער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" ווי דער ווערד אריינגעפילט, אבער עס וועט פארשטייט זיך נישט טרעפן א פאראמעטער מיט'ן נאמען "משפחת הפרפרים" און וועט גיבן א הודעת שגיאה. צו אויסקרויזן דעם פראבלעם, דארף מען זיך באניצן מיט די פאלגענדע קאוד אויפ'ן פלאץ פון סימני שווה:

&#61;

אדער זיך באניצן מיט'ן מוסטער "=":

{{=}}

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

מען קען ניצן אין איין מוסטער סיי נאמען פאראמעטערס און סיי נומער פאראמעטערס ביינאזאם. צום ביישפיל:

{{נאמען פון מוסטער|חיה=קאץ|2=שוארץ|מין=זכר|מבוית}}

אָנשטעלן דיפאלט אפציעס אין פאראמעטער

מען קען אָנשטעלן דיפאלט אפציעס פאר א פאראמעטער, אז אויב וועט נישט ווערן אריינגעלייגט א ווערד פאר'ן פאראמעטער, וועט ארויפקומען די דיפאלט טעקסט. צו אָנשטעלן די דיפאלטס פאר א פאראמעטער, צום ביישפיל, פאר א פאראמעטער {{{נאמען}}}, לייגט מען צו א פּייפּ (|) נאכ'ן נאמען פון פאראמעטער און דאן די דיפאלט טעקסט ווי פאלגנד:

{{{נאמען|דיפאלט טעקסט}}}

א ברייט באניצטע ביישפיל וואו מען באניצט זיך מיט דיפאלט טעקסט איז אריינלייגן אן אנדערע רעגולערע מוסטער אלץ דיפאלט, ווי {{בלאטנאמען אן קלאמערן|}} וואס שרייבט די ציל-בלאט נאמען. די קאוד:

{{{נאמען| {{בלאטנאמען אן קלאמערן|}} }}}

ערמעגליכט רעדאגירער צו אריינשרייבן די נאמען אין פאראמעטער, אבער אויב די פאראמעטער בלייבט ליידיג, וועט דער נאמען פון בלאט (אנע קלאמערן) ווערן אריינגעשטעלט דארט.

באקוקן עקזיסטענץ פון פאראמעטער

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

{{#if: {{{param|}}} | Hooray...! | Darn...! }}

רעזולטאט: Darn...!

אדער אויף העברעאיש:

{{#תנאי: {{{פרמטר|}}} | פארהאן ארטיקל...! | נישטא ארטיקל...! }}

רעזולטאט: נישטא ארטיקל...!

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

טוישן פאראמעטערס ביי עקזיסטירנדע מוסטער

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

אָנשטעלן א מוסטער פאר פאראמעטער

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

אינהאלט זאל צייגן נאר אין מוסטער בלאט אדער נאר אין בלעטער וואו מוסטער איז אריינגעפלאכטן

אינהאלט זאל צייגן נאר אין מוסטער בלאט

צומאל איז דא א געברויך אז געוויסע אינהאלט זאל צייגן נאר אין מוסטער בלאט, און נישט אין די בלעטער וואס האבן איר אריינגעפלאכטן (ווי אנווייזונגען וויאזוי צו ניצן די מוסטער, די מוסטער קאטעגאריע, אדער אונטער-וויקי לינקס). אין אזעלכע פעלער באניצט מען זיך מיט די טעג <noinclude> (אידיש: נישט אריינרעכענען) ווי פאלגענד:

<noinclude>אינהאלט וואס צייגט נאר אין מוסטער בלאט, נישט אין בלעטער וואו אריינגעפלאכטן.</noinclude>

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

באהאלטענע הערה אין מוסטער

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

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

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

תכנים שיופיעו רק בדפים המכילים את התבנית

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

<includeonly>תוכן שלא מופיע בדף התבנית, אבל מופיע בדפים המכילים אותה.</includeonly>

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

בדיקת השפעות השינויים בתבנית על דפים אחרים עוד בטרם שמירתה

Postscript-viewer-blue.svg הילף:זאמדקאסטן פאר מוסטערן

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

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

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

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

טבלאות


שגיאות פרמטריות במוסטער:להשלים
פארלאנגטע פאראמעטער [ נושא ] פעלן

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


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

{{{שם הסרט}}}
ז'אנר {{{ז'אנר}}}
אורך {{{אורך}}}
תאריך השקה {{{תאריך השקה}}}
{{{אתר אינטרנט}}}

הטבלה משתמשת בשני אמצעים עיקריים: בתבנית {{!}}, שמציגה קו אנכי (|) ובמשפט תנאי מסוג {{#תנאי:הפרמטר לבדיקה|מה לכתוב אם הפרמטר קיים|מה לכתוב אם הפרמטר אינו קיים}} (ראו סעיף "בדיקת קיום פרמטר").

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

• עבור כל שורה שבה שתי עמודות, יש להשתמש בקוד הבא:

{{#תנאי:{{{פרמטר|<noinclude>-</noinclude>}}} |
{{!}} פרמטר
{{!}} {{{פרמטר}}}
{{!}}-
}}

כאשר את הכיתוב "פרמטר" יש לשנות לשם הפרמטר.

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

{{#תנאי:{{{פרמטר|<noinclude>-</noinclude>}}} |
{{!}} colspan="2" סגנון {{!}} {{{פרמטר}}}
{{!}}-
}}

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

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

{| class="wikitable" align="left"
! colspan="2" | {{{שם הסרט| {{בלאטנאמען אן קלאמערן|}} }}}
{{!}}-
{{#תנאי:{{{ז'אנר|<noinclude>-</noinclude>}}} |
{{!}} ז'אנר
{{!}} {{{ז'אנר}}}
{{!}}-
}}
{{#תנאי:{{{אורך|<noinclude>-</noinclude>}}} |
{{!}} אורך
{{!}} {{{אורך}}}
{{!}}-
}}
{{#תנאי:{{{תאריך השקה|<noinclude>-</noinclude>}}} |
{{!}} תאריך השקה
{{!}} {{{תאריך השקה}}}
{{!}}-
}}
{{#תנאי:{{{אתר אינטרנט|<noinclude>-</noinclude>}}} |
{{!}} colspan="2" style="text-align: center;" {{!}} {{{אתר אינטרנט}}}
}}
|}
מוסטער
ז'אנר {{{ז'אנר}}}
אורך {{{אורך}}}
תאריך השקה {{{תאריך השקה}}}
{{{אתר אינטרנט}}}

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

בדיקת הפרמטרים

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

עדכוני תבניות, קטגוריות ודפים מקושרים

לעיתים, כשמעדכנים תבניות, עלולות לקרות שלוש תקלות:

  1. התבניות, בעיקר אם הן תבניות המוכללות בתבניות, לא מתעדכנות.
  2. הדף מופיע בקטגוריות שהוא הוסר מהן.
  3. הדף מופיע בדפים המקושרים לדף, או לתמונה, שהקישור אליהם הוסר מהתבנית. דבר זה גם גורם לכך שאי אפשר לדעת עד כמה באמת משתמשים בתמונות מיושנות, כגון Stop hand.png.

הבעיה נגרמת כתוצאה מחוסר עדכון של הרשימות הנחוצות.

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

תיעוד תבנית

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

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

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

<noinclude>{{תבנית:שם התבנית/שם דף המשנה}}</noinclude>

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

אפשרות נוספת היא לעשות שימוש בתבניות {{תיעוד}} או {{תיעוד תבנית}}, הדורשות רישום התיעוד בדף משנה ששמו "תיעוד".

המלצה: פרקטיקה מקובלת היא לכתוב את התיעוד והוראות השימוש אחרי הקוד הטכני של התבנית עצמה.

אשף התבניות

כדי להקל על המשתמשים בשימוש בתבנית, מומלץ להתאימה לשימוש ב"אשף התבניות" המציג הנחיות למילוי התבנית בחלון קופץ

המכלול:בוקמרקלטים

תבנית שהותאמה לשימוש בבוקמרקלטים מומלץ לעדכן בתיעוד על כך באמצעות התבנית {{יש בוקמרקלט}}, וכך גם לעודד את השימוש בבוקמרקלטים

ראו גם

דרויסנדיגע לינקס

טיילן פון דער בלאט זענען מעגליך איבערגעזעצט פון העברעאישער וויקיפעדיע
cc-by-sa 3.0 ערלויבעניש • אריגינעלער בלאט • ביישטייערער
גענומען פון "https://yi.hamichlol.org.il/w/index.php?title=המכלול:מוסטער&oldid=325181"