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

עזרה עבור סדרת תבניות לדפים מתחלפים

כללי

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

השימוש בדף הפורטל (או בעמוד הראשי) יהיה באמצעות תבנית אחת בלבד: תבנית:דף מתחלף.

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

שימוש בתבנית:דף מתחלף

קריאה לתבנית תבנית:דף מתחלף באופן הבא, עם פרמטר אחד:

{{דף מתחלף|<סוג תחלופה>}}

<סוג תחלופה> =

• פורטלים = עבור תחלופת תקצירי פורטלים.
• בעתיד יהיו סוגי תחלופה נוספים לצרכים שונים.

תבניות "חוקים" עבור תאריכים עבריים

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

שם כל אחת מהתבניות האלה יהיה:

תבנית:<סוג תחלופה>-<חודש עברי>-<יום עברי>

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

לדוגמה: תבנית:פורטלים-אדר ב'-י"ד = תבנית לקביעת "חוק" עבור י"ד באדר ב' לסוג התחלופה "פורטלים".

חוק פשוט עבור תאריך עברי

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

שורה 1 <noinclude>[[קטגוריה:תאריכים לפורטלים|פורטלים-תשרי-א']]</noinclude>

שורה 2 {{:פורטל:יהדות/תקציר}}

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

חוק מורכב עבור תאריך עברי

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

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

לאור זאת תכולת תבנית:פורטלים-אייר-ה':

שורה 1 <noinclude>[[קטגוריה:תאריכים לפורטלים|פורטלים-אייר-ה']]</noinclude>

שורה 2 {{#בחר:{{{1}}}

שורה 3 |3={{:פורטל:צה"ל/תקציר}}

שורה 4 |{{:פורטל:ישראל/תקציר}}

שורה 5 }}

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

• 1 = יום רגיל.
• 2 = יום רגיל, שאיננו חג או מועד, אך עליו הערה בלוח השנה (ערב חג, אסרו חג, פורים קטן, יום הרצל וכדומה).
• 3 = יום צום / יום זיכרון.
• 4 = יום חג שאיננו שבתון (חול המועד, פורים, וכדומה).
• 5 = יום טוב / יום שבתון.

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

תבניות "חוקים" עבור תאריכים לועזיים

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

שם כל אחת מהתבניות האלה יהיה:

תבנית:<סוג תחלופה>-<חודש לועזי>-<יום לועזי>

• <סוג תחלופה> = כמפורט בסעיפים הקודמים, כגון פורטלים עבור תחלופת תקצירי פורטלים. בעתיד יהיו סוגי תחלופה נוספים לצרכים שונים.
• <חודש לועזי> = שם חודש גרגוריאני כגון יולי.
• <יום לועזי> = יום בחודש גרגוריאני כגון 1 עבור היום הראשון בחודש.

לדוגמה: תבנית:פורטלים-יולי-4 = תבנית לקביעת "חוק" עבור 4 ביולי לסוג התחלופה "פורטלים".

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

תבניות "חוק" ברירת מחדל

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

שם התבנית יהיה:

תבנית:<סוג תחלופה>-ברירת מחדל

• <סוג תחלופה> = כמפורט בסעיפים הקודמים, כגון פורטלים עבור תחלופת תקצירי פורטלים. בעתיד יהיו סוגי תחלופה נוספים לצרכים שונים.

לדוגמה: תבנית:פורטלים-ברירת מחדל = תבנית לקביעת "חוק" ברירת מחדל עבור סוג התחלופה "פורטלים".

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

שלבי התבנית לפורטל היום

בקצרה, לתבנית יש שלושה שלבים:

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

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