Merge pull request #139 from argtable/build-add-docs-makefile-target

build: add the docs makefile target

Author: tomghuang

Makefile

@@ -33,6 +33,7 @@ DOCKER_CONTAINER_NAME := argtable3-builder-container
 
 BUILD_DIR             := build
 OUTPUT_DIR	          := output
+DOCS_DIR              := docs
 DOXYGEN_XML_DIR       := docs/source/xml
 DOCS_BUILD_DIR        := docs/build
 ARCHIVE_DIR           := .archive
@@ -80,7 +81,7 @@ Here are some <TAG_NAME> examples (use 'make taglist' to get all available tags)
 
 
 .PHONY: build-docker-image
-build-docker-image:
+build-docker-image: tools/Dockerfile
 	@if [ ! -f /.dockerenv ] && ! docker image inspect $(DOCKER_IMAGE_NAME) >/dev/null 2>&1; then \
 		docker build -f tools/Dockerfile -t $(DOCKER_IMAGE_NAME) .; \
 	fi
@@ -134,6 +135,16 @@ archive: build-docker-image co
 	"
 
 
+.PHONY: docs
+docs: build-docker-image
+	@$(DOCKER_CMD_PREFIX) bash -c "\
+		printf 'Generate documentation...\n' && \
+		pushd $(DOCS_DIR) && \
+		doxygen && \
+		make html \
+	"
+
+
 .PHONY: shell
 shell: build-docker-image
 	@if [ ! -f /.dockerenv ]; then \

tools/Dockerfile

@@ -39,6 +39,16 @@ RUN apt-get update && \
     tar \
     zip \
     dos2unix \
+    doxygen \
+    python3 \
+    python3-pip \
+    python3-venv \
     && rm -rf /var/lib/apt/lists/*
 
+RUN python3 -m venv /opt/venv && \
+    /opt/venv/bin/pip install --upgrade pip && \
+    /opt/venv/bin/pip install sphinx furo breathe myst-parser
+
+ENV PATH="/opt/venv/bin:$PATH"
+
 WORKDIR /workdir