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

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

הנחיות

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

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

תיבות טקסט

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

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

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

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

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

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

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

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

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

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

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

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

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

דוגמה

הקוד הבא:

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

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

סבא שלי

סבתא שלי

אמא שלי

אבא שלי

הדודה שלי

אחי הגדול

אני!

אחותי הקטנה

פרמטרים

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

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

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

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

קווים מעורבים 1: r   ד   n   ]   #   [   j   ו   c   ~   !

קווים מעורבים 2: q   u   p   }   *   {   d   t   b   -   :

שונות:   T   G   X   K   k     U

הערות

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

תיבות טקסט יכולות לכלול קוד ויקי. התוכן של תיבות הטקסט נוצר באמצעות פרמטרים שמיים, בנוסף לפרמטר המגדיר את מיקום תיבת הטקסט. אורכה של כל תיבת טקסט – שלוש מרצפות, ולה בדרך כלל גבול שחור ברוחב של 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 באמצעות הפרמטר השמי עיצוב. עיצוב זה משפיע על הטבלה כולה.

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

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

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

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

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

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

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

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

מנוע רקטי

טורבינת גז קובץ:J85 ge 17a turbojet engine.jpg

מנוע בוכנה קובץ:Volkswagen W16.jpg

מקדחה

מעבורת חלל קובץ:Atlantis taking off on STS-27.jpg

מנוע סילון

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

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

מטוס קרב קובץ:F-15, 71st Fighter Squadron, in flight.JPG

מכונית

כלי טיס

מכסחת דשא קובץ:Electric mower underside.jpg

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

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