esphome-docs/Makefile

60 lines
1.8 KiB
Makefile
Raw Normal View History

2019-05-12 22:44:59 +02:00
ESPHOME_PATH = ../esphome
2023-10-13 03:16:25 +02:00
ESPHOME_REF = 2023.10.0b2
2018-05-13 11:37:02 +02:00
.PHONY: html html-strict cleanhtml deploy help live-html Makefile netlify netlify-api api netlify-dependencies svg2png copy-svg2png minify
2018-05-13 11:37:02 +02:00
html:
2019-05-15 10:54:51 +02:00
sphinx-build -M html . _build -j auto -n $(O)
live-html:
sphinx-autobuild . _build -j auto -n $(O) --host 0.0.0.0
2019-05-13 21:51:04 +02:00
html-strict:
2019-05-15 10:54:51 +02:00
sphinx-build -M html . _build -W -j auto -n $(O)
2018-06-07 19:29:35 +02:00
minify:
minify _static/webserver-v1.js > _static/webserver-v1.min.js
minify _static/webserver-v1.css > _static/webserver-v1.min.css
cleanhtml:
rm -rf "_build/html/*"
2018-05-13 11:37:02 +02:00
svg2png:
python3 svg2png.py
2018-06-07 19:29:35 +02:00
help:
sphinx-build -M help . _build $(O)
2018-06-07 19:29:35 +02:00
api:
mkdir -p _build/html/api
2019-05-12 22:44:59 +02:00
@if [ ! -d "$(ESPHOME_PATH)" ]; then \
git clone --branch $(ESPHOME_REF) https://github.com/esphome/esphome.git $(ESPHOME_PATH) || \
git clone --branch beta https://github.com/esphome/esphome.git $(ESPHOME_PATH); \
fi
2019-05-12 22:44:59 +02:00
ESPHOME_PATH=$(ESPHOME_PATH) doxygen Doxygen
2018-05-14 21:15:49 +02:00
netlify-api: netlify-dependencies
mkdir -p _build/html/api
2019-05-12 22:44:59 +02:00
@if [ ! -d "$(ESPHOME_PATH)" ]; then \
git clone --branch $(ESPHOME_REF) https://github.com/esphome/esphome.git $(ESPHOME_PATH) || \
git clone --branch beta https://github.com/esphome/esphome.git $(ESPHOME_PATH); \
2018-08-27 13:21:30 +02:00
fi
2019-05-12 22:44:59 +02:00
ESPHOME_PATH=$(ESPHOME_PATH) ../doxybin/doxygen Doxygen
2018-08-27 13:21:30 +02:00
netlify-dependencies:
mkdir -p ../doxybin
curl -L https://github.com/esphome/esphome-docs/releases/download/v1.10.1/doxygen-1.8.13.xz | xz -d >../doxybin/doxygen
chmod +x ../doxybin/doxygen
copy-svg2png:
cp svg2png/*.png _build/html/_images/
netlify: netlify-dependencies netlify-api html copy-svg2png
2018-05-13 11:37:02 +02:00
2019-07-03 17:38:04 +02:00
lint: html-strict
2022-02-20 10:39:33 +01:00
python3 lint.py
2019-07-03 17:38:04 +02:00
2018-05-13 11:37:02 +02:00
# Catch-all target: route all unknown targets to Sphinx using the new
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
%: Makefile
sphinx-build -M $@ . _build $(O)