a little doubt from outdoor people

[earfanfan]

纯属是门外汉的一点疑惑，和文档有关，和功能无关。

我在看文档的时候发现https://yihui.org/litedown没有页码，由于文档很长我才看到前言(preface)，以https://yihui.org/litedown/#sec:highlights这一小节为例，下面的小小节内容长短不一但是都很短，通过单击目录并不能正正好逐一定位到内容，比如当我的鼠标单击目录中的“Chunk options management”时，变成绿色的是“Relieved pain of paths”，这个细节让我感到迷惑，我又多试几次发现这种情况还不是每次都会复现，有时候也能正常选中。只不过多试几次就变成了，当我的鼠标单击目录中的"Non-linear order of execution"时，变成绿色的是“Output in memory or to disk”。

传统的书籍（纸质书、WORD、PDF）是通过目录和页码对内容的位置进行双重定位，而以https://docs.ragas.io/en/stable/concepts/这种包的官方文档为例，则是通过目录和多次页面跳转来对内容的位置进行定位。可是litedown 的文档是一个静态页面，文档从头到尾没有页面只能使用目录对内容进行定位。这就又引出了下一个迷惑。

目录在左边，批注也放左边。

哈哈，居然还有固定起来的大图片。

以上两种情况，我本以为是可以点空白处或者哪里能把这两个东西关掉，后来才发现原来要滑动鼠标让它俩随着页面一起滑走才行，是关不掉的。万一换了哪个笨蛋来看，一定像我一样迷惑。

最后，难道是因为想要让读者快速定位内容，而又只能用目录定位，所以才要划分到四级目录吗？

[yihui]

1. 单击目录的定位是准确的，只不过你的眼睛被左边目录中的颜色吸引了注意力；如果你看右边正文的话，就知道单击目录确实定位到了相应的正文小节标题那里。在一屏显示多个小节标题的情况下（也就是单个小节的内容不足以撑满一屏），页面滚动时目录中高亮的是当前屏上最后一个滚进屏幕的标题（如果页面是向上而不是向下滚动，则高亮最上面一个标题）。单击目录会导致页面滚动，而滚动带来高亮，根据前述高亮规则，就能解释为什么高亮的目录会跳转（鼠标滚轮导致的滚动和点击页面上的锚点导致的滚动在技术上无法区分）。不过我同意这个高亮问题带有迷惑性，最好是想办法修补一下，实现点哪亮哪。

2. 左边的批注只是个示例，告诉读者理论上批注是可以放在左边的，至于要不要承担放左边碰撞目录的后果，这决策就留给用户自己了。超宽图片就是为了展示正常大小下看不清的的图片，为啥要“关掉”呢。当然，理论上也可以在页面滚动过程中去检测边栏内容是否遮挡目录，如果遮挡则临时坍缩目录（Quarto 是这么干的），只是我懒得搞这么复杂了。

四级目录纯属是因为在下脑力有限，暂时没想出怎样能三级就搞定所有内容。

[yihui]

高亮问题已经修正（尚未推送）。剩下的问题先不管了。

[earfanfan]

没想到你这么拼，早知道这样的小疑惑我就不报了。不过转头想想，搞开发的明知道存在一些小问题还忍着不动的话，好像确实也难忍。好吧，这个 issue 可以关掉，要是以后我在阅读你的文档时又有新的迷惑，本门外汉再报新的。

又，issue 翻译成中文应该叫撒？

又又，我在其他开源项目也提了一个 issue，见explodinggradients/ragas#1793 (comment)，维护者让我提 PR，我不是很懂为撒这种只改一个单词的代码也要提 PR，是一种惯例吗？

[yihui]

小疑惑可以报，欢迎报。

issue 我一般叫“事项”。如果是关于软件缺陷的，则可以称为“报告”。

让你提交 PR 大约是一种惯例，至于原因，有若干种可能：只是懒、为了攒人气、或为了吸引贡献者。

另：你的系统下这书的字体呈现出来简直是丑绝了。我设置的主字体是 Palatino 和 Georgia，都是各大系统下都很常见的字体，为啥你的系统上似乎没有呢。我最不能忍受的是那几个引号，竟然留出辣么大的空白！这是我的系统下的字体显示：

[earfanfan]

小疑惑可以报，欢迎报。

好吧，那我以后就不跟你客气了，本读者本来还想怜惜一下可怜的单人团队的开发者的额。

你的系统下这书的字体呈现出来简直是丑绝了。

我的摸鱼电脑是 UOS 系统，给的字体选项里没有你提到的。Georgia 原来也是一种字体，我只以为它是很让我喜欢的游戏，我回家以后一定要试试这个字体。唉，真是没有对比就没有伤害，现在我也觉得我的电脑字体很丑了。