codeblock reports errors in terms of read-syntax
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 45/100
- Issue 类型
- 缺陷
- 描述清晰度
- 基本清楚
- 活跃度
- 停滞
调研方向
首先运行提供的 Scribble codeblock 示例，并将其运行时的 read-syntax 错误与 markdown 示例中显示的源位置进行比较。跟踪 codeblock 的解析路径和 markdown/scrib 路径，然后验证格式错误的块输入报告了适当的错误和源位置，而不是暴露内部的 read-syntax 消息。
由索引模型根据 Issue 内容生成。
描述
When codeblock can't parse its arguments, the error can be raised in terms of read-syntax. For example, the following program produces the error message “:4:4: read-syntax: bad syntax # ” at runtime (not at read-time):
#lang scribble/manual
@codeblock{
`@"`"`
A ::= B
| C
| D # which is an E
`@"`"`
}
This inspired @shriram's example in https://github.com/greghendershott/markdown/issues/84. With that example, the srcloc points to the markdown/scrib library:
#lang at-exp racket
(require markdown markdown/scrib scribble/decode)
(define xs
(parameterize ([current-input-port
(open-input-string
@string-append{```
A ::= B
| C
| D # which is an E
```})])
(read-markdown)))
xs
(with-handlers ([exn:fail? (λ (e) e)])
(xexprs->scribble-pres xs))
- 主要语言
- 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 hacktoberfest priority: low skill: good first issue status: ready for dev
难度 2/5 半天 新手友好度 85/100
hyperledger-labs/fabric-smart-client#2142 ·
维护者通常 1 天内回复
-
[DOC] Wrong sg_egress_ports range in the Terraform Databricks Guide for AWS Hub & Spoke with Network Firewall可能已有人在做 @akhil9tiet 今天认领。 未关闭docs
难度 1/5 1 小时以内 新手友好度 72/100
databricks/terraform-provider-databricks#6080 · 1 条评论 ·
维护者通常 3 天内回复
-
难度 2/5 1-3 小时 新手友好度 82/100
维护者通常 2 天内回复
-
kind/documentation
难度 2/5 1-3 小时 新手友好度 80/100
kubernetes-sigs/dra-driver-nvidia-gpu#1569 ·
维护者通常 1 天内回复
-
documentation
难度 1/5 1 小时以内 新手友好度 92/100
QuantEcon/QuantEcon.py#988 ·
维护者通常 1 天内回复