יחידה:תבנית מידע/תיעוד: הבדלים בין גרסאות בדף
אין תקציר עריכה |
אין תקציר עריכה |
||
| שורה 14: | שורה 14: | ||
** '''תמונה''' ו'''כיתוב''' - הגדרת התוכן שיופיע כתמונה, והתוכן שיופיע ככיתוב | ** '''תמונה''' ו'''כיתוב''' - הגדרת התוכן שיופיע כתמונה, והתוכן שיופיע ככיתוב | ||
**'''תמונה ימין''' ו'''תמונה שמאל''' - תוכן שיופיע עבור תמונה שתופיע מימין/שמאל (בתבנית שתומכות בתמונה ימנית ושמאלית) | **'''תמונה ימין''' ו'''תמונה שמאל''' - תוכן שיופיע עבור תמונה שתופיע מימין/שמאל (בתבנית שתומכות בתמונה ימנית ושמאלית) | ||
**'''כותרת תבנית''' - מציין את הכותרת הראשית לתבנית | **'''כותרת תבנית''' - מציין את הכותרת הראשית לתבנית. אם לא מוגדר בתבנית, כותרת ברירת המחדל היא פרמטר שם ולאחריו שם בשפת המקור. | ||
===תמיכה בוויקינתונים=== | ===תמיכה בוויקינתונים=== | ||
התבנית תומכת במילוי אוטומטי של מידע מוויקינתונים כאשר לא מוזן מידע על ידי המשתמשים: | התבנית תומכת במילוי אוטומטי של מידע מוויקינתונים כאשר לא מוזן מידע על ידי המשתמשים: | ||
* עבור {{{שם הפרמטר}}} היחידה מחפשת הגדרה של "'''שם הפרמטר-ויקינתונים'''" המגדיר את שם התכונה שיש למשוך מוויקינתונים במקרה שהמידע לא הוזן על ידי המשתמש. לשימושים מתקדמים: | * עבור {{{שם הפרמטר}}} היחידה מחפשת הגדרה של "'''שם הפרמטר-ויקינתונים'''" המגדיר את שם התכונה שיש למשוך מוויקינתונים במקרה שהמידע לא הוזן על ידי המשתמש. לשימושים מתקדמים: | ||
**'''שם הפרמטר-ויקינתונים''' מגדיר משיכה חכמה של פרמטרים מוויקינתונים, שיודעת להוסיף קישורים מתאימים לערכים, להגדיר תמונות , ולהוסיף "נכון ל" עבור ערכים מספריים (ראו עוד ב[[יחידה:PropertyLink]]) | **'''שם הפרמטר-ויקינתונים''' מגדיר משיכה חכמה של פרמטרים מוויקינתונים, שיודעת להוסיף קישורים מתאימים לערכים, להגדיר תמונות , ולהוסיף "נכון ל" עבור ערכים מספריים (ראו עוד ב[[יחידה:PropertyLink]]) | ||
**'''שם הפרמטר-ויקינתונים-פשוט''' - מגדיר משיכה לא חכמה של פרמטרים מוויקינתונים | **'''שם הפרמטר-ויקינתונים-פשוט''' - מגדיר משיכה לא חכמה של פרמטרים מוויקינתונים | ||
**'''שם הפרמטר-ויקינתונים-מרובה''' - מגדיר שאפשר למשוך מספר ערכים מוויקינתונים, כשכל ערך מופרד בפסיק. | **'''שם הפרמטר-ויקינתונים-מרובה''' - מגדיר שאפשר למשוך מספר ערכים מוויקינתונים, כשכל ערך מופרד בפסיק. | ||
פרמטרים מיוחדים: | |||
* '''קואורדינטות''' - עבור פרמטר שנקרא קואורידנטות התבנית מוסיפה בצורה אוטומטית {{תב|קואורדינטות מוויקינתונים}}. אין צורך להגדיר בצורה מיוחדת, אך יש להימנע ממתן שם "קואורדינטות" לפרמטר שלא מיועד לקואורדינטות גאוגרפיות | |||
* '''מפה-זום''' - עבור תבניות שמצפות למפה (פרמטר בשם מפה), ניתן לציין פרמטר זה להוספה אוטומטית של מפה עם זום ברירת מחדל במידה והעורכים לא ציינו מפה ספציפית בערך. | |||
* '''qid''' - ניתן לציין את שם היישות שממנה התבנית תשלוף מידע, לאו דווקא היישות של הערך (אפשרות זו לא נתמכת עבור קואורדינטות ועבור מפה) | |||
הגדרות מתקדמות נוספות לשליטה על אופן התצוגה של ערכים מיובאים מוויקינתונים: | הגדרות מתקדמות נוספות לשליטה על אופן התצוגה של ערכים מיובאים מוויקינתונים: | ||
*'''שם הפרמטר-ויקינתונים-מרובה-הפרדה''' - מאפשר להגדיר את התו המפריד בין ערכים שונים. ברירת המחדל היא פסיק (,). בשדות שעשויות להכיל תוכן רב, מומלץ להגדיר את ההפרדה כשבירת שורה (<nowiki><br></nowiki>) | *'''שם הפרמטר-ויקינתונים-מרובה-הפרדה''' - מאפשר להגדיר את התו המפריד בין ערכים שונים. ברירת המחדל היא פסיק (,). בשדות שעשויות להכיל תוכן רב, מומלץ להגדיר את ההפרדה כשבירת שורה (<nowiki><br></nowiki>) | ||
*'''שם הפרמטר-ויקינתונים-פרטים''' - מאפשר להגדיר פרט אופציונלי נוסף שיופיע בסוגריים ליד הנתון. הפרט הנוסף צריך להיות שם של מבחין (Qualifier). | *'''שם הפרמטר-ויקינתונים-פרטים''' - מאפשר להגדיר פרט אופציונלי נוסף שיופיע בסוגריים ליד הנתון. הפרט הנוסף צריך להיות שם של מבחין (Qualifier). | ||
*'''שם הפרמטר-ויקינתונים-מגדר''' - יש לציין "כן" אם ערכי הפרמטר תלויים במגדר. למשל בפרמטר של "עיסוק" נרצה "סופר" או "סופרת" בהתאם למין. | |||
===עיצוב=== | ===עיצוב=== | ||
גרסה אחרונה מ־19:33, 19 באוקטובר 2020
תבנית מידע היא יחידה המשמשת ליצירת תבניות מידע (infobox) בצורה קלה והמקושרות לוויקינתונים.
אופן השימוש[עריכת קוד מקור]
להלן תיעוד קצר של הפרמטרים הנתמכים על ידי היחידה. ניתן להיעזר גם ב#דוגמאות שימוש.
הגדרת פרמטרים[עריכת קוד מקור]
- היחידה תומכת בקבלת פרמטרים ממסופרים כאשר המספר מגדיר יחס סדר בין הפרמטרים
- סוגי הפרמטרים הנתמכים (יש להחליף את X במספר)
- תוויתX - תווית עבור פרמטר מספר X (לא יוצג ללא מילוי מידעX)
- מידעX - תוכן עבור פרמטר X
- אם מופיע פרמטר תוויתX, יופיע משמאל לתווית המתאימה שהוגדרה
- אם לא מופיע פרמטר תוויתX, יוצג בשתי עמודות
- תווית-מידעX - קיצור דרך כדי לציין פרמטר שהתווית שלו זהה לשם הפרמטר (מקביל ל "תוויתX=שם הפרמטר" בצירוף "מידעX={{{שם הפרמטר|}}}". התווית יכולה להכיל קישור, אשר מוסר משם הפרמטר.
- כותרתX - כותרת שתופיע לפני מקבץ של פרמטרים (הפרמטרים X+1, X+2 וכו'). הכותרת תופיע רק אם הפרמטרים שמופיעים בינה לבין הכותרת הבאה אחריה מלאים. (ראו removeEmptyHeaders)
- תמונה וכיתוב - הגדרת התוכן שיופיע כתמונה, והתוכן שיופיע ככיתוב
- תמונה ימין ותמונה שמאל - תוכן שיופיע עבור תמונה שתופיע מימין/שמאל (בתבנית שתומכות בתמונה ימנית ושמאלית)
- כותרת תבנית - מציין את הכותרת הראשית לתבנית. אם לא מוגדר בתבנית, כותרת ברירת המחדל היא פרמטר שם ולאחריו שם בשפת המקור.
תמיכה בוויקינתונים[עריכת קוד מקור]
התבנית תומכת במילוי אוטומטי של מידע מוויקינתונים כאשר לא מוזן מידע על ידי המשתמשים:
- עבור {{{שם הפרמטר}}} היחידה מחפשת הגדרה של "שם הפרמטר-ויקינתונים" המגדיר את שם התכונה שיש למשוך מוויקינתונים במקרה שהמידע לא הוזן על ידי המשתמש. לשימושים מתקדמים:
- שם הפרמטר-ויקינתונים מגדיר משיכה חכמה של פרמטרים מוויקינתונים, שיודעת להוסיף קישורים מתאימים לערכים, להגדיר תמונות , ולהוסיף "נכון ל" עבור ערכים מספריים (ראו עוד ביחידה:PropertyLink)
- שם הפרמטר-ויקינתונים-פשוט - מגדיר משיכה לא חכמה של פרמטרים מוויקינתונים
- שם הפרמטר-ויקינתונים-מרובה - מגדיר שאפשר למשוך מספר ערכים מוויקינתונים, כשכל ערך מופרד בפסיק.
פרמטרים מיוחדים:
- קואורדינטות - עבור פרמטר שנקרא קואורידנטות התבנית מוסיפה בצורה אוטומטית {{קואורדינטות מוויקינתונים}}. אין צורך להגדיר בצורה מיוחדת, אך יש להימנע ממתן שם "קואורדינטות" לפרמטר שלא מיועד לקואורדינטות גאוגרפיות
- מפה-זום - עבור תבניות שמצפות למפה (פרמטר בשם מפה), ניתן לציין פרמטר זה להוספה אוטומטית של מפה עם זום ברירת מחדל במידה והעורכים לא ציינו מפה ספציפית בערך.
- qid - ניתן לציין את שם היישות שממנה התבנית תשלוף מידע, לאו דווקא היישות של הערך (אפשרות זו לא נתמכת עבור קואורדינטות ועבור מפה)
הגדרות מתקדמות נוספות לשליטה על אופן התצוגה של ערכים מיובאים מוויקינתונים:
- שם הפרמטר-ויקינתונים-מרובה-הפרדה - מאפשר להגדיר את התו המפריד בין ערכים שונים. ברירת המחדל היא פסיק (,). בשדות שעשויות להכיל תוכן רב, מומלץ להגדיר את ההפרדה כשבירת שורה (<br>)
- שם הפרמטר-ויקינתונים-פרטים - מאפשר להגדיר פרט אופציונלי נוסף שיופיע בסוגריים ליד הנתון. הפרט הנוסף צריך להיות שם של מבחין (Qualifier).
- שם הפרמטר-ויקינתונים-מגדר - יש לציין "כן" אם ערכי הפרמטר תלויים במגדר. למשל בפרמטר של "עיסוק" נרצה "סופר" או "סופרת" בהתאם למין.
עיצוב[עריכת קוד מקור]
הפרמטרים הבאים מאפשרים שליטה על עיצוב התבנית:
- עיצוב-שורהX - שליטה על עיצוב שורה
- תוויתX-עיצוב - שליטה על עיצוב תוויתX
- מידעX-עיצוב - שליטה על עיצוב מידעX
- כותרתX-עיצוב - שליטה על עיצוב כותרתX
- כותרת תבנית-עיצוב - הגדרת עיצוב לכותרת התבנית
- כותרת תבנית-מחלקה - הגדרת מחלקת עיצוב לכותרת התבנית
- טבלה-עיצוב - מגדירה את עיצוב הטבלה
- טבלה-מחלקה - מגדירה מחלקה לעיצוב הטבלה. דוגמאות למחלקות שימושיות:
- infobox-nowrap-labels - מגדירה ללא שבירות שורה בתוויות
- bordered - מוסיפה מסגרות
הסתרת פרמטר[עריכת קוד מקור]
כאשר מעוניינים להסתיר פרמטר שהתבנית מקבלת, ניתן להגדיר את הערך שלו כ"-".
דוגמאות שימוש[עריכת קוד מקור]
ניתן להיעזר בתבניות אחרות שמשתמשות ביחידה זו כדוגמאות (מיוחד:דפים המקושרים לכאן/יחידה:תבנית מידע)
- תבנית:אישיות רבנית1 (הכללה) (→ קישורים | עריכה)
- תבנית:תפקיד מנהיג (הכללה) (→ קישורים | עריכה)
- תבנית:אישיות רבנית (הכללה) (→ קישורים | עריכה)