עריכת הדף "תבנית:דף מתחלף/עזרה"

=<u>עזרה עבור סדרת תבניות לדפים מתחלפים</u>=
==כללי==
סדרת התבניות "דף מתחלף" מיועדות עבור תצוגה מתחלפת התלויה בתאריכים. לדוגמה: אזור בדף של פורטל ובו תקצירים של מאמרים שונים - אשר יתחלפו לפי הקשרים של תאריכים לועזיים או עבריים, או למשל אזור בעמוד הראשי ובו תקצירים של פורטלים - שייתחלפו אף הם לפי הקשרים של תאריכים.

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

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

==תבניות "חוקים" עבור תאריכים עבריים==
סדרת תבניות ובהן "חוקים" עבור תאריכים עבריים. <small>(מי שפונה אל תבניות אלה הינה [[:תבנית:דף מתחלף]] אשר מנסה לאתר "חוק" לפי התאריך העברי הנוכחי)</small>.

שם כל אחת מהתבניות האלה יהיה:
 תבנית:'''<סוג תחלופה>'''-'''<חודש עברי>'''-'''<יום עברי>'''
*'''<סוג תחלופה>''' = כמפורט בסעיף הקודם, כגון '''פורטלים''' עבור תחלופת תקצירי פורטלים. בעתיד יהיו סוגי תחלופה נוספים לצרכים שונים.
*'''<חודש עברי>''' = שם חודש עברי כגון '''אדר א''''.
*'''<יום עברי>''' = יום בחודש עברי כגון '''ט"ז'''.
לדוגמה: [[תבנית:פורטלים-אדר ב'-י"ד]] = תבנית לקביעת "חוק" עבור י"ד באדר ב' לסוג התחלופה "פורטלים".

*בשורה הראשונה:קטגוריה (תחת תג noinclude כדי שהקטגוריה לא תופיע גם בדף שקורא לתבנית זו).
*בשורה השנייה: פונקציית [[עזרה:הוראות תנאי#בחר|#בחר]]. פונקציה זו מופעלת על פרמטר 1 (פרמטר זה מחושב אוטמטית ואין צורך לקבוע את הערך שלו) המקבל את אחד מחמשת הערכים הבאים:
:*1 = יום רגיל.
:*2 = יום רגיל, שאיננו חג או מועד, אך עליו הערה בלוח השנה (ערב חג, אסרו חג, פורים קטן, יום הרצל וכדומה). 
:*3 = יום צום / יום זיכרון. 
:*4 = יום חג שאיננו שבתון (חול המועד, פורים, וכדומה). 
:*5 = יום טוב / יום שבתון. 
*בשורה השלישית: דוגמה לקריאה לתבנית ובה המלל הנדרש, במקרה ובאותו יום חל יום מסוג 3 (יום זיכרון).
*בשורה הרביעית: דוגמה לקריאה לתבנית ובה המלל הנדרש, במקרה ובאותו יום חל יום מסוג אחר (שאיננו יום זיכרון).
*בשורה החמישית: }} לסיום פונקציית [[עזרה:הוראות תנאי#בחר|#בחר]].

==תבניות "חוקים" עבור תאריכים לועזיים==
סדרת תבניות ובהן "חוקים" עבור תאריכים לועזיים. <small>(מי שפונה אל תבניות אלה הינה [[:תבנית:דף מתחלף שלב ב]] אשר מנסה לאתר "חוק" לפי התאריך הגרגוריאני הנוכחי)</small>.

שם כל אחת מהתבניות האלה יהיה:
 תבנית:'''<סוג תחלופה>'''-'''<חודש לועזי>'''-'''<יום לועזי>'''
*'''<סוג תחלופה>''' = כמפורט בסעיפים הקודמים, כגון '''פורטלים''' עבור תחלופת תקצירי פורטלים. בעתיד יהיו סוגי תחלופה נוספים לצרכים שונים.
*'''<חודש לועזי>''' = שם חודש גרגוריאני כגון '''יולי'''.
*'''<יום לועזי>''' = יום בחודש גרגוריאני כגון '''1''' עבור היום הראשון בחודש.
לדוגמה: [[תבנית:פורטלים-יולי-4]] = תבנית לקביעת "חוק" עבור 4 ביולי לסוג התחלופה "פורטלים".

גם בתבניות אלה ניתן להכליל חוק פשוט או חוק מורכב - באותן אופן כמו בחוקים לתאריכים העבריים.

==תבניות "חוק" ברירת מחדל==
תבנית ובה "חוק" עבור ברירת מחדל. <small>(מי שפונה אל תבניות אלה הינה [[:תבנית:דף מתחלף שלב ב]] - אם לא הצליחה לאתר "חוק" לפי התאריך הגרגוריאני הנוכחי)</small>.

שם התבנית יהיה:
 תבנית:'''<סוג תחלופה>'''-ברירת מחדל
*'''<סוג תחלופה>''' = כמפורט בסעיפים הקודמים, כגון '''פורטלים''' עבור תחלופת תקצירי פורטלים. בעתיד יהיו סוגי תחלופה נוספים לצרכים שונים.
לדוגמה: [[תבנית:פורטלים-ברירת מחדל]] = תבנית לקביעת "חוק" ברירת מחדל עבור סוג התחלופה "פורטלים".

גם בתבנית זו ניתן להכליל חוק פשוט או חוק מורכב - באותן אופן כמו בחוקים לתאריכים העבריים.

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

[[קטגוריה:תאריכים לפורטלים|*]]
<noinclude>
[[קטגוריה:תבניות עזר לתבניות]]
</noinclude>