From d63d74735db44ab9593b17351a76b26848a9f3d2 Mon Sep 17 00:00:00 2001 From: jankovicn Date: Tue, 3 Aug 2021 14:49:41 +0200 Subject: [PATCH 1/3] updated makefile to build a pdf for operator guide --- documentation/operator-guide/Makefile | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/documentation/operator-guide/Makefile b/documentation/operator-guide/Makefile index 545d0b54..3124c38d 100644 --- a/documentation/operator-guide/Makefile +++ b/documentation/operator-guide/Makefile @@ -19,8 +19,19 @@ help: html-watch: @$(SPHINXAUTOBUILD) -i "$(BUILDDIR)/*" "$(SOURCEDIR)" "$(BUILDDIR)/html" $(SPHINXOPTS) $(O) +html: + @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) + +latexpdf: + @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) + gs -sDEVICE=pdfwrite -dPDFSETTINGS=/ebook -dPrinted=false -q -o _build/latex/View-Server_-_Operator-Guide_small.pdf _build/latex/View-Server_-_Operator-Guide.pdf + build: + # just do html and latexpdf combined @$(SPHINXMULTIBUILD) "$(SOURCEDIR)" "$(BUILDDIR)/html" + @$(SPHINXBUILD) -M latexpdf "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) + gs -sDEVICE=pdfwrite -dPDFSETTINGS=/ebook -dPrinted=false -q -o _build/latex/View-Server_-_Operator-Guide_small.pdf _build/latex/View-Server_-_Operator-Guide.pdf + rsync -rpE _build/latex/View-Server_-_Operator-Guide_small.pdf _build/html/View-Server_-_Operator-Guide.pdf # Catch-all target: route all unknown targets to Sphinx using the new # "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). -- GitLab From ff88dfef5fb170414a64ce68dd306f70bcc70a44 Mon Sep 17 00:00:00 2001 From: jankovicn Date: Tue, 3 Aug 2021 14:51:11 +0200 Subject: [PATCH 2/3] added link to pdf --- documentation/operator-guide/index.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/documentation/operator-guide/index.rst b/documentation/operator-guide/index.rst index 21443f7e..c582037b 100644 --- a/documentation/operator-guide/index.rst +++ b/documentation/operator-guide/index.rst @@ -4,7 +4,9 @@ View Server - Operator Guide ============================ -This is the documentation for operators of the View Server. The user documentation can +This is the documentation for operators of the View Server. The PDF format of this +documentation for the latest version is located +`here <../View-Server_-_Operator-Guide.pdf>`_. The user documentation can be found `here <../user/master/index.html>`_. View Server - Contents -- GitLab From a1380f36e1088f103afec1019c3cf937adc5e734 Mon Sep 17 00:00:00 2001 From: jankovicn Date: Tue, 10 Aug 2021 11:57:53 +0200 Subject: [PATCH 3/3] added simple navigation to docs --- .gitlab-ci.yml | 2 ++ documentation/index.html | 16 ++++++++++++++++ 2 files changed, 18 insertions(+) create mode 100644 documentation/index.html diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml index dca4e4bd..1e15bb4c 100644 --- a/.gitlab-ci.yml +++ b/.gitlab-ci.yml @@ -171,6 +171,7 @@ review-docs: - mv _build/html/ ../../public - cd ../user-guide && make build - mv _build/html/ ../../public/user + - cd ../ && cp index.html ../public/ artifacts: paths: - public @@ -216,6 +217,7 @@ pages: - mv _build/html/ ../../public - cd ../user-guide && make build - mv _build/html/ ../../public/user + - cd ../ && cp index.html ../public/ variables: LATEST_VERSION: 1.4.6 DOCS_VERSIONS: ($LATEST_VERSION|1.2.0|1.1.1|1.0.0) diff --git a/documentation/index.html b/documentation/index.html new file mode 100644 index 00000000..b76cce63 --- /dev/null +++ b/documentation/index.html @@ -0,0 +1,16 @@ + + + + + + + View Server Documentation + + +

View Server Documentation

+ + + -- GitLab