[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/style
util/lint/prettier
andutil/lint/stylelint
require$(STAMP_NODE_READY)
as (order-only) prerequisite, as they are executed from the localNodeJS
installationecho
statements.build/_static/style.css
). All files in.build
are 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 theMakefile
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 runningSphinx
while 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.buildinfo
Sphinx
'slinkcheck
builder is used. Probably it is creating filesoutput.json
andoutput.txt
in the.build/
directoryrm
them!