עריכת הדף "תבנית:תרשים/תיעוד"

דף זה מאגד מספר כלים ל'''[[חב"דפדיה:עורך חזותי|עריכה חזותית]]''' של תרשימים (עצי משפחה, תרשימי זרימה וכדומה) בחב"דפדיה. מערכת כלים זו מהווה אלטרנטיבה חזותית ל{{תב|עץ משפחה}} ומבוססת על עקרונות עיצוביים דומים.
==הוראות הפעלה==
===יצירת תרשים חדש===
* צרו דף במרחב טיוטה או במרחב המשתמש שלכם בשם מתאים
* היכנסו לעריכת קוד מקור של הדף והוסיפו את טקסט הבא: 
<code>
<nowiki>{{</nowiki>ס:תרשים/קנבס 16x32<nowiki>}}</nowiki>
{{ש}}
<nowiki><noinclude>{{נוצר באמצעות תרשים}}</noinclude></nowiki>
</code> 
:(אפשר לבחור גם קנבס 32x32)
* שמרו את הדף.
===עריכת התרשים===
* {{עוגן|סעיף 5|פתחו בחלון נפרד את {{עריכת תבנית|תרשים/סרגל כלים|סרגל הכלים במצב עריכה חזותית}}. שימו לב, למרות שסרגל הכלים נפתח במצב העריכה, אין מטרה לערוך אותו, אלא להשתמש בו לצורך עריכת התרשים שלכם. אל תלחצו על "פרסום שינויים" בדף זה אלא אם כן אתם באמת מתכוונים לזה.}}
* {{עוגן|סעיף 5.5|היכנסו לעריכה חזותית של הדף. בדף תופיע טבלה ריקה.}}
* {{עוגן|סעיף 6|ערכו את התרשים שלכם באמצעות העורך החזותי ובעזרת פעולות העתק-הדבק מסרגל הכלים (ראו [[#הוראות עריכה|הוראות עריכה]] או [[#דוגמה מפורטת|דוגמה מפורטת]] למטה). שמרו מעת לעת.}}
* בסיום העבודה, מחקו את כל השורות והעמודות המיותרות מהתרשים שלכם ושמרו אותו.
* העבירו אותו למרחב תבנית בשם הרצוי.

===טיפים===
# מומלץ להפעיל את הכלי לאחר ביטול "מצב רוחב מוגבל" ב[[מיוחד:העדפות#mw-prefsection-rendering|תפריט ההעדפות]] והסתרה של סרגלי הצד.{{הערה|שם=וקטור2022|אפשר לקבל אפקט דומה על ידי מעבר לתצוגת "וקטור ישן (2010)"}}
# מומלץ לא להתחיל מקנבס גדול מידי. ניתן להוסיף שורות ועמודות לפי הצורך.
# מומלץ לעבוד עם 2 מסכים בעת עריכת התרשימים - האחד לתרשים והאחר לסרגל כלים.
# אם רוצים שהתרשים יופיע בתוך מסגרת ניתנת להסתרה, מומלץ להשתמש ב{{תב|מעטפת תרשים}}. יש לכך גם מספר יתרונות עיצוביים נוספים.

==הוראות עריכה==
התרשים מורכב בעיקרו מתיבות ומרצפות (ניתן להוסיף רכיבים נוספים לפי הצורך).
* '''תיבה''' - בדומה ל{{תב|תבנית:עץ משפחה}} התיבה בנויה בדרך כלל מ-3 תאי טבלה. אולם ניתן ליצור תאים בכל גודל רצוי. בסרגל הכלים מופיעים תאים ב-3 גדלים
:* שימוש בתיבות מוכנות:
::* העתק את התיבה מסרגל הכלים (או מתיבה שכבר קיימת בתרשים שלך).
::* הדבק למקום הרצוי - סמן את מקום תחילת ההדבקה (הצד הימני העליון שלה) ובצע "הדבק". אם מסמנים מספר תאים אז המקום הקובע הוא של התא הימני העליון. ההדבקה דורסת את מה שהיה בתאים.
::* לחץ לחיצה כפולה על התיבה כדי להיכנס לתא המתאים 
::* לחץ לחיצה נוספת כדי להיכנס לתבנית התיבה.
::* נפתח חלון ועליו כפתור "עריכה". לחץ עליו
::* עכשיו תוכל למלא את טקסט התיבה ומידע נוסף. (ראה פירוט ב{{תב|תרשים/תיבה}}). הטקסט יכול לכלול קוד ויקי.
:* הרחבת תיבה קיימת: אם רוצים ליצור תיבה בגודל שלא זמין בסרגל הכלים, ניתן ליצור תיבה קטנה יותר, לסמן אותה יחד עם מספר תאים משמאלה ומתחתיה, וללחוץ על "מיזוג". הדבר ידרוס את התאים האחרים שסומנו.
* '''מרצפת''' - רכיב המקביל ל"מרצפות" ב{{תב|תבנית:עץ משפחה}}. הרכיב כולל קווים שבאמצעותם ניתן לחבר את התיבות. ככלל כל מרצפת תופסת תא אחד, אך אפשר ליצור מרצפות בגדלים שונים בהתאם לצורך (לדוגמה, אם רוצים ליצור קו ארוך וכיתוב ממורכז מעליו).
:* שימוש במרצפת קיימת: 
::*בחר את המרצפת מרצויה מסרגל הכלים (או מרצפת שכבר קיימת בתרשים שלך). 
::*"העתק" אותה ו"הדבק" אותה למקומות הרצויים בטבלה.  ההדבקה דורסת את מה שהיה בתאים. 
::*בדומה לתיבה, ניתן לבחור מאפינים של המרצפת. ראה פירוט ב{{תב|מרצפת}}.
:* שימוש במרצפות אוניברסליות: 
::*בסרגל הכלים מופיעות 2 מרצפות אוניברסליות. הן צבועות במספר צבעים ומעוצבות בסיגנונות קוו שונים. למרצפות אלה יש מאפיינים רבים המאפשרים להתאים אותן לצרכים שונים. ראה פירוט ב{{תב|מרצפת}}. כל אחת מהמרצפות האוניברסליות מורכבת מ - 4 רכיבים. אולם, אין צורך להשתמש בכולם. אם לא מעוניינים ברכיב מסוים יש ללבחור את  ה"עובי" שלו להיות 0.
::*אם זקוקים למרצפת שלא מופיעה בסרגל הכליים. צרו עותק נוסף של המרצפת האוניברסלית המתאימה לכם בסרגל הכלים. בחרו את המאפינים הרצויים. והשתמשו בה.
::*אם המרצפת שיצרתם נראית לכם שימושית גם בתרשימים אחרים, אז אתם מוזמנים לשמור את סרגל הכילים ובכך להוסיף אותה אליו באופן קבוע - [[חב"דפדיה:היו נועזים בעריכת ערכים|היו נועזים]].
:::* במקרה כזה מומלץ גם להוסיף אותה לתבנית {{תב|מרצפת}} (ראו פירוט בדף התבנית)
:* איחוד מרצפות: ניתן למזג תאים בהם יש מרצפות שונות. במקרה כזה המרצפת העליונה הימנית תשתלט על כל התאים. ככלל זה לא מומלץ. למשל, אם רוצים ליצור קו אופקי ארוך עדיף להדביק מספר פעמים את אותה המרצפת. אולם הדבר יכול להיות שימושי למטרות מסוימות, למשל לצורך הוספת כיתוב.
* '''חץ'''
:*ניתן להוסיף ראש חץ לקווים במרצפות השונות. לשם כך יש לבצע את הפעולות הבאות:
::* להיכנס בסרגל הכלים לתא בו נמצאים החיצים (על ידי לחיצה כפולה).
::* ללחוץ על החץ הרצוי ולהעתיק אותו.
::* להיכנס לתא בו נמצאת המרצפת אליה רוצים להוסיף את החץ.
::* לבצע פעולת הדבקה.
::* לבחור את המאפיינים הרצויים לחץ, ראה פירוט ב{{תב|תרשים/חץ}}.
:*לאחר שילוב החץ בתא הרצוי ניתן להעתיק את התא הכולל את החץ ואת המרצפת כמקשה אחת ולהשתמש בו במקומות שונים בתרשים.
:*''הערות''
::* ניתן להוסיף מספר חיצים לאותו התא.
::* במקרה שהתרשים מופיע במרחב הערכים על רקע לא לבן (כמו למשל כשהוא משולב בתבנית ניווט) אז יש להתאים את רקע החץ לרקע היעד.
::* במאפייני החץ, יש לבחור עובי קו זהה לעובי הקו עליו ישב החץ.
::* נכון לעכשיו במקדמי הגדלה מתחת ל-100% החיצים לעיתים לא מיושרים היטב.
* '''הוספת כיתוב'''
:*ניתן להוסיף כיתוב לכל תא ריק על ידי לחיצה כפולה עליו. 
:*אם בתא יש מרצפת יש להקיש לאחר מכן על "הוספת פסקה". הוספת כיתוב למרצפת עובדת באופן מיטבי כאשר המרצפת היא של קו מאוזן ({{תב|מרצפת|-}}). במקרה כזה ניתן להוסיף את הכיתוב הן מעל הקו והן מתחתיו. האפשרות "הוספת פסקה" מופיעה בשני מקומות אלה. מומלץ להשתמש בתבנית {{תב|כיתוב קו}} למטרה זאת.  התבנית מקטינה את הטקסט, גורמת לכך שלא יגלוש, ומרפדת אות משני צדדיו ברווח כך שלא יגע בתאים השכנים.
:* טקסט מוסף יכול לכלול קוד ויקי.
* '''הוספת רכיבים נוספים'''
:* מרצפות ותיבות הן תבניות. ניתן להוסיף אותן באופן ידיני כתבניות (במקום להעתיק אותם מסרגל הכלים).
:* ניתן גם ליצור תבניות חדשות עם רכיביים עיצוביים שונים ולהוסיף אותן.
:* ממלץ להסתכל ב{{תב|מרצפת}} ו{{תב|תרשים/תיבה}} כדי לראות איך ליצור תבנית שתמלא את כל התא בטבלה.
:* אם מוסיפים מרצפת בתור תבנית, יש למחוק ראשית את תכולת התא. גם הוא הוא נראה ריק, יש בו מרצפת ריקה כבררת מחדל.
* '''מחיקה''' 
:*ניתן למחוק את תכולתו של כל תא על ידי לחיצה על הכפתור del במקלדת.
:*אם התא הוא מיזוג של מספר תאים אז ניתן לפצל אותו חזרה על ידי לחיצה על התא ואז על "ביטול מיזוג"
:*בקנבס המקורי, כל התאים מכילם "מרצפת ריקה". לאומת זאת, תאים שתכולתם נמחקה לא מכילם מרצפת כזאת. בדרך כלל, אין לדבר השפעה. אולם, כאשר תיבת תקסט נמצאת בקצה התרשים ואין מעל הקצה שלה מרצפות בכלל (ריקות או לא) זה משבש את תצוגתה. במקרה כזה די להוסיף מרצפת ריקה לאחד התאים מעל (או מתחת) לקצה התיבה. ניתן לעשות זאת באמצעות העתקה מכל תא שנראה ריק בסרגל הכלים או מכל תא בתרשים שתכולתו לא נמחקה.
* '''הוספת שורות ועמודות''' - ניתן לעשות זאת כמקובל בעריכה חזותית של טבלאות. תאים חדשים שיתווספו יהיו נטולי מרצפות כלל (גם לא ריקה). אם זה יוצר בעיה ניתן לטפל בזה כמו בסעיף הקודם.

== יבוא ==
יש סקריפט [[פייתון]] המאפשר להמיר תרשימים שנוצרו באמצעות {{תב|עץ משפחה}} לתרשימים הניתנים לעריכה חזותית באופן המוסבר למעלה. הסקריפט לא עובד באופן מושלם ובמקרים רבים נדרשת עריכה ידנית לאחר היבוא.
===הוראות שימוש בסקריפט===
* היכנסו ל[https://colab.research.google.com/drive/1Si2KnlmZMaqL4saqxhQMlJrniOaA7t01?usp=sharing קישור לסקריפט]
* החליפו את הטקסט: {{קוד|<nowiki>כתוב כאן את הטקסט להמרה. לדוגמה:
        {{עץ משפחה|!}} 
        {{עץ משפחה|-}}
</nowiki>}} בקוד המקור של עץ המשפחה אותו אתם מעוניינים להמיר. ניתן להמיר מספר תבנית {{תב|עץ משפחה}} ביחד. אין צורך להעתיק את הקידומת {{תב|עץ משפחה/התחלה}} והסיומת {{תב|עץ משפחה/סוף}}.
** למתקדמים: החליפו את הערך של הפרמטרים: CHAINGE_BOX_COLOR,    CHAINGE_BOX_BOUNDARY    BOX_COLOR        BOUNDARY_COLOR,    RAUND_CORNERS,    REPLACE_DASHS,     NEW_COLOR  המופעים מיד לאחר השורה הקודמת שהחלפתם בערכים רצויים. ראו פרטים בהערות שמופיעות בסקריפט לצד הפרמטרים.
* הריצו את ההסקריפט באמצעות לחיצה על כפתור [[file:Run button google colab.png]] משמאל לסקריפט. 
* העתיקו את הפלט של הסקריפט (מופיע בתיבת טקסט מתחת לסקריפט - צריך לגלול למטה כדי לראות) לדף ויקי בו אתם מעוניינים לשמור את התרשים ותשמרו את הדף.
* המשיכו לערוך בהתאם לצורך.
'''הערות:'''
* הסקריפט מתעלם מהגדרות עיצוב שמוגדרות לכל השורה ביחד או לכל העץ ביחד. הוא מתייחס רק להגדרות עיצוב שבוצעו עבור כל תיבה בנפרד.
* על מנת להריץ את הסקריפט בצורה זו נחוץ חשבון [[גוגל (חברה)|גוגל]] (וצריך להיות מחובר לחשבון)
*

== בעיות ידועות ודרכי התמודדות איתן ==
* בעת עריכה חזותית, התאים בטבלה מופעים גדולים למדי, זה גורם לכך שהטבלה חורגת שמאלה מאד. כל עוד מדובר בחריגה של פחות מרוחב הדף זה כמעט לא מפריע לעבודה, אולם לאחר מכן הדבר פוגע בעבודה. להלן מספר דרכי התמודדות עם זה:
:* לבטול "מצב רוחב מוגבל" ב[[מיוחד:העדפות#mw-prefsection-rendering|תפריט ההעדפות]] ולהסתיר את סרגלי הצד.{{הערה|שם=וקטור2022}} 
:* להקטין את התצוגה (באמצעות contol + -)
:* להתחיל את העבודה קרוב לצידו הימני של הקנבס (לא לשמור יותר מידי עמודות ריקות מימין).
:* במקרה ויש צורך לעבוד הרחק באגף השמאלי של הקנבס והעבודה הופכת לא נוחה, ניתן להוסיף עוד שורת, לעבוד בהן באגף הימני, ולבסוף להעתיק למקום הרצוי בקנבס הראשי.
* במהלך העבודה על תרשים עולה הצורך למחוק את התוכן של משבצות. מחיקת משבצת משאירה אותה ריקה לחלוטין, גם בלי מרצפת ריקה. לעיתים הדבר גורם לכך שהגדלים בתרשים יהיו לא תקינים. באופן דומה, גם תוספת של שורה או עמודה יוצרת משבצות ריקות לחלוטין. אין דרך פשוטה לזהות האם משבצת היא ריקה לחלוטין או שיש בה מרצפת ריקה. אין גם הכרח שלא יהיו משבצות ריקות לחלוטין. למעשה מספיקה מרצפת אחת (ריקה או לא) בכל שורה ובכל עמודה כדי שהתרשים יהיה תקין.  יש מספר שיטות להוסיף מרצפת ריקה:
:*להעתיק מרצפת ריקה מ[[תבנית:תרשים/סרגל כלים|סרגל הכלים]]. כל המשבצות שנראות ריקות בסרגל הכלים מכילות מרצפת ריקה.
:*להעתיק מרצפת ריקה ממקום אחר בתרשים. זה לא תמיד פשוט, כי לא ברור באיזה משבצות יש מרצפת ריקה ואיזה הן ריקות לחלוטין. הקנבס המקורי מלא כולו מרצפות ריקות, אך ייתכן שחלקן נמחקו תוך כדי עבודה.
:*להעתיק למקום הרצוי מרצפת אחרת מהתרשים, להיכנס אליה (למשל על ידי הקשה כפולה פעמיים), ולבטל את כל הפרמטרים שלה (הפרמטרים של המרצפת מופעים בצד הימני של  החלון שנפתח בעת הכניסה למרצפת. חלקם "פעילים" - מסומנים ב-וי כחול, וחלקם לא. לחיצה על ה-וי הכחול מבטלת את הבחירה). 
* {{עוגן|בעיית משאבים|בחב"דפדיה ישנן [[חב"דפדיה:מגבלות המפענח|מגבלות על כמות המשאבים שדף מסוים צורך]]. השימוש בכלים כאן יקר יחסית במשאבים. לכן בתרשימים כבדים במיוחד לעיתים מגיעים למגבלה. ישנן מספר דרכים להתמודד עמ המגבלה:
:*להימנע משימוש בתבנית מרצפת ולהחליף אותה בשימוש ישיר בתבניות מהן המרצפות מורכבות {{תב|קטע}}, {{תב|פינה}}, {{תב|ממלא מקום}}.
:*להחליף את התבניות  {{תב|קטע}} ו{{תב|פינה}} בתבניות הישירות המתאימות להן:{{תב|קטע2}}...{{תב|קטע8}} ו{{תב|פינה1}}...{{תב|פינה9}}.
:*להשתמש בתבנית {{תב|תרשים/תיבה קלה}} במקום {{תב|תרשים/תיבה}}.
:*לרוקן תאים במקרה שאין בהם צורך בקבעית גודל מינימלי עבורן ולמחוק את השימוש ב{{תב|ממלא מקום}} כשהוא לא נדרש.
:יש לדרכים אלו חסרונות כך שלא מומלץ להשתמש בהם ללא סיבה. [[תבנית:עץ מיון של מרחבי פונקציות/עץ|כאן]] אפשר לראות דוגמה לתרשים כבד בו נעשה שימוש בטכניקות אלו.}}

==דוגמאות==
אפשר לראות דוגמאות לשימוש בכלי ב[[:קטגוריה:דפים שנוצרו באמצעות תבנית תרשים]].

{{עוגן|דוגמה מפורטת|להלן דוגמה פשוטה עם הוראות מפורטות ליצירתה שלב אחר שלב:}}
{{טבלה מוסתרת|כותרת=דוגמה פשוטה עם הסבר מפרט|תוכן =
{{ש}}
#פתח דף טיוטה עבור התרשים. בדוגמה זהו הדף [[תבנית:תרשים/דוגמה פשוטה]]
# הכנס לדף במצב עריכת קוד מקור.
# העתק את הטקסט הבא לדף: <nowiki>{{ס:תרשים/קנבס 16x32}} <noinclude>{{נוצר באמצעות תרשים}}</noinclude></nowiki>
#שמור את הדף
# בתחתית הדף מופעה מסגרת עם המילים 	"דף זה נוצר באמצעות {{תב|תרשים}}. הדרך הנוחה לערוך אותו היא על-ידי עריכה חזותית ובעזרת סרגל הכלים לעריכת תרשימים."
#פתח את סרגל הכלים במצב עריכה חזותית בחלון נפרד (עדיף במסך נפרד). ניתן לעשות זאת באמצעות הקישור "סרגל הכלים לעריכת תרשימים"  שהופיע בשלב 5.
#פתח את דף התרשים עצמו במצב עריכה חזותי. ניתן לעשות זאת  באמצעות הקישור "עריכה חזותית" שהופיע בשלב 5.
#בסרגל הכלים הקש על "תיבה 3"
#בצע פעולת העתק (אפשר להשתמש ב-control insert או control c או כל דרך אחרת שעובדת)
#בתרשים הקש על המקום בו אתה רוצה ליצור את התיבה הראשונה (תא (1,1) במקרה שלנו)
#בצע פעולת הדבק
#תופיעה התיבה 
#הקש הקשה כפולה על התיבה
#הקש הקשה כפולה נוספת על התיבה. לחלופין ניתן לבצע את הפעולות הבאת:
## הקש הקשה בודדת על התיבה
## תפתח מסגרת עם הודעה שבשמאלה כפתור עריכה
##הקש על כפתור העריכה
#תפתח מסגרת גדולה ובה מופיעה תיבת טקסט עם כותרת "טקסט"
#החלף את הטקסט בתיבה לטקסט הרצוי ("1") במקרה שלנו
#זה זמן טוב לבצע כל שינוי עיצוב בתיבה. ניתן לעשות זאת על ידי בחירת המאפינים הרוצויים במסגרת שנפתחה.
# לחץ על כפתור "החלת שינויים" (משמאל למעלה)
# הקש על מקום אקראי בטבלה ואז שוב על התיבה (מהלך זה מחליף את המצב בו היתיה שבו התיבה הייתה מסומנת למצב בו כל התא מסומן)
# בצע פעולת העתק
#תגיע למקום בו אתה רוצה למקם את התיבה השנייה (התא השמאלי ביותר המיעד לה), ניתן לעשות זאת הן על ידי העכבר והן על ידי המקלדת. בדוגמה שלנו זהו מקום (4,1)
#בצע פעולת הדבק.
#תופיע תיבה נוספת במקום החדש.
#צור באופן דומה את שאר התיבות הרצויות. אין צורך לבצע פעולת העתק מחדש. רק להגיע למקומות הרצוים ולבצעה פעולת הדבק. (בדוגמה שלנו אלה מקומות (4,6) ו- (7,6)).
#שנה את הטקסטים בתיבות לפי הצורך (לפי צעדים 13-18). אפשר גם לשנות את העיצוב.
#אתר בסרגל הכלים קו אנכי (תא (5,1)).
#הקש עליו
#בצע פעולת העתק.
#הדבק אותו לכל המקומות בהם הוא אמור להופיע בתרשים. בדוגמה שלנו מקומות (2,2), (3,2), (2,7),(3,7), (5,2), (6,2), (5,7),(6,7).
## הערה: אם אתה מעוניין לשנות את עיצוב הקו, עדיף לעשות זאת לאחר ההדבקה הראשונה. לאחר מכן להעתיק את הקו עם העיצוב החדש ולהדביק אותו בשאר המקומת הרצוים.
#חזור על שלבים 26-29 עם הקו המאוזן (נמצא במקום (4,1) בסרגל הכלים)
#חזור על שלבים 26-29 עם הפינות הרלוונטיות (נמצאות במקומות (3,8) ו- (1,10) בסרגל הכלים).
}}

==ראו גם==
{{כלי עריכה חזותית לתרשימים}}
*{{תב|עץ משפחה}}
*{{תב|תבנית:עץ משפחה לאדם אחד}}

{{הערות שוליים}}