docs: Netlify failing to build website

[moreati]

Netlify now using Python 3.13 , which removed imghdr from the standard library. The Python version is configurable https://www.netlify.com/blog/announcing-configurable-python-versions-in-netlify-builds/

10:07:13 AM: Build command from Netlify app                                
10:07:13 AM: ────────────────────────────────────────────────────────────────
10:07:13 AM: ​
10:07:13 AM: $ make default
10:07:13 AM: sphinx-build . build/html/
10:07:14 AM: Failed during stage 'building site': Build script returned non-zero exit code: 2 (https://ntl.fyi/exit-code-2)
10:07:14 AM: Running Sphinx v2.1.2
10:07:14 AM: Extension error:
10:07:14 AM: Could not import extension sphinx.builders.epub3 (exception: No module named 'imghdr')
10:07:14 AM: make: *** [Makefile:5: default] Error 2

[moreati]

A build https://677d01bf9e4d994959104d41--spiffy-croissant-696d93.netlify.app/ https://app.netlify.com/sites/spiffy-croissant-696d93/deploys/677d01bf9e4d994959104d41 succeeded with PYTHON_VERSION=3.8

[moreati]

Adding docs/netlify.toml

mitogen/docs/netlify.toml

Lines 1 to 2 in 69b6552

	[build.environment]
	PYTHON_VERSION = "3.8"

didn't have the desired effect in the mitogen.networkgenomics.com app. Unfortunately I don't have direct access to that Netlify app's config or logs. Best guesses

• mitogen.networkgenomics.com has a different Base directory, or Package directory configured in build settings - these are where Nwtlify looks for netlify.toml
• Another problem is preventing mitogen.networkgenomics.com, in addition to the Python version.

The Build config for spiffy-croissant is

Refs

• https://docs.netlify.com/configure-builds/overview/
• https://docs.netlify.com/configure-builds/file-based-configuration/

[moreati]

#1209 fixed it. https://mitogen.networkgenomics.com/changelog.html now shows release 0.3.20. Based on that, I think the BUild settings are

Setting	Value
Base directory	docs or /docs
Package directory	/