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

תבנית מידע היא יחידה המשמשת ליצירת תבניות מידע (infobox) בצורה קלה והמקושרות לוויקינתונים.

==אופן השימוש==
להלן תיעוד קצר של הפרמטרים הנתמכים על ידי היחידה. ניתן להיעזר גם ב[[#דוגמאות שימוש]].
===הגדרת פרמטרים===
* היחידה תומכת בקבלת פרמטרים ממסופרים כאשר המספר מגדיר יחס סדר בין הפרמטרים
* סוגי הפרמטרים הנתמכים (יש להחליף את X במספר)
**'''תוויתX''' - תווית עבור פרמטר מספר X (לא יוצג ללא מילוי מידעX)
**'''מידעX''' - תוכן עבור פרמטר X 
***אם מופיע פרמטר תוויתX, יופיע משמאל לתווית המתאימה שהוגדרה
***אם לא מופיע פרמטר תוויתX, יוצג בשתי עמודות
*** '''תווית-מידעX''' - קיצור דרך כדי לציין פרמטר שהתווית שלו זהה לשם הפרמטר (מקביל ל "תוויתX=שם הפרמטר" בצירוף "<nowiki>מידעX={{{שם הפרמטר|}}}</nowiki>". התווית יכולה להכיל קישור, אשר מוסר משם הפרמטר.
** '''כותרתX''' - כותרת שתופיע לפני מקבץ של פרמטרים (הפרמטרים X+1, X+2 וכו'). הכותרת תופיע רק אם הפרמטרים שמופיעים בינה לבין הכותרת הבאה אחריה מלאים. (ראו removeEmptyHeaders)
** '''תמונה''' ו'''כיתוב''' - הגדרת התוכן שיופיע כתמונה, והתוכן שיופיע ככיתוב
**'''תמונה ימין''' ו'''תמונה שמאל''' - תוכן שיופיע עבור תמונה שתופיע מימין/שמאל (בתבנית שתומכות בתמונה ימנית ושמאלית)
**'''כותרת תבנית''' - מציין את הכותרת הראשית לתבנית. אם לא מוגדר בתבנית, כותרת ברירת המחדל היא פרמטר שם ולאחריו שם בשפת המקור.

===תמיכה בוויקינתונים===
התבנית תומכת במילוי אוטומטי של מידע מוויקינתונים כאשר לא מוזן מידע על ידי המשתמשים:
* עבור {{{שם הפרמטר}}} היחידה מחפשת הגדרה של "'''שם הפרמטר-ויקינתונים'''" המגדיר את שם התכונה שיש למשוך מוויקינתונים במקרה שהמידע לא הוזן על ידי המשתמש. לשימושים מתקדמים:
**'''שם הפרמטר-ויקינתונים''' מגדיר משיכה חכמה של פרמטרים מוויקינתונים, שיודעת להוסיף קישורים מתאימים לערכים, להגדיר תמונות , ולהוסיף "נכון ל" עבור ערכים מספריים (ראו עוד ב[[יחידה:PropertyLink]])
**'''שם הפרמטר-ויקינתונים-פשוט''' - מגדיר משיכה לא חכמה של פרמטרים מוויקינתונים
**'''שם הפרמטר-ויקינתונים-מרובה''' - מגדיר שאפשר למשוך מספר ערכים מוויקינתונים, כשכל ערך מופרד בפסיק. ניתן להעביר מספר פרמטרים בצורה "P1,P2" כך שגם P1 וגם P2 יימשכו, או "P1/P2" כך שאם P1 קיים הוא יימשך, אחרת - P2.

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

הגדרות מתקדמות נוספות לשליטה על אופן התצוגה של ערכים מיובאים מוויקינתונים:
*'''שם הפרמטר-ויקינתונים-מרובה-הפרדה''' - מאפשר להגדיר את התו המפריד בין ערכים שונים. ברירת המחדל היא פסיק (,). בשדות שעשויות להכיל תוכן רב, מומלץ להגדיר את ההפרדה כשבירת שורה (<nowiki><br></nowiki>)
*'''שם הפרמטר-ויקינתונים-פרטים''' - מאפשר להגדיר פרט אופציונלי נוסף שיופיע בסוגריים ליד הנתון. הפרט הנוסף צריך להיות שם של מבחין (Qualifier).
*'''שם הפרמטר-ויקינתונים-מגדר''' - יש לציין "כן" אם ערכי הפרמטר תלויים במגדר. למשל בפרמטר של "עיסוק" נרצה "סופר" או "סופרת" בהתאם למין.

===עיצוב===
הפרמטרים הבאים מאפשרים שליטה על עיצוב התבנית:
*'''עיצוב-שורהX''' - שליטה על עיצוב שורה
*'''תוויתX-עיצוב''' - שליטה על עיצוב תוויתX
*'''מידעX-עיצוב''' - שליטה על עיצוב מידעX
*'''כותרתX-עיצוב''' - שליטה על עיצוב כותרתX
*'''כותרת תבנית-עיצוב''' - הגדרת עיצוב לכותרת התבנית
*'''כותרת תבנית-מחלקה''' - הגדרת מחלקת עיצוב לכותרת התבנית
*'''טבלה-עיצוב''' - מגדירה את עיצוב הטבלה
*'''טבלה-מחלקה''' - מגדירה מחלקה לעיצוב הטבלה. דוגמאות למחלקות שימושיות:
**infobox-nowrap-labels - מגדירה ללא שבירות שורה בתוויות
**bordered - מוסיפה מסגרות

===הסתרת פרמטר===
כאשר מעוניינים להסתיר פרמטר שהתבנית מקבלת, ניתן להגדיר את הערך שלו כ"-".

==דוגמאות שימוש==
ניתן להיעזר בתבניות אחרות שמשתמשות ביחידה זו כדוגמאות ([[מיוחד:דפים המקושרים לכאן/יחידה:תבנית מידע]])
{{טורים|
{{מיוחד:דפים המקושרים לכאן/יחידה:תבנית מידע|namespace=10}}
}}