ekalinin/github-markdown-toc
Github Markdown Toc
Acest proiect este un utilitar de linie de comandă conceput pentru a automatiza crearea și menținerea cuprinsului în fișierele markdown. Funcționează ca un procesor de documentație statică ce analizează titlurile documentelor pentru a genera liste de navigare ierarhice, care sunt apoi injectate direct în fișierele sursă.
Instrumentul se distinge prin suportul atât pentru fișiere locale, cât și pentru fluxuri de rețea remote ca surse de intrare. Utilizează actualizarea conținutului bazată pe markere pentru a reîmprospăta secțiunile de navigare existente fără a necesita editări manuale și include suport de autentificare pentru cererile remote, pentru a depăși limitele de rată ale serviciilor atunci când se preia documentație externă.
Dincolo de generarea de bază, utilitarul gestionează normalizarea titlurilor în anchor slug-uri sigure pentru URL și gestionează metadatele structurale necesare pentru indexarea consistentă a documentelor. Este destinat eficientizării fluxurilor de lucru de documentație prin automatizarea menținerii structurilor de navigare în fișierele repository-ului și în conținutul tehnic distribuit.
