nl-design-system / documentatie

Website met documentatie van NL Design system: componenten, patronen, richtlijnen etcetera. Development-versie: https://documentatie.vercel.app/
https://www.nldesignsystem.nl/
European Union Public License 1.2
9 stars 11 forks source link

table_of_contents met links naar de kopjes werkt niet als een pagina is opgebouwd uit verschillende md/mdx bestanden #606

Open rianrietveld opened 5 months ago

rianrietveld commented 5 months ago

Pagina instelling: hide_table_of_contents: false De Table of Contents rechts boven wordt wel gegenereerd op Typografie, wat 1 bestand is, maar niet op {Buttons](https://nldesignsystem.nl/richtlijnen/formulieren/alle-richtlijnen/buttons) wat bestaat uit meerdere bestanden. De headings plus bijbehorende zitten bij Buttons in een losse bestanden.

Nu is er aan deze TOC wel wat te verbeteren. De lijst een kopje geven en een nav zou mooi zijn. Bijvoorbeeld (versimpeld, zonder classes):

<nav aria-labelledby="inhoudsopgave">
<h2 id="inhoudsopgave">Inhoudsopgave</h2>
  <ul>
    <li><a href="#lettergrootte">Lettergrootte</a></li>
    <li><a href="#regelafstand">Regelafstand</a></li>
    <li><a href="#regellengte">Regellengte</a></li>
     [etc]
  </ul>
</nav>

En daarnaast ook de functionaliteit om de aangeroepen bestanden in een pagina mee te indexeren voor de inhoudsopgave.

rianrietveld commented 5 months ago

gerelateerd: https://github.com/nl-design-system/documentatie/issues/427