Inconsistent href
还没有人认领这个 Issue。
评估
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 新手友好度
- 48/100
- Issue 类型
- 缺陷
- 描述清晰度
- 基本清楚
- 活跃度
- 停滞
调研方向
使用 test/scribblings/test.scrbl 及其包信息 info.rkt 重现该问题，并遵循报告中描述的三个 scribble 命令。比较生成的 tocviewlink href 值；当生成的 HTML 不包含特定于机器的绝对文件路径，并且在文档所述的调用模式之间保持可移植时，即表示完成。
由索引模型根据 Issue 内容生成。
描述
tl;dr: generated href could be inconsistent depending on several factors. Here are some of the possible values:
<a href="file:///Users/sorawee/playground/test/scribblings/test.html#%28part._foo%29" class="tocviewlink" data-pltdoc="x">foo</a><a href="test.html#%28part._foo%29" class="tocviewlink" data-pltdoc="x">foo</a><a href="#%28part._foo%29" class="tocviewlink" data-pltdoc="x">foo</a>
The second and third variation seem OK, but the first variation contains an absolute path, which is not portable to other systems.
First variation
Consider test/scribblings/test.scrbl
#lang scribble/base
@section{foo}
foo content
Make sure to install test as a package with the following info.rkt:
#lang info
(define collection "test")
(define scribblings '(("scribblings/test.scrbl" ())))
Then, in the directory test/scribblings, run scribble +m test.scrbl.
The generated HTML contains:
<a href="file:///Users/sorawee/playground/test/scribblings/test.html#%28part._foo%29" class="tocviewlink" data-pltdoc="x">foo</a>
Second variation
Now, run scribble +m --dest . test.scrbl.
The generated HTML contains:
<a href="test.html#%28part._foo%29" class="tocviewlink" data-pltdoc="x">foo</a>
Third variation
Now, run raco pkg remove test and re-run scribble +m test.scrbl.
The generated HTML contains:
<a href="#%28part._foo%29" class="tocviewlink" data-pltdoc="x">foo</a>
- 主要语言
- Racket
- 星标
- 251
- 派生
- 101
- 平均合并
- 11 天 9 小时
- 30 天内合并 PR
- 2
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
racket/scribble 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 65/100
-
难度 3/5 1-2 天 新手友好度 74/100
-
难度 4/5 3-5 天 新手友好度 35/100
-
难度 3/5 1-2 天 新手友好度 55/100
-
难度 4/5 3-5 天 新手友好度 35/100
相似的 Issue
-
documentation glm5 llm-model
难度 2/5 1-3 小时 新手友好度 78/100
vllm-project/vllm-ascend#19062 ·
维护者通常 1 天内回复
-
难度 1/5 1-3 小时 新手友好度 78/100
tursodatabase/turso#10052 ·
维护者通常 1 天内回复
-
Mac mini M6 (16 GB): Q2_0 streaming works - measured 11.7->27.2 tok/s + arena fix for sub-32 GB Macs未关闭
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
-
enhancement needs triage
难度 2/5 1-3 小时 新手友好度 70/100
elastic/docs-builder#4495 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 74/100
cellrishi-code/claude-skills-atlas#165 ·
维护者通常 1 天内回复