`margin-note` exceeds page limit in PDF e.g. Racket guide
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 3/5
- Thời gian dự kiến
- 1-2 ngày
- Mức phù hợp với người mới
- 45/100
- Loại issue
- Lỗi
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Đình trệ
- Lĩnh vực
- documentation
Hướng nghiên cứu
Bắt đầu với pkgs/racket-doc/scribblings/guide/control.scrbl ở dòng 124 và tái tạo trang bằng scribble/manual, được kết xuất thành PDF. So sánh margin-note chứa continuation-mark-set->context với ví dụ @interaction gần đó và kiểm tra cách PDF xử lý mã định danh dài. Hoàn tất khi ghi chú bên lề vẫn nằm trong vùng gáy, kể cả trên trang guide được tham chiếu.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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.
- Ngôn ngữ chính
- Racket
- Star
- 250
- Fork
- 102
- Merge trung bình
- 11 ngày 9 giờ
- Pull request đã merge (30 ngày)
- 2
Chuẩn bị môi trường
Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của racket/scribble
-
In source strcut*-doc does not convert to defstruct* properly when #:constructor-name is usedĐang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 65/100
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 74/100
-
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 35/100
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 55/100
-
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 35/100
Tất cả issue của racket/scribble
Issue tương tự
-
good first issue hacktoberfest help wanted
Độ khó 2/5 Dưới một giờ Mức phù hợp với người mới 76/100
pacocartones/free-llm-api-hub#262 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
docs good first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 83/100
soma-intelligence/open-health-sync#59 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
agent-task risk:low
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 88/100
guyellis/http-status-check#512 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
docs: AGENTS.md has no rule against running deploy scripts into the owner's game installCó thể đã có người làm @thesprockee đã nhận hôm nay. Đang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 85/100
EchoTools/nevr-runtime#524 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 88/100
gradio-app/gradio#13964 ·
Maintainer thường phản hồi trong vòng 1 ngày