Loading feed…
scottstuff.net0 Hot0 comments4 min read
Sidenotes in Goldmark
AI summary
Bài viết kể về trải nghiệm của tác giả khi cố gắng thêm sidenotes vào trang web Hugo sử dụng Goldmark, bộ render Markdown mặc định của Hugo. Vì Goldmark không hỗ trợ sidenotes, ông đã chuyển sang dùng Pandoc – công cụ chuyển đổi tài liệu viết bằng Haskell – kèm theo một trong hai‑ba plugin sidenote của Pandoc, nhưng điều này làm tăng thời gian build từ vài giây lên khoảng một phút và làm chậm chế độ server tới khoảng 30 s mỗi lần lưu thay đổi, đôi khi gây treo. Hệ quả là quá trình viết trở nên khó chịu vì mỗi sửa đổi nhỏ đều phải chờ đợi lâu và có nguy cơ Pandoc treo khi đang render. Cuối cùng tác giả quyết định viết lại hỗ trợ sidenotes trực tiếp trong Goldmark, nhận ra rằng mặc dù khó khăn nhưng không quá terribleso. Bài học rút ra là khi cần tính năng mà công cụ render hiện tại không cung cấp, việc mở rộng parser thường hiệu quả hơn việc thay đổi toàn bộ chuỗi công cụ sang một giải pháp nặng như Pandoc.
Why read it: Bài này cung cấp giải pháp hiệu quả để thêm tính năng ghi chú cạnh (sidenotes) vào Goldmark - bộ trình băm Markdown mặc định của Hugo mà không làm giảm tốc độ xây dựng trang.
What do you remember?
Answer 3 short questions to earn reward points for this article. Only do it if you want the points.
up to +17 points
3 questions · under a minute · optional
Source: https://scottstuff.net/posts/2026/08/23/sidenotes-in-goldmark. 8 Sync News only summarizes and links out; content copyright belongs to the authors and original sources.
Recommended for you
Bình luận
Đang tải bình luận…
