Makefile

# Makefile for Sphinx documentation

# You can set these variables from the command line.
SPHINXOPTS    =
SPHINXBUILD   = sphinx-build
BUILDDIR      = _build
export FORCE_COLOR   = 1

# User-friendly check for sphinx-build
ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
	$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don\'t have Sphinx installed, grab it from http://sphinx-doc.org/)
endif

ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(SPHINXOPTS) .
TESTOPTS = -W --keep-going -n -E -q -d $(BUILDDIR)/doctrees $(SPHINXOPTS) .

.PHONY: help
help:
	@echo "Please use \`make <target>' where <target> is one of"
	@echo "  clean      to remove previous builds (cleans cache)"
	@echo "  html       to make standalone HTML files"
	@echo "  livehtml   to load the docs in a local server"

.PHONY: clean
clean:
	@echo
	@echo "Cleaning up files..."
	@rm -f $(BUILDDIR)/.DS_Store
	@rm -f $(BUILDDIR)/html/.DS_Store
	@rm -rf $(BUILDDIR)/*
	@echo "Old files removed..."

.PHONY: html
html:
	@echo "Building the MINIFY Files..."
	@echo 
	pip3 install cssmin
	pip3 install jsmin
	python3 _ext/assetminify.py
	@echo
	@echo "*****************************************************"
	@echo "        Building Splunk Observability Docs"
	@echo "*****************************************************"
	@echo
	@echo "Building the HTML files from source..."
	@echo
	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
	@echo
	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."

.PHONY: json
json:
	@echo "Building the MINIFY Files..."
	@echo
	@echo "*****************************************************"
	@echo "     Building Splunk Observability Docs (JSON)       "
	@echo "*****************************************************"
	@echo
	@echo "Building the JSON files from source..."
	@echo
	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
	@echo
	@echo "Build finished. The JSON files are in $(BUILDDIR)/json."

.PHONY: xml
xml:
	@echo "Building the MINIFY Files..."
	@echo
	@echo "*****************************************************"
	@echo "     Building Splunk Observability Docs (XML)        "
	@echo "*****************************************************"
	@echo
	@echo "Building the XML files from source..."
	@echo
	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
	@echo
	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."

.PHONY: html-ja
html-ja:
	@echo "Building the MINIFY Files for Japanese documentation..."
	@echo
	pip3 install cssmin
	pip3 install jsmin
	python3 _ext/assetminify.py
	@echo
	@echo "*****************************************************"
	@echo "        Building Japanese Splunk Observability Docs"
	@echo "*****************************************************"
	@echo
	@echo "Building the Japanese HTML files from source..."
	$(SPHINXBUILD) -b html -D language=ja_JA . $(BUILDDIR)/html/ja_JA
	@echo
	@echo "Build finished. The Japanese HTML pages are in $(BUILDDIR)/html/ja_JA."

.PHONY: livehtml
livehtml:
	@echo
	@echo "*****************************************************"
	@echo "  Running live server for Splunk Observability Docs"
	@echo "*****************************************************"
	@echo
	@echo "Starting the live server..."
	@echo
	@sphinx-autobuild "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) --host 0.0.0.0 --port 8888 --ignore /docs/_static/main.min.css  --ignore /docs/_static/main.min.js

.PHONY: test
test: 
	@echo
	@echo "*****************************************************"
	@echo "       Testing Splunk Observability Docs build       "
	@echo "*****************************************************"
	@echo
	@echo "Testing the docs..."
	@echo
	@sphinx-build -b dummy $(TESTOPTS) $(BUILDDIR)/html

.PHONY: linkcheck
linkcheck:
	@echo
	@echo "*****************************************************"
	@echo "       Checking Splunk Observability Docs links      "
	@echo "*****************************************************"
	@echo
	@echo "Checking links..."
	@echo
	@sphinx-build -b linkcheck $(TESTOPTS) $(BUILDDIR)/linkcheck
	@echo
	@echo "Link check complete; look for any errors in the above output " \
	      "or in $(BUILDDIR)/linkcheck/output.txt."