עריכת הדף "משתמש:שלוימל'ה/תבנית:עץ משפחה/תיעוד"

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

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

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

=== תיבות טקסט ===
באופן בסיסי הטקסט שבתבנית מתחלק ל'''שמות''' של תיבות טקסט ול'''כיתוב''' שבתוכן.<br />
<big>השם</big> הוא השם הפנימי (והבלתי נראה) של תיבת הטקסט, והוא העוגן למיקום שבו תופיע תיבת הטקסט במסך. ואילו <big>הכיתוב</big> הוא התוכן שיופיע בתוך תיבת הטקסט, שהוא גמיש מאוד ויכול להכיל תכנים מגוונים.

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

למשל בדוגמה הבאה:
:<nowiki>{{משתמש:שלוימל'ה/תבנית:עץ משפחה| | | | סבא | | | |סבא=[[סבא]] שלי}}</nowiki>

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

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

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

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

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

בחלק של הכיתוב, ניתן להוסיף תווי ויקי רגילים כמו '''הדגשה''', <u>קו תחתי</u>, <big>טקסט מוגדל</big>, <sup>טקסט עילי</sup>, ואף לשלב תבניות אחרות.

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

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

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

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

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

{| width="100%" align="center"
|-
|
{|
|+ '''קווים מוצקים:'''
|-
| <big><tt>,</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|,}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>.</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|.}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>`</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|`}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>'</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|'}}{{עץ משפחה/סוף}} || &nbsp;
|-
| <big><tt>^</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|^}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>ז</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|ז}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>(</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|(}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>)</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|)}}{{עץ משפחה/סוף}} || &nbsp;
|-
| <big><tt>-</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|-}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>!</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|!}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>+</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|+}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt> </tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה| }}{{עץ משפחה/סוף}} || &nbsp;
|}
|
{|
|+ '''קווים מקווקווים:'''
|-
| <big><tt>ק</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|ק}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>7</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|7}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>\</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|\}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>/</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|/}}{{עץ משפחה/סוף}} || &nbsp;
|-
| <big><tt>צ</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|צ}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>ה</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|ה}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>ג</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|ג}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>ץ</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|ץ}}{{עץ משפחה/סוף}} || &nbsp;
|-
| <big><tt>~</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|~}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>:</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|:}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>%</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|%}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt> </tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה| }}{{עץ משפחה/סוף}} || &nbsp;
|}
|
{|
|+ '''קווים מעורבים:'''
|-
| <big><tt>*</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|*}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>}</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|}|}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>{</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|{|}}{{עץ משפחה/סוף}} || &nbsp;
|-
| <big><tt>#</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|#}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>ד</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|ד}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>ו</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|ו}}{{עץ משפחה/סוף}} || &nbsp;
|-
| <big><tt>]</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|]}}{{עץ משפחה/סוף}} || &nbsp;
| <big><tt>[</tt></big> || style="border: 1px solid gray;" | {{עץ משפחה/התחלה}}{{עץ משפחה|[}}{{עץ משפחה/סוף}} || &nbsp;
|}
|}
<br />

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

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

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

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

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

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

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

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

למשל:

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

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

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

'''שימו לב:''' כאשר מבקשים להוסיף עיצוב לתיבות ספציפיות, יש לוודא ששמות התיבות מיושרות ל'''ימין''' (כלומר, שאין רווח מימין לשם, למשל: "<code>|אדום&nbsp;&nbsp;|</code>" ולא "<code>|&nbsp;אדום&nbsp;|</code>"), אחרת התבנית תחפש פרמטר עיצוב המתחיל ברווח.

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

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

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

<pre><nowiki>
{{עץ משפחה/התחלה}}
{{עץ משפחה| | | | | | | | מנוע |מנוע= '''מנוע''' [[מכונה]] הממירה [[אנרגיה]] ל[[עבודה (פיזיקה)|עבודה מכנית]]. [[קובץ:ךלחי.png]]}}
{{עץ משפחה| | | | | | | |.|-|^|-|-|-|-|-|,| | }}
{{עץ משפחה| | | | | | | מנוע חום| | | | | |מנוע חשמלי| |מנוע חום= [[מנוע חום]] {{ש}} ממיר מ[[אנרגיה תרמית]] |מנוע חשמלי=[[מנוע חשמלי]] ממיר מ[[אנרגיה חשמלית]] [[קובץ: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]] }}
{{עץ משפחה/סוף}}
</nowiki></pre>

נותן את העץ הבא:
{{עץ משפחה/התחלה}}
{{עץ משפחה| | | | | | | | מנוע |מנוע= '''מנוע''' [[מכונה]] הממירה [[אנרגיה]] ל[[עבודה (פיזיקה)|עבודה מכנית]]. [[קובץ:ךלחי.png]]}}
{{עץ משפחה| | | | | | | |.|-|^|-|-|-|-|-|,| | }}
{{עץ משפחה| | | | | | | מנוע חום| | | | | |מנוע חשמלי| |מנוע חום= [[מנוע חום]] {{ש}} ממיר מ[[אנרגיה תרמית]] |מנוע חשמלי=[[מנוע חשמלי]] ממיר מ[[אנרגיה חשמלית]] [[קובץ: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]] }}
{{עץ משפחה/סוף}}

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

<includeonly>

[[קטגוריה:תבניות פרמטריות - כללי]]

[[en:Template:Familytree/doc]]
[[br:Patrom:Gwezenn lignez]]
[[ca:Ajuda:Crear un arbre genealògic]]
[[ca:Plantilla:Arbre genealògic]]
[[cs:Šablona:Rodokmen]]
[[de:Vorlage:Stammbaum]]
[[es:Plantilla:Árbol genealógico]]
[[fa:الگو:شجره‌نامه]]
[[fr:Modèle:Arbre généalogique]]
[[ja:Template:Familytree]]
[[lt:Šablonas:Familytree]]
[[ka:თარგი:გენეალოგია]]
[[pl:Szablon:Familytree]]
[[pt:Predefinição:Árvore genealógica]]
[[ro:Format:ArboreGenealogic]]
[[ru:Шаблон:Familytree]]
[[sr:Шаблон:Родослов]]
[[sv:Mall:Släktträd]]
[[th:แม่แบบ:Familytree]]
[[zh:Template:Familytree]]
</includeonly>