codeblock reports errors in terms of read-syntax
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Aptitud para principiantes
- 45/100
- Tipo de issue
- Error
- Claridad
- Bastante claro
- Estado de actividad
- Estancado
- Área
- documentation
Línea de trabajo
Empieza ejecutando el ejemplo de Scribble codeblock proporcionado y compara su error de read-syntax en tiempo de ejecución con la ubicación de origen mostrada en el ejemplo de markdown. Traza la ruta de análisis de codeblock y la ruta markdown/scrib; después, verifica que una entrada de bloque malformada informe de un error y una ubicación de origen adecuados, en lugar de exponer un mensaje interno de read-syntax.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
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))
- Lenguaje dominante
- Racket
- Estrellas
- 251
- Forks
- 101
- Merge medio
- 11 d 9 h
- PR fusionados (30 d)
- 2
Preparar el entorno
Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de racket/scribble
-
In source strcut*-doc does not convert to defstruct* properly when #:constructor-name is usedAbierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
-
Dificultad 3/5 1-2 días Aptitud para principiantes 74/100
-
Dificultad 4/5 3-5 días Aptitud para principiantes 35/100
-
Dificultad 3/5 1-2 días Aptitud para principiantes 55/100
-
Dificultad 4/5 3-5 días Aptitud para principiantes 35/100
Todos los issues de racket/scribble
Issues similares
-
documentation good first issue
Dificultad 2/5 Medio día Aptitud para principiantes 72/100
sujithputta02/Esapay#13 ·
-
good first issue
Dificultad 1/5 Menos de una hora Aptitud para principiantes 88/100
saayam-for-all/webapp#1919 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
Uuriko/project-room#3728 ·
Los mantenedores suelen responder en 1 día
-
docs(site): Mermaid edge-label contrast on Architecture and a table header on How it comparesAbiertodocumentation
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
devops-thiago/ThrillhouseBot#1132 ·
Los mantenedores suelen responder en 1 día
-
Old package name @routedock/sdk is still used in JSDoc, test run instructions and docsPosiblemente ocupada @TS-mfon la tomó hoy. Abiertodocs dx P2 Stellar Wave Wave 10
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
winsznx/routedock#576 · 5 comentarios ·
Los mantenedores suelen responder en 1 día