Changeset View
Changeset View
Standalone View
Standalone View
documentation/Makefile
Context not available. | |||||
# 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 | ||||
# clean - removes generated files | |||||
# run - serves the built documentation site for local browsing | # run - serves the built documentation site for local browsing | ||||
# pdf - build PDF versions of the articles and books. | # pdf - build PDF versions of the articles and books. | ||||
# | # | ||||
Context not available. | |||||
all: requirements starting-message generate-books-toc generate-pgpkeys-txt build | all: requirements starting-message generate-books-toc generate-pgpkeys-txt build | ||||
run: requirements starting-message generate-books-toc generate-pgpkeys-txt run-local | run: requirements starting-message generate-books-toc generate-pgpkeys-txt run-local | ||||
# clean does not call pdf-clean as that is a subset of hugo-clean | |||||
clean: hugo-clean pgp-clean toc-clean | |||||
requirements: | requirements: | ||||
.for dep in ${RUN_DEPENDS} | .for dep in ${RUN_DEPENDS} | ||||
.if !exists(${dep}) | .if !exists(${dep}) | ||||
Context not available. | |||||
build: .PHONY | build: .PHONY | ||||
${HUGO_CMD} ${HUGO_ARGS} | ${HUGO_CMD} ${HUGO_ARGS} | ||||
toc-clean: .PHONY | |||||
rm -f $$(${PYTHON_CMD} ./tools/books-toc-parts-creator.py -l ${BOOK_LANGS} -o) | |||||
rm -f $$(${PYTHON_CMD} ./tools/books-toc-creator.py -l ${BOOK_LANGS} -o) | |||||
rm -f $$(${PYTHON_CMD} ./tools/books-toc-figures-creator.py -l ${BOOK_LANGS} -o) | |||||
rm -f $$(${PYTHON_CMD} ./tools/books-toc-tables-creator.py -l ${BOOK_LANGS} -o) | |||||
rm -f $$(${PYTHON_CMD} ./tools/books-toc-examples-creator.py -l ${BOOK_LANGS} -o) | |||||
pgp-clean: .PHONY | |||||
rm -f static/pgpkeys/pgpkeys.txt | |||||
hugo-clean: .PHONY | |||||
rm -rf resources public | |||||
# | # | ||||
# PDF targets | # PDF targets | ||||
# Use DOC_LANG to choose the language, e.g., make DOC_LANG="en fr" pdf-books | # Use DOC_LANG to choose the language, e.g., make DOC_LANG="en fr" pdf-books | ||||
Context not available. | |||||
pdf-clean: pdf-articles-clean pdf-books-clean | pdf-clean: pdf-articles-clean pdf-books-clean | ||||
pdf-books-clean: pdf-books-target | pdf-books-clean: pdf-books-target toc-clean | ||||
.for _curpdf in ${BOOKSDIR} | .for _curpdf in ${BOOKSDIR} | ||||
rm -f ${.CURDIR}/public${_curpdf:S|^${.CURDIR}/content||}book.pdf ${_curpdf}toc*.adoc | rm -f ${.CURDIR}/public${_curpdf:S|^${.CURDIR}/content||}book.pdf | ||||
rm -fr ${.CURDIR}/public${_curpdf:S|^${.CURDIR}/content||} | |||||
.endfor | .endfor | ||||
.for _lang in ${LANGUAGES:S|,| |g} | .for _lang in ${LANGUAGES:S|,| |g} | ||||
rm -fr ${.CURDIR}/public/${_lang}/books | rm -fr ${.CURDIR}/public/${_lang}/books | ||||
Context not available. | |||||
pdf-articles-clean: pdf-articles-target | pdf-articles-clean: pdf-articles-target | ||||
.for _curpdf in ${ARTICLESDIR} | .for _curpdf in ${ARTICLESDIR} | ||||
rm -f ${.CURDIR}/public${_curpdf:S|^${.CURDIR}/content||}article.pdf | rm -f ${.CURDIR}/public${_curpdf:S|^${.CURDIR}/content||}article.pdf | ||||
rm -fr ${.CURDIR}/public${_curpdf:S|^${.CURDIR}/content||} | |||||
.endfor | .endfor | ||||
.for _lang in ${LANGUAGES:S|,| |g} | .for _lang in ${LANGUAGES:S|,| |g} | ||||
rm -fr ${.CURDIR}/public/${_lang}/articles | rm -fr ${.CURDIR}/public/${_lang}/articles | ||||
Context not available. | |||||
rm -fr ${.CURDIR}/public; \ | rm -fr ${.CURDIR}/public; \ | ||||
fi; \ | fi; \ | ||||
fi | fi | ||||
Context not available. |