Sphinx HTML Help Builder

2.1.0 verified Tue May 12 auth: no python install: verified

sphinxcontrib-htmlhelp is a Sphinx extension that generates HTML Help files (CHM) from reStructuredText sources. It is currently at version 2.1.0 and is actively maintained, receiving updates frequently, often in sync with Sphinx core releases.

pip install sphinxcontrib-htmlhelp

Warnings

gotcha Generating the final HTML Help (.chm) file from the Sphinx output requires the Microsoft HTML Help Workshop. This is a Windows-only tool, meaning the CHM compilation step cannot be performed on Linux, macOS, or other non-Windows operating systems. ↓

fix Ensure you are building and compiling on a Windows environment or target a different output format.

gotcha The HTML Help (CHM) format is an older, Windows-specific documentation format. It may not be suitable for modern web-based documentation workflows, cross-platform users, or integration with contemporary documentation platforms. Consider if this format truly meets your audience's needs. ↓

fix Evaluate whether alternative Sphinx builders (e.g., HTML, PDF via LaTeX, Epub) might better serve your documentation's distribution and accessibility requirements.

breaking The `sphinxcontrib-htmlhelp` library explicitly requires Python 3.9 or newer. Older Python versions are not supported. ↓

fix Upgrade your Python environment to 3.9 or a newer compatible version.

deprecated While the `sphinxcontrib-htmlhelp` extension itself is actively maintained, the underlying HTML Help (.chm) format has largely been superseded by web-based documentation. Depending on your target audience, using this format might limit accessibility and modern features. ↓

fix Consider migrating to standard HTML, Read the Docs, or other modern documentation platforms for better compatibility and user experience.

Install compatibility verified last tested: 2026-05-12

python os / libc status wheel install import disk

3.10 alpine (musl) wheel - 0.00s 18.7M

3.10 alpine (musl) - - 0.00s 18.7M

3.10 slim (glibc) wheel 1.5s 0.00s 19M

3.10 slim (glibc) - - 0.00s 19M

3.11 alpine (musl) wheel - 0.00s 20.5M

3.11 alpine (musl) - - 0.00s 20.5M

3.11 slim (glibc) wheel 1.6s 0.00s 21M

3.11 slim (glibc) - - 0.00s 21M

3.12 alpine (musl) wheel - 0.00s 12.4M

3.12 alpine (musl) - - 0.00s 12.4M

3.12 slim (glibc) wheel 1.5s 0.00s 13M

3.12 slim (glibc) - - 0.00s 13M

3.13 alpine (musl) wheel - 0.00s 12.1M

3.13 alpine (musl) - - 0.00s 12.0M

3.13 slim (glibc) wheel 1.5s 0.00s 13M

3.13 slim (glibc) - - 0.00s 13M

3.9 alpine (musl) wheel - 0.00s 18.2M

3.9 alpine (musl) - - 0.00s 18.2M

3.9 slim (glibc) wheel 1.8s 0.00s 19M

3.9 slim (glibc) - - 0.00s 19M

Imports

sphinxcontrib.htmlhelp
```
extensions = ['sphinxcontrib.htmlhelp']
```
Sphinx extensions are enabled by adding their module name to the `extensions` list in `conf.py`, not via direct Python `import` statements in user code.

Quickstart last tested: 2026-04-24

After installing the package, enable the extension by adding `'sphinxcontrib.htmlhelp'` to the `extensions` list in your Sphinx project's `conf.py` file. Then, build your documentation using the `htmlhelp` builder.

# 1. Install the extension
# pip install sphinxcontrib-htmlhelp

# 2. In your Sphinx project's conf.py file, add 'sphinxcontrib.htmlhelp' to the extensions list:
# conf.py
# ...
extensions = [
    'sphinx.ext.autodoc',
    'sphinx.ext.napoleon',
    'sphinxcontrib.htmlhelp'
]
# ...

# Optionally, configure HTML Help specific options (e.g., the output basename):
htmlhelp_basename = 'MyProjectDoc'