D2 , một công cụ vẽ sơ đồ bằng mã nguồn phổ biến, đã phát hành phiên bản 0.7.1 với tính năng xuất văn bản ASCII . Tính năng mới này cho phép các nhà phát triển tạo ra các sơ đồ dạng văn bản có thể được nhúng trực tiếp vào các bình luận mã nguồn và tài liệu.
Kết xuất ASCII Đưa Sơ đồ Vào Tệp Văn bản
Bản cập nhật mới nhất giới thiệu một cách đơn giản để tạo sơ đồ ASCII bằng cách sử dụng phần mở rộng tệp .txt. Khi người dùng chạy d2 in.d2 out.txt, công cụ sẽ tự động chuyển sang chế độ kết xuất ASCII . Tính năng này hỗ trợ cả ký tự vẽ hộp Unicode theo mặc định và các ký tự ASCII tiêu chuẩn để đảm bảo khả năng tương thích tối đa trên các hệ thống khác nhau.
Bộ kết xuất ASCII hoạt động bằng cách thu nhỏ bố cục từ công cụ bố cục ELK và áp dụng xử lý hậu kỳ để làm cho đầu ra gọn gàng hơn. Cách tiếp cận này giúp có thể bao gồm các sơ đồ trực quan ở những nơi mà các định dạng hình ảnh truyền thống không thể hoạt động, chẳng hạn như bình luận mã nguồn hoặc tài liệu văn bản thuần túy.
Lệnh Xuất ASCII D2
- Cách sử dụng cơ bản:
d2 in.d2 out.txt - Chế độ ASCII tiêu chuẩn:
d2 in.d2 out.txt --ascii-mode=standard - Mặc định: Ký tự vẽ hộp Unicode
- Phần mở rộng tệp:
.txttự động kích hoạt trình kết xuất ASCII
Cộng đồng Phát hiện Vấn đề Playground
Những người dùng đầu tiên đã nhanh chóng xác định các vấn đề với tính năng mới. Người dùng báo cáo rằng đầu ra ASCII xuất hiện dưới dạng văn bản màu đen trên nền đen khi sử dụng chế độ tối trong playground D2 , khiến các sơ đồ hoàn toàn không thể nhìn thấy. Nhóm phát triển đã thừa nhận sự thiếu sót này và đang nỗ lực khắc phục.
Bất chấp vấn đề về chế độ tối, các nhà phát triển đang thể hiện sự quan tâm đến tiềm năng của tính năng này cho việc tài liệu hóa mã nguồn. Khả năng thay thế các mô tả văn bản dài dòng bằng các luồng trực quan rõ ràng trực tiếp trong bình luận mã nguồn có thể cải thiện đáng kể khả năng đọc mã.
Phiên bản Dựa trên Trình duyệt Hiện đã Có sẵn
Một phát triển thú vị nổi lên từ các cuộc thảo luận cộng đồng về khả năng web của D2 . Công cụ này hiện chạy hoàn toàn trong trình duyệt thông qua d2.js , một phiên bản WebAssembly loại bỏ nhu cầu về máy chủ backend. Thay đổi này giải quyết các hạn chế trước đây khi playground trực tuyến yêu cầu xử lý phía máy chủ để tạo sơ đồ.
Hạn chế của Trình kết xuất ASCII
- Kiểu dáng: Không hỗ trợ hoạt ảnh, phông chữ, chủ đề
- Khoảng cách: Khoảng cách không đều do tọa độ rời rạc
- Khả năng trong tương lai: Màu sắc cho đầu ra terminal, viền kép, nhiều kiểu dáng
- Trạng thái: Giai đoạn Alpha với báo cáo lỗi tích cực
Hạn chế Hiện tại và Kế hoạch Tương lai
Bộ kết xuất ASCII vẫn ở giai đoạn alpha với một số hạn chế đã biết. Các tính năng kiểu dáng như hoạt ảnh, phông chữ và chủ đề không được hỗ trợ, mặc dù một số tùy chọn kiểu dáng cơ bản như màu sắc cho đầu ra terminal có thể được thêm vào trong các bản phát hành tương lai. Không gian tọa độ rời rạc của kết xuất ASCII cũng có thể dẫn đến khoảng cách không đều so với đầu ra SVG .
Nhóm phát triển đang tích cực thu thập phản hồi và báo cáo lỗi khi họ nỗ lực cải thiện tính ổn định của tính năng và mở rộng khả năng của nó.
ASCII: American Standard Code for Information Interchange - một tiêu chuẩn mã hóa ký tự cho văn bảnWebAssembly (WASM): Một định dạng lệnh nhị phân cho phép mã chạy trong trình duyệt web với tốc độ gần như native
Tham khảo: ASCII output