Docs: C annotations extension produces invalid docutils tree
Abierto
@AA-Turner ya está trabajando en esto.
Desde el 12/10/2025.
docs
type-bug
- Lenguaje dominante
- Python
- Estrellas
- 77.2k
- Forks
- 35.9k
- Métricas de merge de PR
- Métricas de PR pendientes
Descripción
The function
add_annotationsinDoc/tools/extensions/c_annotations.pyinserts an emphasis node into a desc_content node. This produces an invalid document tree, since the desc_content node is a docutils Element and is not supposed to have children that are text or inline elements. To fix this, the emphasis node needs to be wrapped in a paragraph node.[…] the validity of the docutils tree is not checked by docutils or Sphinx.
This prevents to build the documentation to PDF with rinohtype.
Linked PRs
- gh-145838
Guía de contribución
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.
Evaluación
Este issue todavía no se ha evaluado.