alshedivat/al-folio

Distill TOC not working with apostrophe

Open

#3,236 建立於 2025年7月12日

在 GitHub 查看
 (4 留言) (0 反應) (0 負責人)HTML (15,603 star) (12,991 fork)batch import
bughelp wanted

描述

Have you checked that your issue isn't already filed?

  • I read through FAQ and searched through the past issues, none of which addressed my issue.
  • Yes, I have checked that this issue isn't already filed.

Bug description

This appears to be the same issue as https://github.com/alshedivat/al-folio/issues/489, which said it was fixed but I'm still having the issue. If my section or subsection title contains an apostrophe ('), the Distill TOC does not work.

How to reproduce the bug

Same as previous issue.

Error messages and logs

The error message you got, with the full traceback if available. Please paste it between these triple backticks.

What operating system are you using?

Mac

Where are you seeing the problem on?

Deployed site

More info

Example website:

https://goombalab.github.io/blog/2025/hnet-past/#u-nets-don-39-t-work-for-language

(from the blog: https://goombalab.github.io/blog/2025/hnet-past/)

貢獻者指南

技術棧
htmljavascript
領域
frontend
議題類型
bug
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
2
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
1-3 hours
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
fresh
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
mostly clear
前置要求
basic HTMLJavaScript DOM manipulation
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
75
研究方向
The issue is about apostrophes breaking the Distill TOC. Look at the previous issue #489 to see the original fix. The TOC is generated by JavaScript in the Distill layout. The problem is likely in how the script creates anchor links from section titles, possibly missing or incorrectly escaping apostrophes. Search for 'distill toc.js' or similar files in the repository. The fix might involve properly escaping special characters when generating IDs. Check the relevant JavaScript code and ensure it matches the approach from #489.