Mercurial > repos > public > sbplib_julia
diff Makefile @ 858:5088de9b6d65
Merge feature/setup_documenter
author | Jonatan Werpers <jonatan@werpers.com> |
---|---|
date | Wed, 19 Jan 2022 07:24:36 +0100 |
parents | c9e35f1ca269 |
children | c8d6580d9307 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Makefile Wed Jan 19 07:24:36 2022 +0100 @@ -0,0 +1,54 @@ +JULIA_DEFAULT=julia --startup-file=no +JULIA?=$(JULIA_DEFAULT) + +# Set the default browser +WHICH_XDG_OPEN=$(shell which xdg-open) +WHICH_OPEN=$(shell which open) +BROWSER_DEFAULT = $(if $(WHICH_XDG_OPEN), xdg-open) +BROWSER_DEFAULT := $(if $(BROWSER_DEFAULT), $(BROWSER_DEFAULT), open) +BROWSER?=$(BROWSER_DEFAULT) + +help: + @echo 'Targets:' + @echo ' help - Show this help.' + @echo ' docs - Generate docs for webserver deployment.' + @echo ' localdocs - Generate docs for local viewing.' + @echo ' opendocs - Open documentation in the browser remaking it if necessary.' + @echo '' + @echo 'Variables:' + @echo ' JULIA - Controls which command is used to run julia' + @echo ' Default $(JULIA_DEFAULT)' + @echo ' BROWSER - Sets the command for how to open html files' + @echo ' Default: xdg-open if it exists otherwise open' + @echo '' + @echo 'Variables can be set on the commandline using the -e flag for make, e.g.' + @echo ' make localdocs -e JULIA=path/to/julia' + @echo 'or as shell environment variables.' + +docs: docs/build + +localdocs: docs/build-local + +opendocs: localdocs + $(BROWSER) docs/build-local/index.html + +clean: + rm -rf docs/build + rm -rf docs/build-local + +.PHONY: help docs localdocs opendocs clean + +SRC_DIRS = src docs/src +SRC_FILES_AND_DIRS = $(foreach dir,$(SRC_DIRS),$(shell find $(dir))) +DEP_IGNORE = %/.DS_Store +DOCS_DEPENDENCIES = docs/make.jl $(filter-out $(DEP_IGNORE),$(SRC_FILES_AND_DIRS)) +docs/build: $(DOCS_DEPENDENCIES) + $(JULIA) --project=docs docs/make.jl --build-dir build --prettyurls + +docs/build-local: $(DOCS_DEPENDENCIES) + $(JULIA) --project=docs docs/make.jl --build-dir build-local + + +.PHONY: temp +temp: + @echo $(SRC_FILES_AND_DIRS)