os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

build: remove generate target, split run out

Browse source 
This ensures that `make all` will never try to run the internal server.
Instead, the user can run it manually if they need to.

Reviewed-by:	gjb, hrs
Differential-Revision:	https://reviews.freebsd.org/D28384
This commit is contained in:
Kyle Evans 2021-01-27 22:22:48 -06:00
parent 885316d9e8
commit 127d3f2965
2 changed files with 18 additions and 6 deletions
documentation
Makefile
website
Makefile

12
documentation/Makefile
View file

@ -6,7 +6,12 @@
# Targets intended for use on the command line # Targets intended for use on the command line
# #
# all (default) - generate the books TOC and compile all the documentation # all (default) - generate the books TOC and compile all the documentation
# generate - generate the books TOC and build all the documentation # run - serves the built documentation site for local browsing
#
# The run target uses hugo's built-in webserver to make the documentation site
# available for local browsing. The documentation should have been built prior
# to attempting to use the `run` target. By default, hugo will start its
# webserver on port 1313.
MAINTAINER=carlavilla@FreeBSD.org MAINTAINER=carlavilla@FreeBSD.org
@ -14,12 +19,13 @@ PYTHON_CMD = /usr/local/bin/python3.7
HUGO_CMD = /usr/local/bin/hugo HUGO_CMD = /usr/local/bin/hugo
LANGUAGES = en,es,pt-br,de,ja,zh-cn,zh-tw,ru,el,hu,it,mn,nl,pl,fr LANGUAGES = en,es,pt-br,de,ja,zh-cn,zh-tw,ru,el,hu,it,mn,nl,pl,fr
.ORDER: all run
.ORDER: starting-message generate-books-toc .ORDER: starting-message generate-books-toc
.ORDER: starting-message build .ORDER: starting-message build
.ORDER: generate-books-toc build .ORDER: generate-books-toc build
all: starting-message generate-books-toc run all: starting-message generate-books-toc build
generate: starting-message generate-books-toc build .PHONY
starting-message: .PHONY starting-message: .PHONY
@echo --------------------------------------------------------------- @echo ---------------------------------------------------------------

12
website/Makefile
View file

@ -6,19 +6,25 @@
# Targets intended for use on the command line # Targets intended for use on the command line
# #
# all (default) - generate the releases.toml and compile all the website # all (default) - generate the releases.toml and compile all the website
# generate - generate the releases.toml and build all the website # run - serves the built website for local browsing
#
# The run target uses hugo's built-in webserver to make the built website
# available for local browsing. The website should have been built prior
# to attempting to use the `run` target. By default, hugo will start its
# webserver on port 1313.
MAINTAINER=carlavilla@FreeBSD.org MAINTAINER=carlavilla@FreeBSD.org
PYTHON_CMD = /usr/local/bin/python3.7 PYTHON_CMD = /usr/local/bin/python3.7
HUGO_CMD = /usr/local/bin/hugo HUGO_CMD = /usr/local/bin/hugo
.ORDER: all run
.ORDER: starting-message generate-books-toc .ORDER: starting-message generate-books-toc
.ORDER: starting-message build .ORDER: starting-message build
.ORDER: generate-books-toc build .ORDER: generate-books-toc build
all: starting-message generate-releases run all: starting-message generate-releases build
generate: starting-message generate-releases build .PHONY
starting-message: .PHONY starting-message: .PHONY
@echo --------------------------------------------------------------- @echo ---------------------------------------------------------------