ควรจัดการกับโค้ดบล็อกและ Front Matter อย่างไรในการแปลเอกสารเทคนิค (Markdown)?
“หากโค้ดบล็อก โค้ดอินไลน์ และส่วนกำหนดค่าหัวเรื่อง (Front Matter) ในเอกสารทางเทคนิคถูกแปลโดยตรง จะทำให้เอกสารไม่สามารถใช้งานได้”
การวิเคราะห์สาเหตุที่แท้จริง
กลไก 'พื้นที่แยก' ของโค้ดบล็อก
ระบบจะตรวจจับเนื้อหาที่ครอบด้วย ``` (โค้ดบล็อก) และ ` (โค้ดอินไลน์) โดยอัตโนมัติบริเวณเหล่านี้จะถูกกำหนดให้เป็น 'เขตห้ามแปล' โดย AI จะข้ามเนื้อหาส่วนนี้เพื่อรักษาโครงสร้างของโค้ด Python, JS ฯลฯ ไม่ให้เสียหาย
การปกป้องเมตาดาทา Front Matter
สำหรับการกำหนดค่า YAML ส่วนหัวที่พบได้บ่อยในระบบบล็อกแบบ Static เช่น Jekyll หรือ Hugo (เช่น `date:`, `slug:`) จะทำการแปลเฉพาะฟิลด์ที่กำหนดเช่น `title` และ `description` เท่านั้น โดยคงค่าพารามิเตอร์ที่จำเป็นต่อการ build ไว้ตามเดิม
การจัดเรียงตาราง Markdown ใหม่แบบปรับอัตโนมัติ
ตาราง Markdown มักจะเกิดความไม่ตรงแนวหลังการแปล เนื่องจากความยาวข้อคเปลี่ยนแปลงDL.Translator จะคำนวณตำแหน่งตัวแบ่งคอลัมน์ `|` ใหม่อีกครั้งในกระบวนการหลังการประมวลผล เพื่อให้ได้ซอร์สโค้ดตารางที่สวยงามและตรงแนว
สรุปแนวทางแก้ไขขั้นสุดท้าย
ออกแบบมาโดยเฉพาะสำหรับชุมชนโอเพนซอร์สและนักพัฒนา เพื่อให้แน่ใจว่า README.md และคู่มือเชิงเทคนิคยังคงความเป็นมืออาชีพและอ่านง่ายระหว่างการแปลหลายภาษา