[x] add $(STAMP_NODE_READY) and $(TOX_VENV_INSTALLED) as order-only prerequisites as needed
[x] FIXME: STYLE_DIR := $(THEME_DIR)/_src/style
[x] FIXME: util/lint/prettier and util/lint/stylelint require $(STAMP_NODE_READY) as (order-only) prerequisite, as they are executed from the local NodeJS installation
there are some places, where build artifacts are required for further processing (e.g. .build/_static/style.css). All files in .build are created/updated when running Sphinx / when the recipe for $(STAMP_SPHINX_COMPLETED) is executed. Is it safe to include an empty target like $(BUILD_DIR)/_static/style.css : $(STAMP_SPHINX_COMPLETED) ; in the Makefile to track this dependency? make's manual explicitly mentions the use case for artifacts, that are generated as side-effects of other recipes/targets, which is the case here (.build/_static/style.css is a side-effect of running Sphinx while executing the recipe for $(STAMP_SPHINX_COMPLETED))
Does not work as intended. Instead, grouped targets might be used. But probably not worth the hassle. I'm inclined to skipping this!
remove obsolete files in the build:
[x] .build/genindex/index.html
[x] .build/objects.inv
[x] .build/search/index.html
[x] .build/searchindex.js
[x] .build/_static/pygments.css
[x] .build/_static/style.css.map
[x] check for hidden files within .build/, e.g. .doctrees/ and .buildinfo
[x] while running in CI, Sphinx's linkcheck builder is used. Probably it is creating files output.json and output.txt in the .build/ directory
Makefile:$(STAMP_NODE_READY)and$(TOX_VENV_INSTALLED)as order-only prerequisites as neededSTYLE_DIR := $(THEME_DIR)/_src/styleutil/lint/prettierandutil/lint/stylelintrequire$(STAMP_NODE_READY)as (order-only) prerequisite, as they are executed from the localNodeJSinstallationechostatements.build/_static/style.css). All files in.buildare created/updated when runningSphinx/ when the recipe for$(STAMP_SPHINX_COMPLETED)is executed. Is it safe to include an empty target like$(BUILD_DIR)/_static/style.css : $(STAMP_SPHINX_COMPLETED) ;in theMakefileto track this dependency?make's manual explicitly mentions the use case for artifacts, that are generated as side-effects of other recipes/targets, which is the case here (.build/_static/style.cssis a side-effect of runningSphinxwhile executing the recipe for$(STAMP_SPHINX_COMPLETED)).build/genindex/index.html.build/objects.inv.build/search/index.html.build/searchindex.js.build/_static/pygments.css.build/_static/style.css.map.build/, e.g..doctrees/and.buildinfoSphinx'slinkcheckbuilder is used. Probably it is creating filesoutput.jsonandoutput.txtin the.build/directoryrmthem!