{"categories":[{"label":"Sphinx","url":"https://skillfed.io/packages/category/documentation-sphinx"}],"enrichment":{"capability":"nbsphinx is a Sphinx extension that parses Jupyter Notebook files (.ipynb) as documentation source, rendering notebook code cells and their outputs in Sphinx-generated HTML and LaTeX documentation, with automatic execution of unevaluated notebooks during the build.","skillfed_tags":["jupyter-integration","documentation-generation"],"use_cases":["Include executable Jupyter tutorials or walkthroughs directly in Sphinx documentation without manual conversion.","Build API documentation that interleaves narrative text with runnable code examples from notebooks.","Create scientific or research documentation where computed results are embedded in the final HTML or PDF output.","Maintain a single notebook source that serves both as a standalone Jupyter file and as part of your Sphinx docs.","Automatically regenerate documentation output from notebooks during the build, keeping examples in sync with code."],"what_it_does":"nbsphinx bridges Jupyter Notebooks and Sphinx documentation by treating .ipynb files as native Sphinx source. When you add notebook filenames to your Sphinx toctree, the extension parses them, renders code cells and outputs as documentation, and automatically executes any notebooks that lack stored output. This lets you write executable examples or tutorials as Jupyter Notebooks and have them appear seamlessly in your Sphinx-built HTML or LaTeX docs.\n\nThe package depends on nbconvert and nbformat to handle notebook I/O, sphinx for the documentation framework, and supporting libraries (docutils, jinja2, traitlets) for rendering and configuration. It's designed for technical documentation, education, and research contexts where executable code examples are valuable.","worth_installing":"Yes. nbsphinx is actively maintained, has low install friction, carries no security vulnerabilities, and solves a specific and well-defined problem: integrating Jupyter Notebooks into Sphinx documentation. Install it if you want to include executable notebooks or notebook-style examples in your Sphinx docs; skip it if your documentation doesn't use notebooks."},"id":"nbsphinx","links":{"html":"https://skillfed.io/packages/nbsphinx","md":"https://skillfed.io/packages/nbsphinx.md","pypi":"https://pypi.org/project/nbsphinx/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2025-11-28","license_spdx":"MIT","license_treatment":"permissive","name":"nbsphinx","python_support":"supports_current","summary":"Jupyter Notebook Tools for Sphinx"},"popularity":{"monthly_downloads":1913540,"position":3438,"tier":"top_5000"},"security":{"n_vulnerabilities":0},"version":"0.9.8"}
