sphinx-docs

# Sphinx Documentation Skill Sphinx documentation system expertise for technical and API documentation. ## Capabilities - Configure conf.py for various projects - Write and manage reStructuredText (RST) content - Configure autodoc for Python API documentation - Set up intersphinx for cross-project linking - Create and manage Sphinx extensions - Generate multiple output formats (HTML, PDF, ePub) - Theme configuration (Read the Docs, Furo) - LaTeX and PDF customization ## Usage Invoke this skill when you need to: - Set up Sphinx documentation for Python projects - Generate API documentation from docstrings - Configure cross-project references - Create custom extensions - Generate PDF documentation ## Inputs | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | action | string | Yes | init, configure, autodoc, build | | projectPath | string | Yes | Path to Sphinx project | | outputFormat | string | No | html, pdf, epub (default: html) | | theme | string | No | sphinx_rtd_theme, furo, alabaster | | extensions | array | No | Sphinx extensions to enable | ### Input Example ```json { "action": "configure", "projectPath": "./docs", "theme": "furo", "extensions": ["autodoc", "napoleon", "intersphinx"] } ``` ## Project Configuration ### conf.py ```python # Configuration file for the Sphinx documentation builder. import os import sys # Add project root to path for autodoc sys.path.insert(0, os.path.abspath('..')) # -- Projec...