8750cad450
Currently '/usr/local/bin/python3.7' is used as the value of PYTHON_CMD. Right now this works because 3.7 is the default version of Python 3 in the ports tree. However, at some point in the future, this will be undoubtedly be changed. It is also possible that users already might be building versions newer than the default port/package, which needs to be an supported as well. In addition, the FDP recommends installing the 'python3' package. This meta port/package depends on the default version of python, and automatically creates a symlink to the default version. With all this in mind, use '/usr/local/bin/python3' is used as the value of PYTHON_CMD, since this means that the instructions will work irrespective of which version is assigned.
53 lines
1.7 KiB
Makefile
53 lines
1.7 KiB
Makefile
# Generate the FreeBSD documentation
|
|
#
|
|
# Copyright (c) 2020-2021, The FreeBSD Documentation Project
|
|
# Copyright (c) 2020-2021, Sergio Carlavilla <carlavilla@FreeBSD.org>
|
|
#
|
|
# Targets intended for use on the command line
|
|
#
|
|
# all (default) - generate the books TOC and compile 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
|
|
|
|
PYTHON_CMD = /usr/local/bin/python3
|
|
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
|
|
|
|
.ifndef HOSTNAME
|
|
.HOST+=localhost
|
|
.else
|
|
.HOST+=$(HOSTNAME)
|
|
.endif
|
|
|
|
.ORDER: all run
|
|
|
|
.ORDER: starting-message generate-books-toc
|
|
.ORDER: starting-message build
|
|
.ORDER: generate-books-toc build
|
|
|
|
all: starting-message generate-books-toc build
|
|
run: starting-message generate-books-toc run-local
|
|
|
|
starting-message: .PHONY
|
|
@echo ---------------------------------------------------------------
|
|
@echo Building the documentation
|
|
@echo ---------------------------------------------------------------
|
|
|
|
generate-books-toc: .PHONY
|
|
${PYTHON_CMD} ./tools/books-toc-parts-creator.py -l ${LANGUAGES}
|
|
${PYTHON_CMD} ./tools/books-toc-creator.py -l ${LANGUAGES}
|
|
${PYTHON_CMD} ./tools/books-toc-figures-creator.py -l ${LANGUAGES}
|
|
${PYTHON_CMD} ./tools/books-toc-tables-creator.py -l ${LANGUAGES}
|
|
${PYTHON_CMD} ./tools/books-toc-examples-creator.py -l ${LANGUAGES}
|
|
|
|
run-local: .PHONY
|
|
${HUGO_CMD} server -D --baseURL="http://$(.HOST):1313"
|
|
|
|
build: .PHONY
|
|
${HUGO_CMD} --minify
|