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

1,584 בייטן צוגעלייגט ,  פֿאַר 2 יאָר
אידיש
ק (החלפת טקסט – "{{כ}}" ב־"{{ר}}")
(אידיש)
שורה 164: שורה 164:
:<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>