ansible/docs/docsite/Makefile

72 lines
2.3 KiB
Makefile
Raw Normal View History

2017-01-20 05:11:53 +01:00
OS := $(shell uname -s)
SITELIB = $(shell python -c "from distutils.sysconfig import get_python_lib; print get_python_lib()"):
FORMATTER=../bin/plugin_formatter.py
TESTING_FORMATTER=../bin/testing_formatter.sh
DUMPER=../bin/dump_keywords.py
ifeq ($(shell echo $(OS) | egrep -ic 'Darwin|FreeBSD|OpenBSD|DragonFly'),1)
2017-01-20 05:09:55 +01:00
CPUS ?= $(shell sysctl hw.ncpu|awk '{print $$2}')
else
2017-01-20 05:09:55 +01:00
CPUS ?= $(shell nproc)
endif
2012-10-08 13:44:38 +02:00
assertrst:
ifndef rst
$(error specify document or pattern with rst=somefile.rst)
endif
all: docs
2012-10-08 13:44:38 +02:00
docs: clean htmldocs
htmldocs: testing keywords modules staticmin
CPUS=$(CPUS) $(MAKE) -f Makefile.sphinx html
2012-10-08 13:44:38 +02:00
webdocs: docs
2016-01-25 16:33:50 +01:00
#TODO: leaving htmlout removal for those having older versions, should eventually be removed also
2012-10-08 13:44:38 +02:00
clean:
2013-06-09 19:55:58 +02:00
-rm -rf htmlout
-rm -rf _build
2012-10-08 13:44:38 +02:00
-rm -f .buildinfo
-rm -f objects.inv
2012-10-08 13:44:38 +02:00
-rm -rf *.doctrees
@echo "Cleaning up minified css files"
find . -type f -name "*.min.css" -delete
2012-10-08 13:44:38 +02:00
@echo "Cleaning up byte compiled python stuff"
find . -regex ".*\.py[co]$$" -delete
@echo "Cleaning up editor backup files"
find . -type f \( -name "*~" -or -name "#*" \) -delete
find . -type f \( -name "*.swp" \) -delete
@echo "Cleaning up generated rst"
-rm rst/list_of_*.rst
-rm rst/*_by_category.rst
-rm rst/*_module.rst
2017-01-18 20:34:01 +01:00
-rm rst/playbooks_directives.rst
-rm rst/playbooks_keywords.rst
2012-10-08 13:44:38 +02:00
.PHONEY: docs clean
keywords: $(FORMATTER) ../templates/playbooks_keywords.rst.j2
PYTHONPATH=../../lib $(DUMPER) --template-dir=../templates --output-dir=rst/ -d ./keyword_desc.yml
modules: $(FORMATTER) ../templates/plugin.rst.j2
# Limit building of module documentation if requested.
ifdef MODULES
PYTHONPATH=../../lib $(FORMATTER) -t rst --template-dir=../templates --module-dir=../../lib/ansible/modules -o rst/ -l $(MODULES)
else
PYTHONPATH=../../lib $(FORMATTER) -t rst --template-dir=../templates --module-dir=../../lib/ansible/modules -o rst/
endif
2012-10-08 13:44:38 +02:00
testing:
$(TESTING_FORMATTER)
staticmin:
cat _themes/srtd/static/css/theme.css | sed -e 's/^[ ]*//g; s/[ ]*$$//g; s/\([:{;,]\) /\1/g; s/ {/{/g; s/\/\*.*\*\///g; /^$$/d' | sed -e :a -e '$$!N; s/\n\(.\)/\1/; ta' > _themes/srtd/static/css/theme.min.css
2017-05-01 19:40:49 +02:00
epub:
(CPUS=$(CPUS) make -f Makefile.sphinx epub)
htmlsingle: assertrst
sphinx-build -j $(CPUS) -b html -d _build/doctrees ./rst _build/html rst/$(rst)
@echo "Output is in _build/html/$(rst)"