Docs: C annotations extension produces invalid docutils tree
Đang mở
@AA-Turner đang làm issue này rồi.
Từ ngày 12/10/2025.
docs
type-bug
- Ngôn ngữ chính
- Python
- Star
- 77.2k
- Fork
- 35.9k
- Chỉ số merge pull request
- Chỉ số pull request đang chờ
Mô tả
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
Hướng dẫn đóng góp
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.
Đánh giá
Issue này chưa được đánh giá.