EOX GitLab Instance

Skip to content
Snippets Groups Projects
Commit d94bc6e0 authored by Lubomir Dolezal's avatar Lubomir Dolezal
Browse files

update makefile to sync html files and pdf with client/html

parent eb64efcc
Branches
Tags
No related merge requests found
......@@ -219,7 +219,7 @@ docker exec -it $(docker ps -qf "name=emg-pvs_renderer") mv Emergency.sqlite /ca
python3 -m pip install sphinx recommonmark sphinx-autobuild
```
## Generation
## Generate html and synchronize with client/html/user-guide
```bash
make html
......@@ -227,10 +227,12 @@ make html
# For watched html automatic building
make html-watch
# For pdf output
# For pdf output and sync it to client/html/
make latexpdf
# To shrink size of pdf
gs -sDEVICE=pdfwrite -dPDFSETTINGS=/ebook -dPrinted=false -q -o View-Server_-_User-Guide_small.pdf View-Server_-_User-Guide.pdf
# make latexpdf and make html combined
make build
```
The documentation is generated in the respective *_build/html* directory.
......
......@@ -8,6 +8,7 @@ SPHINXBUILD ?= sphinx-build
SPHINXAUTOBUILD ?= sphinx-autobuild
SOURCEDIR = .
BUILDDIR = _build
USERGUIDE_VERSION = v1.1.0
# Put it first so that "make" without argument is like "make help".
help:
......@@ -18,6 +19,28 @@ help:
html-watch:
@$(SPHINXAUTOBUILD) -i "$(BUILDDIR)/*" "$(SOURCEDIR)" "$(BUILDDIR)/html" $(SPHINXOPTS) $(O)
html:
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
rm -rf ../../client/html/user-guide/*
rsync -rpE _build/html/ ../../client/html/user-guide/
latexpdf:
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
gs -sDEVICE=pdfwrite -dPDFSETTINGS=/ebook -dPrinted=false -q -o _build/latex/View-Server_-_User-Guide_small.pdf _build/latex/View-Server_-_User-Guide.pdf
rm -f ../../client/html/View-Server_-_User-Guide*pdf
rsync -rpE _build/latex/View-Server_-_User-Guide_small.pdf ../../client/html/View-Server_-_User-Guide_"$(USERGUIDE_VERSION)".pdf
build:
# just do html and latexpdf combined
@$(SPHINXBUILD) -M html "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
rm -rf ../../client/html/user-guide/*
rsync -rpE _build/html/ ../../client/html/user-guide/
@$(SPHINXBUILD) -M latexpdf "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
gs -sDEVICE=pdfwrite -dPDFSETTINGS=/ebook -dPrinted=false -q -o _build/latex/View-Server_-_User-Guide_small.pdf _build/latex/View-Server_-_User-Guide.pdf
rm -f ../../client/html/View-Server_-_User-Guide*pdf
rsync -rpE _build/latex/View-Server_-_User-Guide_small.pdf ../../client/html/View-Server_-_User-Guide_"$(USERGUIDE_VERSION)".pdf
# Catch-all target: route all unknown targets to Sphinx using the new
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
%: Makefile
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment