תבנית:תבנית מידע/תיעוד

מתוך ויקיחדשות, מקור החדשות החופשי

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

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

שימוש[עריכה]

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

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

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

פרמטרים[עריכה]

כל הפרמטרים הם אופציונליים. התבנית מקבלת את הפרמטרים הבאים:

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

יצירת תבנית עם שדה אופציונלי[עריכה]

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

שדה אופציונלי רגיל שדה אופציונלי שיוצג בדף התבנית
| תווית5 = אוכלוסייה
| מידע5 = {{{אוכלוסייה|}}}
| תווית5 = אוכלוסייה
| מידע5 = {{{אוכלוסייה<includeonly>|</includeonly>}}}

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

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

| כותרת1 = {{#תנאי:{{{פריט ראשון|}}}{{{פריט שני|}}}{{{פריט שלישי|}}}|כותרת אופציונלית}}
| תווית2 = פריט ראשון
| מידע2 = {{{פריט ראשון|}}}
| תווית3 = פריט שני
| מידע3 = {{{פריט שני|}}}
| תווית4 = פריט שלישי
| מידע4 = {{{פריט שלישי|}}}

דוגמאות[עריכה]

בדיקת תבנית מידע
טקסט למעלה
תת-כותרת1
תת-כותרת2

כיתוב לתמונה הראשונה
רק כותרת מוגדרת (1)
רק מידע מוגדר (3)
כל השדות מוגדרים (כותרת, תווית ומידע), רק הכותרת מוצגת (4)
תווית ומידע מוגדרים (תווית) (5) תווית ומידע מוגדרים (מידע) (5)
טקסט למטה
{{תבנית מידע
| כותרת תבנית-מחלקה = 
| כותרת תבנית-עיצוב = 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;
|למטה = טקסט למטה
}}

שילוב תבנית בתוך תבנית[עריכה]

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

כותרת רמה עליונה
תבנית בת ראשונה
תווית 1.1 מידע 1.1
תווית 1.2 מידע 1.2
תבנית בת שנייה
תווית 2.1 מידע 2.1
טקסט למטה
{{תבנית מידע
| כותרת תבנית = כותרת רמה עליונה
| מידע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
}}
| למטה = טקסט למטה
}}

ייבוא תבניות מידע[עריכה]

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

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

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

תבנית ריקה להעתקה[עריכה]

הערות:

  • התבנית יכולה לקבל עד 80 שורות. רק 10 שורות מוצגות מטה. אם נדרש, ניתן להמשיך לפי הסדר עד 80.
  • הפרמטרים מסוג מחלקת CSS הושמטו כי הם לרוב לא בשימוש.
  • ניתן ואף מומלץ להשתמש במספרי שורות עם דילוגים (למשל: 5, 10, 15...) על מנת לאפשר הוספה קלה של שורות בעתיד.
{{תבנית מידע
| עיצוב = 
| כותרת תבנית-עיצוב = 
| כותרת תבנית = 
| למעלה-עיצוב = 
| למעלה = 
| תת-כותרת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 = 
| למטה-עיצוב = 
| למטה = 
}}