thlorenz/doctoc
Doctoc
doctoc es un generador de tablas de contenido markdown y procesador de archivos diseñado para crear y actualizar automáticamente listas vinculadas de encabezados dentro de documentos markdown. Funciona como una herramienta de documentación de repositorios git que escanea directorios locales para asegurar que la navegación permanezca consistente a través de una colección de archivos.
La herramienta cuenta con un generador de anclas compatible con GitHub que formatea los enlaces de encabezado para que coincidan con los requisitos específicos de GitHub y plataformas de alojamiento similares. Gestiona las actualizaciones localizando comentarios marcadores para reemplazar las tablas de contenido existentes sin sobrescribir otro contenido del documento.
El proyecto cubre el procesamiento recursivo de directorios, lo que le permite escanear carpetas anidadas y aplicar actualizaciones a todos los archivos compatibles. También incluye filtrado de contenido y control de entradas para excluir encabezados o archivos específicos basados en niveles de anidamiento o etiquetas de metadatos.
Una utilidad de validación de consistencia permite a la herramienta verificar si los archivos están desactualizados sin modificarlos, facilitando la integración en flujos de trabajo de documentación automatizados.
Features
- Automatic Table of Contents - Automatically generates navigational outlines based on the heading hierarchy of Markdown documents.
- Anchor Links - Generates navigation identifiers that ensure compatibility with the anchor requirements of hosting providers.
- Markdown Processors - Provides a recursive processor that scans and transforms Markdown documents to maintain consistent navigation and formatting.
- Markdown Documentation - Automates the creation and maintenance of tables of contents for large sets of Markdown documentation.
- Platform Anchor Generators - Provides GitHub-compatible anchor generation to ensure navigation links function correctly on hosting platforms.
- TOC Refresh Utilities - Refreshes existing tables of contents by locating marker comments to prevent duplicate entries.
- Git Documentation Utilities - Scans local Git directories to ensure all Markdown files have consistent and current navigation.
- RegEx Heading Extractors - Uses regular expressions to identify heading levels and extract structure for table of contents generation.
- Markdown Content Structures - Manages navigation for complex directory structures through recursive processing and content filtering.
- Content Consistency Validators - Checks if document headings match the existing table of contents to signal required updates without modifying files.
- TOC Generation - Validates the consistency of the generated table of contents against the actual document headings.
- TOC Content Filters - Excludes specific headings or files from the generated table of contents using specialized markup tags.
- TOC Entry Controllers - Controls which headings appear in the table of contents based on nesting levels and minimum length.
- GitHub Repository Utilities - Provides utility functions to ensure Markdown navigation links are compatible with GitHub's repository structure.
- Documentation Automation - Integrates table of contents generation into build pipelines to keep navigation in sync with heading changes.
- Recursive Directory Processing - Traverses folder hierarchies to apply table of contents updates across entire project directories.
- Markdown File Processors - Recursively scans directories to apply table of contents generation to all compatible Markdown files.
- Recursive Directory Traversers - Recursively walks directory trees to locate all markdown files for batch processing.
- Marker-Based Injection Utilities - Implements programmatic updates of documentation by injecting table of contents between predefined marker comments.
- Markdown Tools - Generates table of contents for markdown files.
