feat: TableOfContents and Fragments
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức phù hợp với người mới
- 58/100
Hướng nghiên cứu
Start in Page.cs:427-431 to trace Markdown conversion, then review Fanstatic/Helpers/SiteHelper.cs:18-20 for the existing heading IDs. Check how tests and fixture sites are organized in Fanstatic.Test/ and .TestSites/, and run ./build.sh test. Done when a fixture page’s TOC matches its headings and generated IDs, the fragment properties and configurable levels work, and the page-variables docs cover them.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Part of the Phase 2 epic (#23).
Current State
Markdig's UseAdvancedExtensions (Fanstatic/Helpers/SiteHelper.cs:18-20) already generates heading ids, but
templates cannot get a table of contents or the list of heading ids.
Tasks:
- Collect headings (level, text, id) while converting Markdown (
Page.cs:427-431) -
page.TableOfContents: nested<nav id="TableOfContents"><ul>…</ul></nav>HTML; levels configurable
(TableOfContents: { StartLevel: 2, EndLevel: 3 }) -
page.Fragments.Headings(structured list) andpage.Fragments.Identifiers - Document on the page-variables docs
Tests live in Fanstatic.Test/ (xUnit + NSubstitute); fixture sites in .TestSites/. Run ./build.sh test; new/changed methods need CRAP ≤ 15 and ≥ 75 % line coverage.
Acceptance Criteria:
- TOC HTML matches the headings and their generated ids on a fixture page.
Related:
- #23 (Phase 2 epic, parent)
- Ngôn ngữ chính
- C#
- Star
- 1
- Fork
- 0
- Merge trung bình
- 10 giờ 23 phút
- Pull request đã merge (30 ngày)
- 4
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Không có mẫu pull request
- Đọc 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.
Issue khác của MASS4ORG/Fanstatic
-
c:templates p:low size:S t:task
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 45/100
-
c:content good first issue p:low size:S t:feature
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 58/100
-
c:templates p:medium size:M t:feature
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 35/100
-
c:content p:medium size:L t:feature
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 35/100
-
c:templates p:medium size:S t:feature
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 57/100
Tất cả issue của MASS4ORG/Fanstatic
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 88/100
Maintainer thường phản hồi trong vòng 7 ngày
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 65/100
vchelaru/FlatRedBall2#1481 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
ai-chat bug trivial
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
Maintainer thường phản hồi trong vòng 1 ngày
-
area-signalr
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
dotnet/aspnetcore#69842 · 1 bình luận ·
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 75/100
Maintainer thường phản hồi trong vòng 1 ngày