Docs: C annotations extension produces invalid docutils tree
Aberta
@AA-Turner já está trabalhando nisso.
Desde 12/10/2025.
docs
type-bug
- Linguagem predominante
- Python
- Estrelas
- 77.2k
- Forks
- 36k
- Métricas de merge de PRs
- Métricas de PR pendentes
Descrição
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
Guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Avaliação
Esta issue ainda não foi avaliada.