טיפ חשוב לכתיבה ביישור לימין, בשילוב קוד "מארק-דאון"

aviz85 (44)in #hebrewguides • 7 years ago (edited)

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

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

![image name](image url)

2000px-Decorative_text_divider.svg[1].png

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

<h1>This is a header</h1>

ב"מארק-דאון" זה ייראה כך

# This is a header

או כך

This is a header
================

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

למשל בפרוייקטים של קוד פתוח, מקובל לכתוב את הREADME בקוד "מארק-דאון" ולכן הסיומת של הקובץ היא md.
השם של "מארק-דאון" מגיע כנראה מהניגוד ל-HTML שהיא ראשי תיבות של HyperText Markup Language

2000px-Decorative_text_divider.svg[1].png

המקרה שגורם לבעיה הוא בעצם כל שימוש בתג <div> כמו למשל במקרה שלנו <div class="text-rtl">.
אם אנו משתמשים בתג כזה, ומבקשים להוסיף תמונה, אנו מקבלים משהו כזה:
![שם התמונה](-------)
כאשר במקום הקו מופיעה התמונה עצמה. היינו רוצים להיפטר מהסימנים המיותרים שסביב, אך למעשה הם שייכים לכתיבה תקנית בקוד "מארק-דאון". במקרה של סטימאיט, גם אם נמחק את הסימנים ונשאיר רק את כתובת התמונה, היא תתפרש כתמונה בחלון ה PREVIEW וגם בתצוגת הפוסט, אבל אם נרצה לצפות בפוסט בפלטפורמה אחרת שלא תומכת באפשרויות העיצוב של סטימאיט זה עלול ליצור בעיה.
לכן מומלץ להיצמד לתקן של "מארק-דאון". אלא שבמקרה שציינתי, בשימוש בתג div התקן הזה פשוט לא עובד וסתם מלכלך לנו את הקוד.

אז מה עושים?

מסתבר שיש דרך די פשוטה לפתור את הבאג הזה (עד שהוא יתוקן בקוד המקור של סטימאיט.

פשוט הקפידו בכל שימוש בתג `<div>` להשאיר שורה רווח לאחריו (גם בתג הפותח וגם בתג הסוגר) כך:

<div class="text-rtl">

אחרי שורה רווח כתבו כמה עברית שבא לכם
והשתמשו להנאתכם ב"מארק-דאון"
# כותרת
![my picture](http://www.mysite.com/picture.jpeg)
</div>

שימו לב גם לאחר התג הסוגר להשאיר שורה רווח

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

צ'או!

#rtl #hebrew #markdown