הצגת המקור של הדף "תבנית:תבנית מידע/תיעוד"

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

התבנית תורגמה מהתבנית המקבילה בוויקיפדיה האנגלית – [[:en:Template:Infobox|Template:Infobox]], המכילה אפשרויות ויכולות רבות. עובדה זו מאפשרת לייבא תבניות מידע מוויקיפדיה האנגלית בקלות יחסית (ראו פסקת "[[#ייבוא תבניות מידע|ייבוא תבניות מידע]]" בהמשך).

== שימוש ==
התבנית מכילה מספר מקטעים, המאפשרים גמישות מקסימלית. כל המקטעים הם אופציונליים, ומוצגים רק אם צוינו במפורש. להלן מקטעי התבנית לפי סדר הופעתם בתבנית, מלמעלה למטה:
# '''כותרת תבנית''' – כותרת הנמצאת מעל לגוף התבנית.
# '''למעלה''' – טקסט הנמצא בחלק העליון ביותר של גוף התבנית.
# '''תתי-כותרות''' – שתי תתי-כותרות בראש התבנית.
# '''תמונות''' – שתי תמונות, כולל כיתוב בתחתית כל תמונה.
# '''שורות''' – 81 שורות המהוות את גוף התבנית. כל שורה יכולה להכיל כותרת לרוחב כל התבנית, או תווית ומידע המתחלקים ברוחב התבנית, או מידע בלבד. ראו דוגמה בהמשך. רצוי למספר את השורות בקפיצות של 3 - 5 כדי לאפשר הכנסת שורות נוספות בעתיד בין שורות קיימות ללא צורך במספור מחדש של כל השורות בתבנית.
# '''למטה''' – טקסט הנמצא בחלק התחתון ביותר של גוף התבנית.

ניתן לעצב כל מקטע בתבנית על ידי שימוש במחלקות [[CSS]], ו/או בטקסט CSS. בדומה למקטעים עצמם, גם אלמנטי העיצוב הם אופציונליים.

=== פרמטרים ===
כל הפרמטרים הם אופציונליים. התבנית מקבלת את הפרמטרים הבאים:
# כותרת תבנית:
#* '''כותרת תבנית''' – הטקסט שיופיע בכותרת התבנית.
#* '''כותרת תבנית-מחלקה''' – מחלקת CSS לעיצוב כותרת התבנית.
#* '''כותרת תבנית-עיצוב''' – טקסט CSS לעיצוב כותרת התבנית.
# למעלה:
#* '''למעלה''' – הטקסט שיופיע במקטע "למעלה".
#* '''למעלה-מחלקה''' – מחלקת CSS לעיצוב מקטע "למעלה".
#* '''למעלה-עיצוב''' – טקסט CSS לעיצוב מקטע "למעלה".
# תתי-כותרות:
#* '''תת-כותרת''' / '''תת-כותרת1''' – הטקסט שיופיע בתת-הכותרת הראשונה.
#* '''תת-כותרת2''' – הטקסט שיופיע בתת-הכותרת השנייה.
#* '''תת-כותרת-מחלקה''' – מחלקת CSS לעיצוב תתי-הכותרות.
#* '''תת-כותרת-עיצוב''' – טקסט CSS לעיצוב תתי-הכותרות.
#* '''תת-כותרת1-עיצוב''' – טקסט CSS לעיצוב תת-הכותרת הראשונה בלבד.
#* '''תת-כותרת2-עיצוב''' – טקסט CSS לעיצוב תת-הכותרת השנייה בלבד.
#* '''תת-כותרת-שורה-מחלקה''' / '''תת-כותרת1-שורה-מחלקה''' – מחלקת CSS לעיצוב השורה של תת-הכותרת הראשונה.
#* '''תת-כותרת2-שורה-מחלקה''' – מחלקת CSS לעיצוב השורה של תת-הכותרת השנייה.
# תמונות:
#* '''תמונה''' / '''תמונה1''' – התמונה הראשונה, יש להשתמש בכתיב מלא ("<nowiki>[[קובץ:example.png|200px]]</nowiki>" ולא "example.png").
#* '''תמונה2''' – התמונה השנייה.
#* '''תמונה-מחלקה''' – מחלקת CSS לעיצוב התמונות.
#* '''תמונה-עיצוב''' – טקסט CSS לעיצוב התמונות.
#* '''כיתוב תמונה''' / '''כיתוב תמונה1''' – הכיתוב שיופיע מתחת לתמונה הראשונה.
#* '''כיתוב תמונה2''' – הכיתוב שיופיע מתחת לתמונה השנייה.
#* '''כיתוב תמונה-עיצוב''' – טקסט CSS לעיצוב כיתובי התמונות.
#* '''תמונה1-שורה-מחלקה''' – מחלקת CSS לעיצוב השורה של התמונה הראשונה.
#* '''תמונה2-שורה-מחלקה''' – מחלקת CSS לעיצוב השורה של התמונה השנייה.
# שורות:
#* '''כותרת1''' - '''כותרת80''' – הטקסט שיופיע בעיצוב של כותרת בשורה זו. אם נעשה שימוש בפרמטר זה, השורה תעוצב ככותרת, ולא יוצגו הפרמטרים "תווית" ו"מידע" של אותה שורה.
#* '''תווית1''' - '''תווית80''' – הטקסט שיופיע בעיצוב של תווית בשורה זו.
#* '''מידע1''' - '''מידע80''' – הטקסט שיופיע בעיצוב של מידע בשורה זו.
#* '''מחלקה1''' - '''מחלקה80''' – מחלקת CSS לעיצוב הטקסט בשורה: הכותרת במקרה של שורת כותרת, או המידע במקרה של שורת תווית/מידע או שורת מידע בלבד.
#* '''שורה1-מחלקה''' - '''שורה80-מחלקה''' – מחלקת CSS לעיצוב השורה עצמה. רלוונטי רק עבור שורות תווית/מידע ושורות מידע בלבד.
#* '''כותרת-עיצוב''' – טקסט CSS לעיצוב שורות כותרת.
#* '''תווית-עיצוב''' – טקסט CSS לעיצוב השדה "תווית" בשורות תווית/מידע.
#* '''מידע-עיצוב''' – טקסט CSS לעיצוב השדה "מידע" בשורות תווית/מידע או בשורות הכוללת רק את שדה "מידע".
# למטה:
#* '''למטה''' – הטקסט שיופיע במקטע "למטה".
#* '''למטה-מחלקה''' – מחלקת CSS לעיצוב מקטע "למטה".
#* '''למטה-עיצוב''' – טקסט CSS לעיצוב מקטע "למטה".
# פרמטרים כלליים:
#* '''תבנית בת=כן''' – עבור שילוב של תבנית מידע אחת בתוך תבנית מידע שנייה.
#* '''ריחוף''' – מיקום התבנית באחד מצדי המסך, כאשר שאר הטקסט נמצא לצד התבנית: שמאל ('''ריחוף = שמאל''') או ימין ('''ריחוף = ימין'''). ברירת המחדל באקו-ויקי העברית היא ריחוף בצד שמאל. לביטול הריחוף, ניתן להשתמש בפרמטר '''ריחוף = לא'''.
#* '''מחלקה''' – מחלקת CSS לעיצוב התבנית עצמה.
#* '''עיצוב''' – טקסט CSS לעיצוב התבנית עצמה.
#* '''שם''' – פרמטר לא בשימוש. בוויקיפדיה האנגלית הוא משמש להצגת שורת ניווט בתחתית התבנית עם קישורים לדף התבנית, דף שיחת התבנית ודף עריכת התבנית.
#* '''כותרת נטויה''' – פרמטר לא בשימוש. בוויקיפדיה האנגלית הוא משמש להצגת שם הערך בכתב נטוי.

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

{|
|-
! שדה אופציונלי רגיל
| style="width: 2em;" |
! שדה אופציונלי שיוצג בדף התבנית
|-
|
<pre>
| תווית5 = אוכלוסייה
| מידע5 = {{{אוכלוסייה|}}}
</pre>
| ||
<pre>
| תווית5 = אוכלוסייה
| מידע5 = {{{אוכלוסייה<includeonly>|</includeonly>}}}
</pre>
|}

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

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

<pre style="overflow: auto;">
| כותרת1 = {{#תנאי:{{{פריט ראשון|}}}{{{פריט שני|}}}{{{פריט שלישי|}}}|כותרת אופציונלית}}
| תווית2 = פריט ראשון
| מידע2 = {{{פריט ראשון|}}}
| תווית3 = פריט שני
| מידע3 = {{{פריט שני|}}}
| תווית4 = פריט שלישי
| מידע4 = {{{פריט שלישי|}}}
</pre>

== דוגמאות ==
{{תבנית מידע
| כותרת תבנית-מחלקה = 
| כותרת תבנית-עיצוב = color: red;
| כותרת תבנית = בדיקת תבנית מידע
| למעלה-מחלקה = usermessage
| למעלה-עיצוב = color: green;
| למעלה = טקסט למעלה
| תת-כותרת = תת-כותרת1
| תת-כותרת2-עיצוב = color: blue;
| תת-כותרת2 = תת-כותרת2
| תמונה-עיצוב = border: 1px dotted gray;
| תמונה = [[קובץ:example.png|200px]]
| תמונה2 = [[קובץ:Wikipedia-logo-v2-he.svg|135px]]
| כיתוב תמונה-עיצוב = 
| כיתוב תמונה = כיתוב לתמונה הראשונה
| כיתוב תמונה2 = 
| כותרת-עיצוב = background: #ccf;
| תווית-עיצוב = background: #ddf;
| מידע-עיצוב = 
| כותרת1 = רק כותרת מוגדרת (1)
| תווית1 = 
| מידע1 = 
| כותרת2 = 
| תווית2  = רק תווית מוגדרת, השורה לא מוצגת (צריך מידע) (2)
| מידע2 = 
| כותרת3 =
| תווית3 = 
| מידע3 = רק מידע מוגדר (3)
| כותרת4 = כל השדות מוגדרים (כותרת, תווית ומידע), רק הכותרת מוצגת (4)
| תווית4 = תווית, לא מוצגת כי יש כותרת (4)
| מידע4 = מידע, לא מוצג כי יש כותרת (4)
| כותרת5 = 
| תווית5 = תווית ומידע מוגדרים (תווית) (5)
| מידע5 = תווית ומידע מוגדרים (מידע) (5)
|למטה-עיצוב = background: #aaa;
|למטה = טקסט למטה
}}

<pre style="overflow: auto;">
{{תבנית מידע
| כותרת תבנית-מחלקה = 
| כותרת תבנית-עיצוב = color: red;
| כותרת תבנית = בדיקת תבנית מידע
| למעלה-מחלקה = usermessage
| למעלה-עיצוב = color: green;
| למעלה = טקסט למעלה
| תת-כותרת = תת-כותרת1
| תת-כותרת2-עיצוב = color: blue;
| תת-כותרת2 = תת-כותרת2
| תמונה-עיצוב = border: 1px dotted gray;
| תמונה = [[קובץ:example.png|200px]]
| תמונה2 = [[קובץ:Wikipedia-logo-v2-he.svg|135px]]
| כיתוב תמונה-עיצוב = 
| כיתוב תמונה = כיתוב לתמונה הראשונה
| כיתוב תמונה2 = 
| כותרת-עיצוב = background: #ccf;
| תווית-עיצוב = background: #ddf;
| מידע-עיצוב = 
| כותרת1 = רק כותרת מוגדרת (1)
| תווית1 = 
| מידע1 = 
| כותרת2 = 
| תווית2  = רק תווית מוגדרת, השורה לא מוצגת (צריך מידע) (2)
| מידע2 = 
| כותרת3 =
| תווית3 = 
| מידע3 = רק מידע מוגדר (3)
| כותרת4 = כל השדות מוגדרים (כותרת, תווית ומידע), רק הכותרת מוצגת (4)
| תווית4 = תווית, לא מוצגת כי יש כותרת (4)
| מידע4 = מידע, לא מוצג כי יש כותרת (4)
| כותרת5 = 
| תווית5 = תווית ומידע מוגדרים (תווית) (5)
| מידע5 = תווית ומידע מוגדרים (מידע) (5)
|למטה-עיצוב = background: #aaa;
|למטה = טקסט למטה
}}
</pre>
{{-}}

=== שילוב תבנית בתוך תבנית ===
ניתן לשלב תבנית מידע אחת בתוך תבנית מידע אחרת על ידי שימוש בפרמטר "תבנית בת=כן". יכולת זו יכולה לשמש ליצירת תבניות מידע מודולריות.

{{תבנית מידע
| כותרת תבנית = כותרת רמה עליונה
| מידע1 = {{תבנית מידע
  | תבנית בת = כן
  | כותרת תבנית = תבנית בת ראשונה
  | תווית-עיצוב = background: lightgrey; padding: 2em 0; text-align: center; font-weight: normal;
  | מידע-עיצוב = background: lightgrey;  padding: 2em 0; text-align: center;
  | תווית1= תווית 1.1
  | מידע1 = מידע 1.1
  | תווית2= תווית 1.2
  | מידע2 = מידע 1.2
}}
| מידע2 = {{תבנית מידע
  | תבנית בת = כן
  | כותרת תבנית = תבנית בת שנייה
  | תווית1= תווית 2.1
  | מידע1 = מידע 2.1
}}
| למטה = טקסט למטה
}}

<pre style="overflow: auto;">
{{תבנית מידע
| כותרת תבנית = כותרת רמה עליונה
| מידע1 = {{תבנית מידע
  | תבנית בת = כן
  | כותרת תבנית = תבנית בת ראשונה
  | תווית-עיצוב = background: lightgrey; padding: 2em 0; text-align: center; font-weight: normal;
  | מידע-עיצוב = background: lightgrey;  padding: 2em 0; text-align: center;
  | תווית1= תווית 1.1
  | מידע1 = מידע 1.1
  | תווית2= תווית 1.2
  | מידע2 = מידע 1.2
}}
| מידע2 = {{תבנית מידע
  | תבנית בת = כן
  | כותרת תבנית = תבנית בת שנייה
  | תווית1= תווית 2.1
  | מידע1 = מידע 2.1
}}
| למטה = טקסט למטה
}}
</pre>

== ייבוא תבניות מידע ==
תבנית זו תורגמה מהתבנית המקבילה בוויקיפדיה האנגלית – [[:en:Template:Infobox|Template:Infobox]], ולכן ניתן לייבא תבניות מידע מוויקיפדיה האנגלית בקלות יחסית.

על מנת לייבא תבנית מסוימת, נדרש לתרגם לעברית את כל הפרמטרים לפי הטבלה הבאה.
{| class="wikitable mw-collapsible mw-collapsed autocollapse"
|-
! פרמטר בעברית !! פרמטר באנגלית !! הערות
|-
| ריחוף || dir="ltr" | float ||
|-
| מחלקה || dir="ltr" | bodyclass ||
|-
| עיצוב || dir="ltr" | bodystyle ||
|-
| כותרת תבנית || dir="ltr" | title ||
|-
| כותרת תבנית-מחלקה || dir="ltr" | titleclass ||
|-
| כותרת תבנית-עיצוב || dir="ltr" | titlestyle ||
|-
| למעלה || dir="ltr" | above ||
|-
| למעלה-מחלקה || dir="ltr" | aboveclass ||
|-
| למעלה-עיצוב || dir="ltr" | abovestyle ||
|-
| תת-כותרת(#) || dir="ltr" | subheader(#) || (#) = 1 או 2 או ריק
|-
| תת-כותרת-מחלקה || dir="ltr" | subheaderclass ||
|-
| תת-כותרת(#)-עיצוב || dir="ltr" | subheaderstyle(#) || (#) = 1 או 2 או ריק
|-
| תת-כותרת(#)-שורה-מחלקה || dir="ltr" | subheaderrowclass(#) || (#) = 1 או 2 או ריק
|-
| תמונה(#) || dir="ltr" | image(#) || (#) = 1 או 2 או ריק
|-
| תמונה-מחלקה || dir="ltr" | imageclass ||
|-
| תמונה-עיצוב || dir="ltr" | imagestyle ||
|-
| כיתוב תמונה(#) || dir="ltr" | caption(#) || (#) = 1 או 2 או ריק
|-
| כיתוב תמונה-עיצוב || dir="ltr" | captionstyle ||
|-
| תמונה(#)-שורה-מחלקה || dir="ltr" | imagerowclass(#) || (#) = 1 או 2
|-
| כותרת-עיצוב || dir="ltr" | headerstyle ||
|-
| תווית-עיצוב || dir="ltr" | labelstyle ||
|-
| מידע-עיצוב || dir="ltr" | datastyle ||
|-
| כותרת(#) || dir="ltr" | header(#) || (#) = מספר בין 1 ל־80
|-
| תווית(#) || dir="ltr" | label(#) || (#) = מספר בין 1 ל־80
|-
| מידע(#) || dir="ltr" | data(#) || (#) = מספר בין 1 ל־80
|-
| מחלקה(#) || dir="ltr" | class(#) || (#) = מספר בין 1 ל־80
|-
| שורה(#)-מחלקה || dir="ltr" | rowclass(#) || (#) = מספר בין 1 ל־80
|-
| למטה || dir="ltr" | below ||
|-
| למטה-מחלקה || dir="ltr" | belowclass ||
|-
| למטה-עיצוב || dir="ltr" | belowstyle ||
|-
| תבנית בת || dir="ltr" | child ||
|-
| שם || dir="ltr" | name || הפרמטר לא בשימוש בעברית, אין להעתיק אותו.
|-
| כותרת נטויה || dir="ltr" | italic title || הפרמטר לא בשימוש בעברית, אין להעתיק אותו.
|-
| || dir="ltr" | decat || הפרמטר לא קיים בעברית, ניתן להתעלם ממנו.
|}

== תבנית ריקה להעתקה ==
הערות:
* התבנית יכולה לקבל עד 80 שורות. רק 10 שורות מוצגות מטה. אם נדרש, ניתן להמשיך לפי הסדר עד 80.
* הפרמטרים מסוג מחלקת CSS הושמטו כי הם לרוב לא בשימוש.
* ניתן ואף מומלץ להשתמש במספרי שורות עם דילוגים (למשל: 5, 10, 15...) על מנת לאפשר הוספה קלה של שורות בעתיד.

<pre style="overflow: auto;">
{{תבנית מידע
| עיצוב = 
| כותרת תבנית-עיצוב = 
| כותרת תבנית = 
| למעלה-עיצוב = 
| למעלה = 
| תת-כותרת1-עיצוב = 
| תת-כותרת1 = 
| תת-כותרת2-עיצוב = 
| תת-כותרת2 = 
| תמונה-עיצוב = 
| תמונה = 
| כיתוב תמונה-עיצוב = 
| כיתוב תמונה = 
| תמונה2 = 
| כיתוב תמונה2 = 
| כותרת-עיצוב = 
| תווית-עיצוב = 
| מידע-עיצוב = 
| כותרת1 = 
| תווית1 = 
| מידע1 = 
| כותרת5 = 
| תווית5 = 
| מידע5 = 
| כותרת10 = 
| תווית10 = 
| מידע10 = 
| כותרת15 = 
| תווית15 = 
| מידע15 = 
| כותרת20 = 
| תווית20 = 
| מידע20 = 
| כותרת25 = 
| תווית25 = 
| מידע25 = 
| כותרת30 = 
| תווית30 = 
| מידע30 = 
| כותרת35 = 
| תווית35 = 
| מידע35 = 
| כותרת40 = 
| תווית40 = 
| מידע40 = 
| כותרת45 = 
| תווית45 = 
| מידע45 = 
| למטה-עיצוב = 
| למטה = 
}}
</pre>
<includeonly>

[[קטגוריה:תבניות מידע|*]]
</includeonly>
<noinclude>
{{תיעוד תבנית}}
</noinclude>