תבנית:עץ משפחה/תיעוד

תבנית זו משמשת לבניית עץ משפחה פשוט המבוסס על תחביר המזכיר אמנות ASCII. העץ מוצג כטבלת HTML המשתמשת בעיצובי CSS. ניתן להשתמש ולהיעזר בקודי ויקי בטקסט לצורך יצירת קישורים פנימיים.

הנחיות

יש לפתוח את הסכימה עם התבנית {{עץ משפחה/התחלה}}
ולסגור אותה עם התבנית {{עץ משפחה/סוף}}.

בין שתי תבניות אלו יש להשתמש בתבנית {{עץ משפחה}}
כאשר לסירוגין בשורה אחת יש לכתוב את השמות של תיבות הטקסט והכיתוב שלהן
ובשורה השנייה יש לכתוב את תווי הבקרה של המרצפות, שיוצרות חיבורים בין תיבות הטקסט.

תיבות טקסט

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

הצורה הבסיסית של הכתיבה היא:

שם תיבת טקסט| שם תיבת טקסט=כיתוב פנימי של תיבת הטקסט.

למשל בדוגמה הבאה:

{{עץ משפחה| | | | סבא | | | |סבא=[[סבא]] שלי}}

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

הקו הניצב ("|") מבטא עמודה נוספת בתוך התרשים.

יש לוודא כי שם תיבת הטקסט יהיה זהה בשתי הפעמים בהן הוא נכתב.

ההבדל בין שם לכיתוב

כאשר התוכנה מזהה סתם תו היא "יודעת" שמדובר או בתו בקרה או בשם של תיבת טקסט. כאשר היא מזהה את סימן השוויון ("=") היא "יודעת" שמדובר בכיתוב בלבד.

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

בחלק של הכיתוב, ניתן להוסיף תווי ויקי רגילים כמו הדגשה, קו תחתי, טקסט מוגדל, ^{טקסט עילי}, ואף לשלב תבניות אחרות.

דוגמה

הקוד הבא:

{{עץ משפחה/התחלה}}
{{עץ משפחה| | | | סבא |~|ד|~| סבתא | | סבתא=סבתא שלי|סבא=סבא שלי}}
{{עץ משפחה| | | | | | | |)|-|-|-|,| }}
{{עץ משפחה| | | אמא |ד| אבא | |דודה| אמא=אמא שלי|אבא=אבא שלי|דודה=[[הדודה שלי]]}}
{{עץ משפחה| |.|-|-|-|+|-|-|-|,| | | }}
{{עץ משפחה| אח | | אני | | אחות | | | אח=אחי הגדול|אני='''אני!'''|אחות=אחותי הקטנה}}
{{עץ משפחה/סוף}}

יוצר את העץ הבא:

סבא שלי

סבתא שלי

אמא שלי

אבא שלי

הדודה שלי

אחי הגדול

אני!

אחותי הקטנה

פרמטרים

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

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

קווים מוצקים: ,   .   `   '   ^   ז   (   )   -   !   +

קווים מקווקווים: ק   7   \   /   צ   ה   ג   ץ   ~   :   %

קווים מעורבים: *   }   {   #   ד   ו   ]   [

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

עיצוב

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

גבול

{{עץ משפחה/התחלה}}
{{עץ משפחה|גבול=0|עיצוב=background:#dfd;| | אחת |ד| שתיים | |אחת=תיבה 1|שתיים=תיבה 2}}
{{עץ משפחה|גבול=0|עיצוב=background:#dfd;| | |.|-|^|-|,| | }}
{{עץ משפחה|גבול=0|עיצוב=background:#dfd;| | אחת | | שתיים | |אחת=תיבה 3|שתיים=תיבה 4}}
{{עץ משפחה/סוף}}

ייצר את העץ הבא:

תיבה 1

תיבה 2

תיבה 3

תיבה 4

עיצוב

ניתן גם להוסיף עיצוב ספציפי לכל תיבת טקסט.

יש להתייחס לשם תיבת הטקסט באופן הבא:

|עיצוב_<<שם שדה>>=נוסחת עיצוב;

למשל:

{{עץ משפחה/התחלה}}
{{עץ משפחה| | | | |לבן| | | | |לבן=תיבה לבנה}}
{{עץ משפחה| |.|-|-|`|!|'|-|-|,| }}
{{עץ משפחה|אדום  |~|ירוק|~|כחול |אדום=תיבה אדומה|ירוק=תיבה ירוקה|כחול=תיבה כחולה
|עיצוב_אדום=background-color: #faa; border: 5px solid blue;
|עיצוב_ירוק=background-color: #afa;
|עיצוב_כחול=background-color: #aaf;
}}
{{עץ משפחה/סוף}}

היוצר את עץ המשפחה הבא:

תיבה לבנה

תיבה אדומה

תיבה ירוקה

תיבה כחולה

שימו לב: כאשר מבקשים להוסיף עיצוב לתיבות ספציפיות, יש לוודא ששמות התיבות מיושרות לימין (כלומר, שאין רווח מימין לשם, למשל: "|אדום  |" ולא "| אדום |"), אחרת התבנית תחפש פרמטר עיצוב המתחיל ברווח.

גם בתבנית {{עץ משפחה/התחלה}} ניתן להוסיף עיצוב CSS באמצעות הפרמטר השמי עיצוב. עיצוב זה משפיע על הטבלה כולה.

קישורים ותמונות

ניתן להוסיף קישורי ויקי בתרשים. את הקישורים יש לרשום בחלק השני לאחר סימן השוויון ("="). לדוגמה: מנוע=[[מנוע]]. (זהו החלק בו ניתן להוסיף עיצובי ויקי, כמו הדגשה, קו תחתי וכדומה).

כמו כן, ניתן להוסיף תמונות. את התמונה יש להוסיף בחלק השני.

{{עץ משפחה/התחלה}}
{{עץ משפחה| | | | | | | | מנוע |מנוע= '''מנוע''' [[מכונה]] הממירה [[אנרגיה]] ל[[עבודה (פיזיקה)|עבודה מכנית]]. [[תמונה:SWassermotor.png|80px]]}}
{{עץ משפחה| | | | | | | |.|-|^|-|-|-|-|-|,| | }}
{{עץ משפחה| | | | | | | מנוע חום| | | | | |מנוע חשמלי| |מנוע חום= [[מנוע חום]] {{ש}} ממיר מ[[אנרגיה תרמית]] |מנוע חשמלי=[[מנוע חשמלי]] ממיר  מ[[אנרגיה חשמלית]] [[תמונה:Motors01CJC.jpg|50px]] }}
{{עץ משפחה| | |.|-|-|-|-|+|-|-|-|,| | | |!| }}
{{עץ משפחה| | מנוע רקטי| | | טורבינת גז | |מנוע בוכנה | | מקדחה| | | מנוע בוכנה =[[מנוע בוכנה]] [[תמונה:Volkswagen W16.jpg|50px]] | טורבינת גז=[[טורבינת גז]] [[תמונה:J85 ge 17a turbojet engine.jpg|50px]]|מנוע רקטי=[[מנוע רקטי]]|מקדחה=[[מקדחה]]}}
{{עץ משפחה| | |!| | | |!| | |.|-|^|-|-|-|,| }}
{{עץ משפחה| | מעבורת חלל| | מנוע סילון | |מנוע ארבע פעימות | | |מנוע שתי פעימות | מנוע שתי פעימות=מנוע שתי פעימות|מנוע ארבע פעימות=מנוע ארבע פעימות|מנוע סילון=[[מנוע סילון]] [[תמונה:Iwtschenko AI-25 1.jpg|50px]] |מעבורת חלל=[[מעבורת חלל]][[תמונה:Atlantis taking off on STS-27.jpg|50px]] }}
{{עץ משפחה| | | | | | |!| | |.|-|^|-|,| | |'|,| }}
{{עץ משפחה| | | | |מטוס קרב| | מכונית| | כלי טיס| |מכסחת דשא |מכונית=[[מכונית]] |מכסחת דשא=[[מכסחת דשא]] [[תמונה:Electric mower underside.jpg|50px]] | כלי טיס=[[כלי טיס]]|מטוס קרב=[[מטוס קרב]] {{ש}}[[תמונה:F-15, 71st Fighter Squadron, in flight.JPG|50px]] }}
{{עץ משפחה/סוף}}

נותן את העץ הבא:

מנוע מכונה הממירה אנרגיה לעבודה מכנית.

מנוע חום ממיר מאנרגיה תרמית

מנוע חשמלי ממיר מאנרגיה חשמלית

מנוע רקטי

טורבינת גז

מנוע בוכנה

מקדחה

מעבורת חלל

מנוע סילון

מנוע ארבע פעימות

מנוע שתי פעימות

מטוס קרב

מכונית

כלי טיס

מכסחת דשא

קווים מנחים נוספים

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