เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ · HTML บรรณาธิการ WYSIWYG
Markdown กับ WYSIWYG: สองคำตอบสำหรับการเขียนสำหรับเว็บ
· พื้นหลัง
html มาร์กดาวน์ นักพัฒนาเวิร์กโฟลว์
เปรียบเทียบมาร์กอัปแบบน้ำหนักเบาและการแก้ไขภาพเป็นการตอบสนองต่อแรงเสียดทานของการเขียน HTML ด้วยมือ 2 ประการ โดยข้อเสียแต่ละอย่างจะส่งผลต่อคุณภาพของผลงานและการทำงานร่วมกัน
ไม่มีใครอยากเขียน HTML ด้วยมือ เปิดขึ้นพร้อมกับปัญหาที่ใช้ร่วมกันซึ่งทั้งสองแนวทางแก้ไข
มีผู้เขียนเพียงไม่กี่คนที่ต้องการพิมพ์แท็ก HTML ที่สมบูรณ์ให้กับทุกย่อหน้า ลิงก์ และเครื่องหมายเน้นข้อความ Markdown และ WYSIWYG ลดการเสียดสีจากทิศทางตรงกันข้าม โดยรายการหนึ่งเปิดเผยไวยากรณ์ของแหล่งที่มาแบบ light ขณะที่อีกรายการให้ผู้เขียนจัดการเอกสารภาพและตรวจสอบมาร์กอัปที่สร้างขึ้นในภายหลัง
ไม่มีวิธีการใดที่ช่วยลดขอบเขตของการแปลง Markdown ต้องการ parser ที่กำหนดค่าสำหรับภาษาถิ่น และโปรแกรมแก้ไขภาพต้องการกฎสำหรับเบราว์เซอร์ DOM และเอาต์พุตที่อนุญาต คุณภาพขึ้นอยู่กับตัวเลือกเหล่านั้นบวกกับการตรวจสอบ ไม่ใช่สโลแกนที่ว่าวิธีหนึ่งจะสร้างหน้าเว็บที่สะอาดตาหรือเข้าถึงได้มากขึ้นเสมอ
วิธีข้อความธรรมดาที่มีข้อจำกัดของ Markdown — วันที่ในอดีตอยู่นอกหลักฐานที่เก็บข้อมูล
Markdown เก็บข้อความธรรมดาที่มีเครื่องหมายวรรคตอนที่ parser เปลี่ยนเป็น HTML ไวยากรณ์ที่มีข้อจำกัดมักจะสร้างองค์ประกอบที่คาดเดาได้และทำงานได้ดีกับส่วนต่าง เวิร์กบุ๊กระบุวันที่และเรื่องราวต้นกำเนิด แต่ที่เก็บนี้ไม่มีแหล่งที่มาสำหรับประวัตินั้น ดังนั้นบทความนี้จึงหลีกเลี่ยงการทำซ้ำว่าเป็นข้อเท็จจริงที่ได้รับการตรวจสอบแล้ว
ความสามารถในการคาดการณ์ขึ้นอยู่กับภาษาถิ่นและส่วนขยาย ตาราง รายการงาน HTML แบบฝัง และกฎการแบ่งบรรทัดอาจแตกต่างกัน ไฟล์ `.md` เพียงอย่างเดียวไม่สามารถพิสูจน์ได้ว่า parser หรือตัวเลือกใดที่สร้างเพจ ทีมควรปักหมุดตัวแปลงและทดสอบเอกสารตัวแทน
เดิมพันของ WYSIWYG: แสดงผล ซ่อนมาร์กอัป — สรุปแนวทางการมองเห็นและผู้ที่ทำหน้าที่
WYSIWYG นำเสนอการเรนเดอร์ที่แก้ไขได้และให้เบราว์เซอร์จัดการการเลือก การพิมพ์ และคำสั่ง ToolAcre ใช้ contenteditable บวกกับ execCommand จากนั้นรัน innerHTML ผ่านโปรแกรมฆ่าเชื้อแบบแคบและเปิดเผยแหล่งที่มา ผู้เขียนสามารถสลับไปมาระหว่างมุมมองภาพและข้อความได้โดยไม่ต้องรักษาวงเล็บมุมในระหว่างการแก้ไขทุกครั้ง
ความสะดวกสบายนั้นยอมรับการกลายพันธุ์ที่ขึ้นอยู่กับเบราว์เซอร์ ตัวกรองลดความผันแปรโดยการแมปนามแฝง ลบการนำเสนอ และแท็กสมดุล แต่จะไม่สร้างโมเดลเอกสารแบบกำหนดเอง การตรวจสอบแหล่งที่มาจึงเป็นส่วนหนึ่งของขั้นตอนการทำงาน ไม่ใช่หน้าจอผู้เชี่ยวชาญเพิ่มเติม
เปรียบเทียบคุณภาพผลงาน - เปรียบเทียบ HTML ที่จำกัดและสะอาดของ Markdown กับเอาต์พุตที่แปรผันของโปรแกรมแก้ไขภาพ
โครงสร้างที่มีข้อจำกัดของ Markdown สามารถสร้างคำศัพท์ที่กระชับและสม่ำเสมอเมื่อปิดใช้งาน raw HTML เอาต์พุตของโปรแกรมแก้ไขภาพอาจแตกต่างกันมากขึ้นก่อนที่จะกรอง เนื่องจากคำสั่งของเบราว์เซอร์ทำงานบนแผนผังแบบสด ToolAcre ทำให้ผลลัพธ์นั้นแคบลง แต่โปรแกรมแก้ไขอื่นอาจเก็บช่วง คลาส หรือสไตล์อินไลน์ไว้
เปรียบเทียบเอาต์พุตที่กำหนดค่าตามจริง ไม่ใช่แบบเหมารวมของหมวดหมู่ ส่วนขยาย Markdown อาจปล่อย HTML ที่ซับซ้อนหรือไม่ปลอดภัยออกมา และโปรแกรมแก้ไขภาพที่เข้มงวดสามารถปล่อยส่วนย่อยเล็กๆ ได้ ระบบใดๆ ที่เผยแพร่การสนับสนุนที่ไม่น่าเชื่อถือจะต้องฆ่าเชื้อที่แสดงผล HTML โดยไม่คำนึงถึงไวยากรณ์การเขียน
การแสดงออกขึ้นอยู่กับภาษาถิ่น Markdown ที่เลือกและรายการที่อนุญาตของตัวแก้ไข
Markdown สะดวกสำหรับส่วนหัว ย่อหน้า รายการ ใบเสนอราคา รหัส และลิงก์ ตาราง โครงสร้างที่ซ้อนกัน หรือการนำเสนอที่ซับซ้อนมากขึ้นอาจต้องใช้ไวยากรณ์เฉพาะภาษาถิ่นหรือฝัง HTML ToolAcre รองรับองค์ประกอบข้อความเชิงความหมายจำนวนมาก แต่จงใจยกเว้นตาราง รูปภาพ สไตล์ คลาส และแบบฟอร์ม
คำถามที่เกี่ยวข้องคือวิธีการสร้างแสดงถึงเนื้อหาที่คุณต้องการภายใต้ข้อจำกัดปลายทางของคุณหรือไม่ ไม่มีเส้นทางใดที่มีความหมายในระดับสากลมากขึ้น แหล่งที่มาที่มองเห็นได้ของ ToolAcre ช่วยระบุการละเว้นได้ตั้งแต่เนิ่นๆ ในขณะที่การแสดงตัวอย่าง Markdown และการตรวจสอบ HTML ที่สร้างขึ้นก็ควรทำเช่นเดียวกัน
ตัวอย่างการทำงาน: เปรียบเทียบชุดย่อยที่รองรับขนาดเล็กแทนที่จะเป็นความเท่าเทียมกันของคุณลักษณะสากล
เขียนชื่อเรื่อง สองย่อหน้า วลีเน้น รายการสามรายการ และลิงก์สาธารณะในทั้งสองระบบ เปรียบเทียบ h, p, em หรือ strong, ul, li และองค์ประกอบ หลังจากที่แต่ละไปป์ไลน์ใช้นโยบายปกติ ละเว้นการเยื้องและลำดับแอตทริบิวต์ เว้นแต่สัญญาปลายทางจะทำให้มีความสำคัญ
จากนั้นทดสอบความต้องการที่ไม่ได้รับการสนับสนุน เช่น ตารางหรือรูปภาพ ToolAcre จะไม่เก็บมันไว้ ลักษณะการทำงานของมาร์กดาวน์ขึ้นอยู่กับการกำหนดค่าพาร์เซอร์ การบันทึกข้อกำหนดการปฏิเสธหรือการขยายเวลามีประโยชน์มากกว่าการบังคับใช้ความเท่าเทียมกันของคุณลักษณะ รักษาข้อความให้เหมือนกันเพื่อไม่ให้สับสนระหว่างความแตกต่างเชิงโครงสร้างกับการเปลี่ยนแปลงบทบรรณาธิการ
สิ่งนี้ไม่ครอบคลุม — รสชาติของ Markdown เฉพาะ ตัวสร้างไซต์แบบคงที่ หรือปลั๊กอินตัวแก้ไข
การเปรียบเทียบนี้ไม่ครอบคลุมถึงรสชาติของ Markdown, เครื่องมือสร้างไซต์แบบคงที่, ปลั๊กอิน, แพลตฟอร์มการทำงานร่วมกัน หรือกลยุทธ์การควบคุมเวอร์ชัน นอกจากนี้ยังไม่ได้วัดความเร็วหรืออ้างว่าเป็นตัวเลือกที่ต้องการสำหรับทุกทีม การตัดสินใจเหล่านั้นขึ้นอยู่กับผู้เขียน แนวปฏิบัติในการทบทวน และสถาปัตยกรรมการตีพิมพ์
น้ำยาฆ่าเชื้อของ ToolAcre ไม่ใช่บริการรักษาความปลอดภัยแบบสากล ชุดย่อยเอาต์พุตและแซนด์บ็อกซ์ช่วยปรับปรุงการตรวจสอบในพื้นที่ แต่เซิร์ฟเวอร์ที่ยอมรับอินพุตที่ไม่เป็นมิตรยังคงต้องการตัวฆ่าเชื้อที่ใช้ตัวแยกวิเคราะห์ที่เหมาะสม การเรนเดอร์ Markdown ยังสามารถสร้าง HTML ที่ต้องข้ามขอบเขตนั้นได้
ประเด็นสำคัญ: เลือกโดยผู้เขียน ไม่ใช่ตามอุดมการณ์ — สรุปข้อดีข้อเสียและวิธีที่บรรณาธิการ HTML WYSIWYG ของ ToolAcre เหมาะสมกับกรณีที่ผู้เขียนต้องการการแก้ไขภาพแต่ยังต้องการเห็น HTML
เลือกตามผู้เขียนและจุดหมายปลายทางมากกว่าอุดมการณ์ นักเขียนที่พอใจกับไวยากรณ์ธรรมดาที่อ่านได้และความแตกต่างของพื้นที่เก็บข้อมูลอาจชอบ Markdown มากกว่า ผู้เขียนที่ต้องการการจัดรูปแบบภาพโดยตรงอาจทำงานได้เร็วขึ้นบนพื้นผิว WYSIWYG ที่มีแหล่งที่มาใกล้เคียง ทั้งสองได้รับประโยชน์จากการตรวจสอบที่สร้างขึ้น HTML
ใช้ ToolAcre เมื่อชุดย่อยความหมายที่รองรับพอดีและมาร์กอัปที่มองเห็นได้นั้นมีค่า ใช้ไปป์ไลน์ Markdown ที่กำหนดค่าไว้เมื่อข้อความต้นฉบับและการแปลงตามที่กำหนดเหมาะสมกว่า แนวทางปฏิบัติที่คงทนคือการกำหนดเวอร์ชันของแหล่งที่มาที่ได้รับการตรวจสอบ ปักหมุดนโยบายการแปลง และทดสอบหน้าที่แสดงผลขั้นสุดท้าย