Markus Zolliker fd0e762d18 doc: drop latex support, add pdf support
latexpdf fails with error message "Too deply nested".
We want to avoid reducing the nesting level of doc strings
in frappy.lib.classdoc (less nice output) or a level of
nesting in method doc strings.

- latex removed from Jenkinsfile
- added support for rst2pdf

Change-Id: Ieb3355ef506e636e7e43a726c68327e3b1154469
Reviewed-on: https://forge.frm2.tum.de/review/c/secop/frappy/+/32406
Tested-by: Jenkins Automated Tests <pedersen+jenkins@frm2.tum.de>
Reviewed-by: Enrico Faulhaber <enrico.faulhaber@frm2.tum.de>
Reviewed-by: Markus Zolliker <markus.zolliker@psi.ch>
2024-01-29 13:34:39 +01:00
..
2023-05-02 15:25:11 +02:00
2023-05-02 15:25:11 +02:00

This directory contains the necessary files for running tests inside a docker container.

The Dockerfile defines two images:
- base
  -> this is the image used for testing
- docs
  -> Include a latex install for sphinx pdf builds

(The following assumes you have a docker daemon running on your working computer)

To create the images:

  docker build --target <base|docs> --tag frappy_<base|docs>:latest .

To test images interactivly:
  docker run -u jenkins -i -t frappy<base|docs> /bin/bash

The Jenkinsfile uses this Dockerfile (only approved checked-in versions from master)
to build the images (a rebuild will only happen if the Dockerfile is changed as docker
 caches the images and build information) and  run the test suite inside the container.