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