`margin-note` exceeds page limit in PDF e.g. Racket guide
还没有人认领这个 Issue。
评估
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 新手友好度
- 45/100
- Issue 类型
- 缺陷
- 描述清晰度
- 基本清楚
- 活跃度
- 停滞
调研方向
从 pkgs/racket-doc/scribblings/guide/control.scrbl 的第 124 行开始，使用 scribble/manual 将页面渲染为 PDF 并重现该页面。将包含 continuation-mark-set->context 的 margin-note 与附近的 @interaction 示例进行比较，并检查 PDF 如何处理这个较长的标识符。完成的标准是边注始终位于装订线内，包括所引用的 guide 页面。
由索引模型根据 Issue 内容生成。
描述
What version of Racket are you using?
8.15
What program did you run?
scribble/manual render to pdf
example showing continuation-mark-set->context running beyond edge of page in pdf viewer
page 226
https://download.racket-lang.org/releases/8.15/pdf-doc/guide.pdf
What should have happened?
I'd expect scribble to wrap keep margin notes within gutter by wrapping @racket[continuation-mark-set->context] on hyphens like exn-message in @interaction block on the same page.(see full page capture below).
Not a big issue as manual is intended to be used via browser, but may be frustrating for e-reader users who use PDF. (I was trying to publish print copy via amazon with permission of author)
continuation-mark-set->context
Line 124
@margin-note{The @racket[continuation-mark-set->context] procedure provides best-effort structured backtrace information.}
Please include any other relevant details
Interaction block
@interaction[
(with-handlers ([exn:fail?
(lambda (v)
((error-display-handler) (exn-message v) v))])
(car 17))
]
full page
'Gutter' guidance from amazon kindle direct publishing:
Insufficient gutter. Books with 407 pages require at least 0.625" (15.875mm) for the gutter (inside margin) and at least 0.25" (6.35mm) for the outside, top and bottom margins.
- 主要语言
- Racket
- 星标
- 250
- 派生
- 102
- 平均合并
- 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
-
add bootmlm未关闭
难度 1/5 1 小时以内 新手友好度 62/100
-
难度 2/5 1-3 小时 新手友好度 62/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
aws-samples/sample-per-model-bedrock#191 ·
维护者通常 1 天内回复
-
Docs viewer: inverted grey colormap, Phantom CT window -20 to 35 HU, smoothing up to 40 mm可能已有人在做 关联的 PR 仍在进行中或已合并。 未关闭area: docs enhancement
难度 2/5 1-3 小时 新手友好度 64/100
PyTomography/PyTomography#331 ·
维护者通常 1 天内回复
-
content 📄 needs triage 🤔
难度 2/5 1-3 小时 新手友好度 62/100
Qiskit/documentation#5790 ·
维护者通常 1 天内回复