From 8bb22181ffabec3d47dbd7c861b184c9d83a6028 Mon Sep 17 00:00:00 2001 From: hasheddan Date: Mon, 5 Dec 2022 17:27:07 -0500 Subject: [PATCH] Separate docs generation from running locally Updates docs machinery to be able to symlink when running locally but copy fully when generating for publish. Signed-off-by: hasheddan --- makelib/docs.mk | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/makelib/docs.mk b/makelib/docs.mk index 9a5fe7c..3d46edb 100644 --- a/makelib/docs.mk +++ b/makelib/docs.mk @@ -38,18 +38,25 @@ DOCS_VERSION_DIR := $(DOCS_WORK_DIR)/$(DEST_DOCS_DIR)/$(DOCS_VERSION) # ==================================================================================== # Targets -docs.generate: +docs.init: rm -rf $(DOCS_WORK_DIR) mkdir -p $(DOCS_WORK_DIR) git clone --depth=1 -b master $(DOCS_GIT_REPO) $(DOCS_WORK_DIR) + +docs.generate: docs.init rm -rf $(DOCS_VERSION_DIR) @if [ "$(DOCS_VERSION_ACTIVE)" == "true" ]; then \ $(INFO) Including version in documentation ; \ - ln -s $(ROOT_DIR)/$(SOURCE_DOCS_DIR) $(DOCS_VERSION_DIR); \ + cp -r $(SOURCE_DOCS_DIR)/ $(DOCS_VERSION_DIR); \ $(OK) Version included in documentation ; \ fi -docs.run: docs.generate +docs.run: docs.init + @if [ "$(DOCS_VERSION_ACTIVE)" == "true" ]; then \ + $(INFO) Including version in documentation ; \ + ln -s $(ROOT_DIR)/$(SOURCE_DOCS_DIR) $(DOCS_VERSION_DIR); \ + $(OK) Version included in documentation ; \ + fi cd $(DOCS_WORK_DIR) && DOCS_VERSION=$(DOCS_VERSION) $(MAKE) run docs.validate: docs.generate