איך יש להתמודד עם קטעי קוד ו־Front Matter בעת תרגום מסמכים טכניים (Markdown)?

התהליך הנוכחי מחלץ תוכן לתרגום לפי מבנה Markdown. קוד בתוך הטקסט עשוי להיחלץ יחד עם הטקסט שסביבו, וגם הערות בקטעי קוד עשויות להיכלל בתרגום. לאחר התרגום, בדקו סימונים כגון ``` ו־` ואת התחביר והלוגיקה של דוגמאות Python ו־JS. אל תניחו שכל אזורי הקוד יידלגו.

בתצורת YAML בתחילת המסמך (Front Matter), הנפוצה בבלוגים סטטיים כגון Jekyll/Hugo, תהליך החילוץ הנוכחי אינו מטפל בערכי שדות כמו `title` ו־`description` כטקסטים נפרדים לתרגום. בדקו ידנית את המטא־נתונים לאחר התרגום ושמרו פרמטרים הדרושים לבנייה, כגון `date:` ו־`slug:`.

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