Esta habilidad agrupa las buenas prácticas y la automatización de la documentación con Sphinx para proyectos Python: configura mapeos Intersphinx para crea…
Esta habilidad agrupa las buenas prácticas y la automatización de la documentación con Sphinx para proyectos Python: configura mapeos Intersphinx para crear referencias cruzadas fiables a documentación externa (Python, NumPy, pandas, SciPy, Matplotlib, scikit‑learn), muestra cómo generar múltiples formatos de salida (HTML, LaTeX/PDF, ePub) con sphinx-build y proporciona la configuración de Read the Docs para builds alojados. También cubre extensiones Sphinx personalizadas (directivas) para ampliar el marcado y flujos de trabajo de GitHub Actions para automatizar la construcción y publicación de la documentación al hacer push. Finalmente, explica cómo usar sphinx-autoapi para generar automáticamente la referencia de la API a partir del código fuente. Usa esta habilidad para producir documentación coherente y con referencias cruzadas, automatizar la publicación CI/CD (RTD o GitHub Pages), reducir el mantenimiento manual de la documentación de la API y ampliar Sphinx con directivas específicas del proyecto para documentación más clara y reutilizable.
Esta página forma parte del hub OpenClaw Skills con guías de instalación, categorías y enlaces prácticos.