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

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

הנחיות

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

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

תיבות טקסט

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

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

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

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

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

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

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

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

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

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

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

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

דוגמה

הקוד הבא:

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

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

סבא שלי

סבתא שלי

אמא שלי

אבא שלי

הדודה שלי

אחי הגדול

אני!

אחותי הקטנה

דוגמה לעץ עם 5 דורות:

ה1

ה2

ה3

ה4

ה5

ה6

ה7

ה8

ה9

ה10

ה11

ה12

ה13

ה14

ה15

ה16

ד1

ד2

ד3

ד4

ד5

ד6

ד7

ד8

סבתא1

סבא1

סבתא2

סבא2

אמא

אבא

ילד

פרמטרים

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

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

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

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

מעורב: * ||   } ||   { ||   # ||   ד ||   ו ||   ] ||   [ ||

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

עיצוב

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

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

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

תיבה 1

תיבה 2

תיבה 3

תיבה 4

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

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

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

תיבה לבנה

תיבה אדומה

תיבה ירוקה

תיבה כחולה

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

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

דוגמה מוחשית: השושלת של רות המואביה:

{{עץ משפחה/התחלה|עיצוב=background-color: #afa;}}
{{עץ משפחה| | | | | |סבא רבא|~|ד|~|סבתא רבא| |סבא רבא=♂ בועז|סבתא רבא=♀ רות המואביה}}
{{עץ משפחה| | | | | | |.|-|-|`| | | | | }}
{{עץ משפחה| | | | | | סבא| | | | | | סבא=עובד|}}
{{עץ משפחה| | | | | | |!| | | | | | | | }}
{{עץ משפחה| | | | | | אבא|~|ד|~| אמא| | אבא=ישי|אמא=נצבת בת עדאל}}
{{עץ משפחה| | | | | |.|-|-|-|+|-|-|-|,| }}
{{עץ משפחה| | | | | דוד | | צרויה| |אביגיל| דוד='''דוד המלך'''|צרויה=צרויה|אביגיל=אביגיל}}
{{עץ משפחה| | |.|-|-|(| | ||!| | ||!| }}
{{עץ משפחה| |שלמה | | אבשלום | | יואב | | עמשא| | | אבשלום=אבשלום|יואב=יואב (שר צבא דוד)|עמשא=עמשא (שר צבא דוד)|שלמה='''שלמה המלך'''}}
{{עץ משפחה/סוף}}

יתן את הסכימה הבאה:

♂ בועז

♀ רות המואביה

עובד

ישי

נצבת בת עדאל

דוד המלך

צרויה

אביגיל

שלמה המלך

אבשלום

יואב (שר צבא דוד)

עמשא (שר צבא דוד)

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

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