Sphinx collections cannot be nested
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 25/100
- Loại issue
- Lỗi
- Độ rõ ràng
- Cần làm rõ
- Mức độ hoạt động
- Đình trệ
- Công nghệ
- python
- Lĩnh vực
- documentation
Hướng nghiên cứu
Bắt đầu với tham chiếu đang bị lỗi docs/_collections/score_docs_as_code/docs/index.rst và build :docs_combo_experimental trong reference-integration PR 43. Đọc cách sphinx-collections được cấu hình trong docs-as-code và reference-integration, sau đó đánh giá việc loại bỏ trong ngắn hạn và các phương án thay thế trong dài hạn được mô tả trong issue. Hoàn tất khi collections lồng nhau hoạt động cho các module hoặc build không còn báo undefined process-collection label.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
When I integrate the docs-as-code module in reference-integration, the :docs_combo_experimental build fails:
/home/runner/work/reference_integration/reference_integration/docs/_collections/score_docs_as_code/docs/index.rst:6: WARNING: undefined label: '_collections/score_process/process/index' [ref.ref]
The problem is the sphinx-collections extension which is used in reference-integration and in docs-as-code. When docs-as-code is not the documentation root, it doesn't find the process collection.
Short-term we can simply remove it from docs-as-code since we only really need it reference-integration currently.
Long-term we want a solution which just works for any module which wants to use it. I see two option: Adapt sphinx-collections to handle such a use-case. Stop using sphinx-collections and implement the combo differently.
- Ngôn ngữ chính
- Python
- Star
- 11
- Fork
- 33
- Merge trung bình
- 22 giờ 36 phút
- Pull request đã merge (30 ngày)
- 61
Chuẩn bị môi trường
Chúng tôi chưa kiểm tra các tệp thiết lập môi trường của dự án này. Hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.
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.
Issue khác của eclipse-score/docs-as-code
-
bug: metamodel reference has no menuCó thể đã có người làm @Logeshwari-Sithan đã nhận 2 ngày trước. Đang mởgood first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
eclipse-score/docs-as-code#850 · 1 người được giao ·
Maintainer thường phản hồi trong vòng 1 ngày
-
make _build folder configurableCó thể đã có người làm @naveena456 đã nhận 5 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
eclipse-score/docs-as-code#771 · 1 người được giao ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Add project name to headline ...Đang mởdocumentation
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
eclipse-score/docs-as-code#613 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
update py_venvĐang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 65/100
eclipse-score/docs-as-code#606 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug waiting_for_author
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
eclipse-score/docs-as-code#288 · 2 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của eclipse-score/docs-as-code
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
solana-foundation/pay-kit#341 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
nasa/python_cmr#123 ·
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 92/100
EleutherAI/lm-evaluation-harness#4243 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
area: dashboard bug perceived difficulty: 3
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 88/100
Nitjsefnie-Harness-Commons/daedalus#1179 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 88/100
cusp-ai-oss/tojax#17 ·