feat: TableOfContents and Fragments
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Idoneità per principianti
- 58/100
Direzione di ricerca
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.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
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)
- Lingua principale
- C#
- Stelle
- 1
- Fork
- 0
- Merge medio
- 10h 23m
- PR unite (30g)
- 4
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Nessun modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di MASS4ORG/Fanstatic
-
c:templates p:low size:S t:task
Difficoltà 5/5 Più di una settimana Idoneità per principianti 45/100
-
c:content good first issue p:low size:S t:feature
Difficoltà 4/5 3-5 giorni Idoneità per principianti 58/100
-
c:templates p:medium size:M t:feature
Difficoltà 5/5 Più di una settimana Idoneità per principianti 35/100
-
c:content p:medium size:L t:feature
Difficoltà 5/5 Più di una settimana Idoneità per principianti 35/100
-
c:templates p:medium size:S t:feature
Difficoltà 4/5 3-5 giorni Idoneità per principianti 57/100
Tutte le issue di MASS4ORG/Fanstatic
Issue simili
-
area-signalr
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
dotnet/aspnetcore#69842 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 64/100
I maintainer di solito rispondono entro 2 giorni
-
bug needs-triage
Difficoltà 2/5 Meno di un'ora Idoneità per principianti 78/100
microsoft/microsoft-ui-reactor#1373 ·
I maintainer di solito rispondono entro 1 giorno
-
Client customer-reported KeyVault needs-team-attention question Service Attention
Difficoltà 2/5 1-3 ore Idoneità per principianti 62/100
Azure/azure-sdk-for-net#63861 · 3 commenti · 1 reazione ·
I maintainer di solito rispondono entro 1 giorno
-
:watch: Not Triaged dotnet-csharp/svc fundamentals/subsvc
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 85/100
I maintainer di solito rispondono entro 1 giorno