mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
0381bc170c
Replace docs build-site.py with default-ish sphinx build This seems to speed up docsite build _alot_. The Makefile.sphinx is the sphinx-quickstart generated makefile with a few changes. The CPUS env var or 'nproc' output is used for the number of cpus passed to 'sphinx-build -j'
49 lines
1.6 KiB
Makefile
49 lines
1.6 KiB
Makefile
SITELIB = $(shell python -c "from distutils.sysconfig import get_python_lib; print get_python_lib()")
|
|
FORMATTER=../../hacking/module_formatter.py
|
|
DUMPER=../../hacking/dump_playbook_attributes.py
|
|
CPUS := $(shell nproc)
|
|
|
|
all: clean docs
|
|
|
|
docs: clean directives modules htmldocs
|
|
-(cp *.ico htmlout/)
|
|
-(cp *.jpg htmlout/)
|
|
-(cp *.png htmlout/)
|
|
|
|
variables:
|
|
(mkdir -p htmlout/)
|
|
dot variables.dot -Tpng -o htmlout/variables.png
|
|
|
|
htmldocs: directives modules staticmin
|
|
CPUS=$(CPUS) $(MAKE) -f Makefile.sphinx html
|
|
|
|
webdocs: htmldocs
|
|
|
|
clean:
|
|
-rm -rf htmlout
|
|
-rm -rf _build
|
|
-rm -f .buildinfo
|
|
-rm -f *.inv
|
|
-rm -rf *.doctrees
|
|
@echo "Cleaning up minified css files"
|
|
find . -type f -name "*.min.css" -delete
|
|
@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
|
|
|
|
.PHONEY: docs clean
|
|
|
|
directives: $(FORMATTER) ../../hacking/templates/rst.j2
|
|
PYTHONPATH=../../lib $(DUMPER) --template-dir=../../hacking/templates --output-dir=rst/
|
|
|
|
modules: $(FORMATTER) ../../hacking/templates/rst.j2
|
|
PYTHONPATH=../../lib $(FORMATTER) -t rst --template-dir=../../hacking/templates --module-dir=../../lib/ansible/modules -o rst/
|
|
|
|
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
|