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

1,501 בייטן צוגעלייגט ,  פֿאַר 2 יאָר
הגהה, אידיש
(המשך)
(הגהה, אידיש)
שורה 6: שורה 6:


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


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


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


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


====הגדרת תבנית כפרמטר====
====הגדרת תבנית כפרמטר====