Alat pembangun · HTML WYSIWYG editor
Markdown vs WYSIWYG: Dua Jawapan untuk Menulis untuk Web
· Latar belakang
html penurunan harga aliran kerja pembangun
Membandingkan penanda ringan dan pengeditan visual sebagai dua tindak balas kepada geseran penulisan HTML dengan tangan, dengan pertukaran masing-masing mengenakan kualiti output dan kerjasama.
Tiada siapa yang mahu menulis HTML dengan tangan — dibuka dengan masalah yang dikongsi kedua-dua pendekatan selesaikan
Beberapa pengarang ingin menaip teg HTML yang lengkap untuk setiap perenggan, pautan dan penanda penekanan. Penurunan harga dan WYSIWYG mengurangkan geseran itu dari arah bertentangan: satu mendedahkan sintaks sumber ringan, manakala satu lagi membenarkan pengarang memanipulasi dokumen visual dan memeriksa penanda yang dijana selepas itu.
Kedua-dua pendekatan tidak menghapuskan sempadan penukaran. Penurunan harga memerlukan penghurai yang dikonfigurasikan untuk dialek dan editor visual memerlukan peraturan untuk pelayar DOM dan output yang dibenarkan. Kualiti bergantung pada pilihan tersebut serta ulasan, bukan pada slogan bahawa satu kaedah sentiasa mencipta halaman yang lebih bersih atau lebih mudah diakses.
Pendekatan teks biasa terhad Markdown — tarikh sejarah adalah di luar bukti repositori
Markdown menyimpan teks biasa dengan konvensyen tanda baca yang penghurai bertukar menjadi HTML. Tatabahasa yang terhad sering menghasilkan unsur yang boleh diramal dan berfungsi dengan baik dengan perbezaan. Buku kerja membekalkan cerita tarikh dan asal, tetapi repositori ini tidak mengandungi sumber untuk sejarah itu, jadi artikel ini mengelak daripada mengulanginya sebagai fakta yang disahkan.
Kebolehramalan adalah bersyarat pada dialek dan sambungan. Jadual, senarai tugas, HTML dan peraturan pemisah baris boleh berbeza. Fail `.md` sahaja tidak membuktikan penghurai atau pilihan yang menjana halaman. Pasukan harus menyematkan penukar dan dokumen wakil ujian mereka.
Pertaruhan WYSIWYG: tunjukkan keputusan, sembunyikan penanda — imbas semula pendekatan visual dan kepada siapa ia berkhidmat
WYSIWYG mempersembahkan pemaparan boleh diedit dan membenarkan pelayar mengurus pemilihan, menaip dan arahan. ToolAcre menggunakan contenteditable plus execCommand, kemudian menjalankan innerHTML melalui sanitizer sempit dan mendedahkan sumber. Pengarang boleh beralih antara paparan visual dan teks tanpa mengekalkan kurungan sudut semasa setiap suntingan.
Kemudahan itu mengakui mutasi yang bergantung kepada pelayar. Penapis mengurangkan variasi dengan memetakan alias, mengalih keluar pembentangan dan mengimbangi teg, tetapi ia tidak mencipta model dokumen tersuai. Oleh itu, pemeriksaan sumber adalah sebahagian daripada aliran kerja dan bukannya skrin pakar pilihan.
Kualiti output dibandingkan — membezakan Markdown yang terhad, bersih HTML dengan output pembolehubah editor visual
Konstruk terhad Markdown boleh menghasilkan perbendaharaan kata yang padat dan konsisten apabila HTML mentah dilumpuhkan. Output editor visual boleh berbeza-beza sebelum menapis kerana arahan pelayar beroperasi pada pokok langsung. ToolAcre menyempitkan hasil itu, tetapi editor yang berbeza mungkin mengekalkan rentang, kelas atau gaya sebaris.
Bandingkan output terkonfigurasi sebenar, bukan stereotaip kategori. Sambungan Markdown boleh mengeluarkan HTML yang kompleks atau tidak selamat dan editor visual yang ketat boleh mengeluarkan subset kecil. Mana-mana sistem yang menerbitkan sumbangan yang tidak dipercayai mesti membersihkan yang diberikan HTML tanpa mengira sintaks pengarangan.
Ekspresi bergantung pada dialek Markdown yang dipilih dan senarai dibenarkan editor
Penurunan harga adalah selesa untuk tajuk, perenggan, senarai, petikan, kod dan pautan. Jadual yang lebih terperinci, struktur bersarang atau pembentangan boleh memerlukan sintaks khusus dialek atau HTML yang dibenamkan. ToolAcre menyokong banyak elemen teks semantik tetapi dengan sengaja mengecualikan jadual, imej, gaya, kelas dan borang.
Soalan yang berkaitan ialah sama ada kaedah pengarangan mewakili kandungan yang anda perlukan di bawah kekangan destinasi anda. Kedua-dua laluan tidak lebih ekspresif secara universal. Sumber kelihatan ToolAcre membantu mengenal pasti peninggalannya lebih awal, manakala pratonton Markdown dan pemeriksaan HTML yang dihasilkan harus melakukan perkara yang sama.
Contoh yang berfungsi: bandingkan subset kecil yang disokong dan bukannya pariti ciri universal
Tulis tajuk, dua perenggan, frasa yang ditekankan, senarai tiga item dan pautan awam dalam kedua-dua sistem. Bandingkan h, p, em atau kuat, ul, li dan elemen selepas setiap saluran paip menggunakan dasar biasanya. Abaikan susunan lekukan dan atribut melainkan kontrak destinasi menjadikannya penting.
Kemudian uji satu keperluan yang tidak disokong, seperti jadual atau imej. ToolAcre tidak akan mengekalkannya; Tingkah laku penurunan harga bergantung pada konfigurasi parser. Merakam penolakan atau keperluan lanjutan adalah lebih berguna daripada memaksa pariti ciri. Pastikan teks sama supaya perbezaan struktur tidak dikelirukan dengan perubahan editorial.
Perkara ini tidak meliputi — perisa Markdown khusus, penjana tapak statik atau pemalam editor
Perbandingan ini tidak meliputi perisa Markdown tertentu, penjana tapak statik, pemalam, platform kerjasama atau strategi kawalan versi. Ia juga tidak menanda aras kelajuan atau menuntut pilihan pilihan untuk setiap pasukan. Keputusan tersebut bergantung pada pengarang, amalan semakan dan seni bina penerbitan.
Pembersih ToolAcre bukanlah perkhidmatan keselamatan sejagat. Subset output dan kotak pasir menambah baik pemeriksaan tempatan, tetapi pelayan yang menerima input bermusuhan masih memerlukan pembersih berasaskan parser yang sesuai. Paparan penurunan harga juga boleh menghasilkan HTML yang mesti melepasi sempadan itu.
Bawa pulang: pilih mengikut pengarang, bukan mengikut ideologi — meringkaskan pertukaran dan cara editor ToolAcre HTML WYSIWYG sesuai dengan kes di mana pengarang memerlukan pengeditan visual tetapi masih mahu melihat HTML
Pilih mengikut pengarang dan destinasi dan bukannya ideologi. Penulis selesa dengan sintaks biasa yang boleh dibaca dan perbezaan repositori mungkin lebih suka Markdown; penulis yang memerlukan pemformatan visual langsung boleh berfungsi dengan lebih pantas dalam permukaan WYSIWYG dengan sumber berdekatan. Kedua-duanya mendapat manfaat daripada memeriksa HTML yang dihasilkan.
Gunakan ToolAcre apabila subset semantik yang disokong padan dan penanda yang boleh dilihat adalah berharga. Gunakan saluran paip Markdown yang dikonfigurasikan apabila teks sumber dan penukaran deterministik lebih sesuai. Amalan yang tahan lama adalah untuk membuat versi sumber yang disemak, menyemat dasar penukaran dan menguji halaman akhir yang dipaparkan.