Công cụ dành cho nhà phát triển · HTML WYSIWYG trình chỉnh sửa
Markdown so với WYSIWYG: Hai câu trả lời cho việc viết cho web
· Lý lịch
html giảm giá developer-workflow
So sánh đánh dấu nhẹ và chỉnh sửa trực quan như hai phản ứng đối với sự khó khăn khi viết HTML bằng tay, với sự đánh đổi mà mỗi yếu tố áp đặt lên chất lượng đầu ra và sự cộng tác.
Không ai muốn viết HTML bằng tay — mở đầu bằng vấn đề chung mà cả hai phương pháp đều giải quyết được
Rất ít tác giả muốn nhập các thẻ HTML hoàn chỉnh cho mỗi đoạn văn, liên kết và điểm đánh dấu nhấn mạnh. Markdown và WYSIWYG giảm ma sát đó từ các hướng ngược nhau: một hướng hiển thị cú pháp nguồn nhẹ, trong khi hướng còn lại cho phép tác giả thao tác với tài liệu trực quan và kiểm tra đánh dấu được tạo sau đó.
Cả hai cách tiếp cận đều không loại bỏ ranh giới chuyển đổi. Markdown cần một trình phân tích cú pháp được định cấu hình cho một phương ngữ và trình chỉnh sửa trực quan cần các quy tắc cho trình duyệt DOM và đầu ra được phép. Chất lượng phụ thuộc vào những lựa chọn đó cộng với sự đánh giá chứ không phụ thuộc vào khẩu hiệu rằng một phương pháp luôn tạo ra các trang sạch hơn hoặc dễ truy cập hơn.
Cách tiếp cận văn bản thuần túy bị ràng buộc của Markdown - ngày lịch sử là bằng chứng bên ngoài kho lưu trữ
Markdown lưu trữ văn bản thuần túy với các quy ước chấm câu mà trình phân tích cú pháp biến thành HTML. Một ngữ pháp bị ràng buộc thường tạo ra các yếu tố có thể dự đoán được và hoạt động tốt với các khác biệt. Sổ làm việc cung cấp câu chuyện về ngày tháng và nguồn gốc, nhưng kho lưu trữ này không chứa nguồn nào về lịch sử đó, vì vậy bài viết này tránh lặp lại nó như một sự thật đã được xác minh.
Khả năng dự đoán có điều kiện đối với phương ngữ và phần mở rộng. Các bảng, danh sách nhiệm vụ, HTML được nhúng và quy tắc ngắt dòng có thể khác nhau. Chỉ riêng tệp `.md` không chứng minh được trình phân tích cú pháp hoặc tùy chọn nào đã tạo ra một trang. Các đội nên ghim trình chuyển đổi của mình và kiểm tra các tài liệu đại diện.
Đặt cược của WYSIWYG: hiển thị kết quả, ẩn đánh dấu — tóm tắt lại cách tiếp cận trực quan và nó phục vụ ai
WYSIWYG trình bày kết xuất có thể chỉnh sửa và cho phép trình duyệt quản lý việc lựa chọn, nhập và lệnh. ToolAcre sử dụng nội dung có thể chỉnh sửa cộng với execCommand, sau đó chạy InternalHTML thông qua trình khử trùng hẹp và hiển thị nguồn. Tác giả có thể di chuyển giữa chế độ xem trực quan và văn bản mà không cần duy trì dấu ngoặc nhọn trong mỗi lần chỉnh sửa.
Sự tiện lợi đó thừa nhận những đột biến phụ thuộc vào trình duyệt. Bộ lọc giảm sự biến đổi bằng cách ánh xạ các bí danh, loại bỏ các thẻ trình bày và cân bằng, nhưng nó không tạo ra mô hình tài liệu tùy chỉnh. Do đó, việc kiểm tra nguồn là một phần của quy trình làm việc chứ không phải là màn hình chuyên gia tùy chọn.
Chất lượng đầu ra được so sánh — đối chiếu HTML bị ràng buộc, rõ ràng của Markdown với đầu ra có thể thay đổi của trình chỉnh sửa trực quan
Các cấu trúc bị ràng buộc của Markdown có thể tạo ra vốn từ vựng nhỏ gọn, nhất quán khi HTML thô bị tắt. Đầu ra của trình soạn thảo trực quan có thể thay đổi nhiều hơn trước khi lọc vì các lệnh của trình duyệt hoạt động trên cây trực tiếp. ToolAcre thu hẹp kết quả đó nhưng một trình soạn thảo khác có thể giữ lại các nhịp, lớp hoặc kiểu nội tuyến.
So sánh kết quả đầu ra được cấu hình thực tế, không phải khuôn mẫu danh mục. Tiện ích mở rộng Markdown có thể phát ra HTML phức tạp hoặc không an toàn và trình chỉnh sửa trực quan nghiêm ngặt có thể phát ra một tập hợp con nhỏ. Bất kỳ hệ thống nào xuất bản những đóng góp không đáng tin cậy đều phải vệ sinh HTML được hiển thị bất kể cú pháp tác giả.
Khả năng biểu đạt phụ thuộc vào phương ngữ Markdown đã chọn và danh sách cho phép biên tập viên
Markdown thuận tiện cho các tiêu đề, đoạn văn, danh sách, trích dẫn, mã và liên kết. Các bảng, cấu trúc lồng nhau hoặc cách trình bày phức tạp hơn có thể yêu cầu cú pháp dành riêng cho từng phương ngữ hoặc HTML được nhúng. ToolAcre hỗ trợ nhiều thành phần văn bản ngữ nghĩa nhưng cố tình loại trừ bảng, hình ảnh, kiểu, lớp và biểu mẫu.
Câu hỏi liên quan là liệu phương pháp soạn thảo có đại diện cho nội dung bạn cần theo các ràng buộc về đích đến hay không. Không có con đường nào có tính biểu cảm phổ biến hơn. Nguồn hiển thị của ToolAcre giúp xác định sớm các thiếu sót của nó, trong khi bản xem trước Markdown và kiểm tra HTML được tạo cũng sẽ thực hiện tương tự.
Ví dụ hoạt động: so sánh một tập hợp con nhỏ được hỗ trợ thay vì tính tương đương của tính năng phổ quát
Viết tiêu đề, hai đoạn văn, cụm từ được nhấn mạnh, danh sách ba mục và liên kết công khai trong cả hai hệ thống. So sánh các phần tử h, p, em hoặc strong, ul, li và a sau khi mỗi đường dẫn đã áp dụng chính sách thông thường của nó. Bỏ qua thụt lề và thứ tự thuộc tính trừ khi hợp đồng đích làm cho chúng trở nên quan trọng.
Sau đó kiểm tra một nhu cầu không được hỗ trợ, chẳng hạn như bảng hoặc hình ảnh. ToolAcre sẽ không giữ lại nó; Hành vi đánh dấu phụ thuộc vào cấu hình trình phân tích cú pháp. Việc ghi lại yêu cầu từ chối hoặc mở rộng sẽ hữu ích hơn việc buộc tính năng tương đương. Giữ văn bản giống hệt nhau để những khác biệt về cấu trúc không bị nhầm lẫn với những thay đổi về biên tập.
Điều này không bao gồm - hương vị Markdown cụ thể, trình tạo trang tĩnh hoặc plugin trình chỉnh sửa
So sánh này không bao gồm các phiên bản Markdown cụ thể, trình tạo trang tĩnh, plugin, nền tảng cộng tác hoặc chiến lược kiểm soát phiên bản. Nó cũng không đánh giá tốc độ hoặc đưa ra lựa chọn ưu tiên cho mọi đội. Những quyết định đó phụ thuộc vào tác giả, thực tiễn đánh giá và kiến trúc xuất bản.
Chất khử trùng của ToolAcre không phải là dịch vụ bảo mật phổ quát. Tập hợp con đầu ra và hộp cát của nó cải thiện khả năng kiểm tra cục bộ, nhưng máy chủ chấp nhận đầu vào thù địch vẫn cần một trình khử trùng dựa trên trình phân tích cú pháp thích hợp. Kết xuất Markdown cũng có thể tạo ra HTML phải vượt qua ranh giới đó.
Bài học rút ra: chọn theo tác giả, không phải theo hệ tư tưởng — tóm tắt những sự đánh đổi và cách trình soạn thảo HTML WYSIWYG của ToolAcre phù hợp với trường hợp tác giả cần chỉnh sửa trực quan nhưng vẫn muốn xem HTML
Chọn theo tác giả và điểm đến hơn là hệ tư tưởng. Người viết cảm thấy thoải mái với cú pháp đơn giản dễ đọc và các khác biệt trong kho lưu trữ có thể thích Markdown hơn; những người viết cần định dạng hình ảnh trực tiếp có thể làm việc nhanh hơn trên bề mặt WYSIWYG với nguồn ở gần. Cả hai đều được hưởng lợi từ việc kiểm tra HTML được tạo.
Sử dụng ToolAcre khi tập hợp con ngữ nghĩa được hỗ trợ phù hợp và đánh dấu hiển thị có giá trị. Sử dụng quy trình Markdown được định cấu hình khi văn bản nguồn và chuyển đổi xác định phù hợp hơn. Cách thực hành lâu dài là tạo phiên bản của nguồn đã đánh giá, ghim chính sách chuyển đổi và kiểm tra trang được hiển thị cuối cùng.