静态站美化与章节拆分 about jshistory-cn HOT 7 CLOSED

哈哈，祝贺 JavaScript 20 年 中文版 新的静态页面发布 🥳 （成功混了个 committer…

from jshistory-cn.

@doodlewind 已记录到 Pagic 1.0 的 TODOs 中

1. 会修复
2. 会向 github 靠齐
3. 会提供一个选项
4. 会提供一个选项

from jshistory-cn.

你好，我个人对在线版的预期是对齐 You Don't Know JS 的（以 GitHub 上持续维护的页面为主，最低限度的「额外美化」），因此之前希望提供的其实就是现在的阅读体验，接下来精力主要是纸质版和修订上。

进一步拆分章节并引入静态站点生成器的话，有一个潜在的风险，即虽然它本身侵入性不强，但拆分后大量的参考文献、脚注、术语表等链接地址又需要手工的转换和确认（苦力活，并且从其他站点来的外链也可能失效），所以没有特别理由的话我倾向于先不折腾它……当然这个 issue 就先开着吧，如果大家有其他反馈和建议也欢迎哈。

from jshistory-cn.

👍 最低限度地美化这主意确实不错，看你们和编辑社的考量了。

不过人工检查、手工转换以及章节拆分的话，我可以提 PR，可以的话我就开搞 🤡

对于我来说，特别理由就是：用更好的静态网站更直观，更容易通过目录的编排复习甚至多看几遍，哈哈 😄

对了，还支持评论区，可以留言～首页同时宣传实体版纸质书，会卖的更好！

所以...看起来我可以提交个 PR 试试 😁

from jshistory-cn.

实际上 LaTeX 版是单个文件写完的，再鉴于部分章节实际上非常短，所以我不确定拆得更细是否会更好 :(

至于评论区等功能的话，GitHub 的 Issue 就够了呀。最好的一点是你可以在这里 at 到 allenwb，直接和他交流你对内容本身的疑问 👻

from jshistory-cn.

.cn上的,章节目录应该和内容分开,最好是可以在任意,做成导航一样的方式

from jshistory-cn.

静态站已经更新，谢谢 @hylerrix 与 @xcatliu 的支持！

向 @xcatliu 反馈 Pagic 中一些已知的链接跳转问题：

1. 形如 <a href="./notes.md"> 的格式无法被正确解析，如第一章的「循环垃圾回收^g」术语表链接
2. 文字符号转义规则与 GitHub 不一致，如对于 part-1.md 中的 插曲：风评被害 章节名，GitHub 会将其转为 part-1.html#插曲风评被害，而 Pagic 会转为 #插曲：风评被害，类似的还有章节 JavaScript 1.0 与 1.1，GitHub 转为 #javascript-10-与-11，而 Pagic 则转为 #javascript-1.0-与-1.1。GitHub 这里应该多过滤了一层全半角字符。
3. H1 标签无法被 anchor 到。
4. H4 标签未计入页面右侧的 Table of Content。

问题 1-3 会导致 GitHub 项目中的目录（jshistory-cn）链接与 Pagic 静态站的链接只有一个可用（要么编写适应 GitHub 风格的链接，要么编写适应 Pagic 风格的链接），是否有考虑对齐一下呢？

from jshistory-cn.