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