Separate conda and sphinx build directories

Signed-off-by: Robert Winkler <rwinkler@antmicro.com>
This commit is contained in:
Robert Winkler 2020-02-25 14:46:16 +01:00
parent 66f1f88e70
commit e9fb41f322
1 changed files with 10 additions and 3 deletions

View File

@ -6,7 +6,7 @@ SPHINXOPTS =
CMDS = cd source/prjxray/docs && make links && cd - && CMDS = cd source/prjxray/docs && make links && cd - &&
SPHINXBUILD = $(CMDS) sphinx-build SPHINXBUILD = $(CMDS) sphinx-build
PAPER = PAPER =
BUILDDIR = build BUILDDIR = build/sphinx
# Internal variables. # Internal variables.
PAPEROPT_a4 = -D latex_paper_size=a4 PAPEROPT_a4 = -D latex_paper_size=a4
@ -16,6 +16,8 @@ ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) sou
CONDA_DIR = build/conda CONDA_DIR = build/conda
CONDA_ENV_FILE = environment.yml CONDA_ENV_FILE = environment.yml
DOXYGEN_DIR = build/doxygen
.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp epub latex latexpdf text man changes linkcheck doctest env .PHONY: help clean html dirhtml singlehtml pickle json htmlhelp epub latex latexpdf text man changes linkcheck doctest env
help: help:
@ -35,9 +37,11 @@ help:
@echo " linkcheck to check all external links for integrity" @echo " linkcheck to check all external links for integrity"
@echo " doctest to run all doctests embedded in the documentation (if enabled)" @echo " doctest to run all doctests embedded in the documentation (if enabled)"
@echo " env to create a conda environment with the needed packages" @echo " env to create a conda environment with the needed packages"
@echo " env-clean to remove the conda environment"
clean: clean:
-rm -rf $(BUILDDIR)/* -rm -rf $(BUILDDIR)/
-rm -rf $(DOXYGEN_DIR)/
html: html:
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
@ -118,7 +122,7 @@ doctest:
env: env:
@rm -rf $(CONDA_DIR) @rm -rf $(CONDA_DIR)
@mkdir -p $(BUILDDIR) && mkdir -p $(CONDA_DIR) @mkdir -p $(CONDA_DIR)
@wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh\ @wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh\
-O $(CONDA_DIR)/miniconda.sh -O $(CONDA_DIR)/miniconda.sh
@bash $(CONDA_DIR)/miniconda.sh -f -b -p $(CONDA_DIR) > /dev/null &&\ @bash $(CONDA_DIR)/miniconda.sh -f -b -p $(CONDA_DIR) > /dev/null &&\
@ -126,3 +130,6 @@ env:
@./$(CONDA_DIR)/bin/conda env create -q -f $(CONDA_ENV_FILE) > /dev/null &&\ @./$(CONDA_DIR)/bin/conda env create -q -f $(CONDA_ENV_FILE) > /dev/null &&\
echo "Conda packages installed successfully..." echo "Conda packages installed successfully..."
@echo "To use conda environment type:\nsource enter-env.sh" @echo "To use conda environment type:\nsource enter-env.sh"
env-clean:
@rm -rf $(CONDA_DIR)