CSIT-618 Add LaTeX support to release report

- Add option to generate PDF from release report.
- Conditional content
- Static plot conversion

Change-Id: I7c4f0b41898791d1cab446d0fc3b07220380e1b8
Signed-off-by: Peter Mikus <pmikus@cisco.com>

1 files changed, 80 insertions, 8 deletions

diff --git a/docs/report/dpdk_performance_tests/packet_throughput_graphs/l2.rst b/docs/report/dpdk_performance_tests/packet_throughput_graphs/l2.rst
index eb3be14af1..b63a12f3ad 100644
--- a/docs/report/dpdk_performance_tests/packet_throughput_graphs/l2.rst
+++ b/docs/report/dpdk_performance_tests/packet_throughput_graphs/l2.rst
@@ -17,14 +17,32 @@ in the graph below.
 
     <iframe width="700" height="1000" frameborder="0" scrolling="no" src="../../_static/dpdk/64B-1t1c-l2-ndrdisc.html"></iframe>
 
+.. raw:: latex
+
+    \begin{figure}[H]
+        \centering
+            \graphicspath{{../_build/_static/dpdk/}}
+            \includegraphics[clip, trim=0cm 8cm 5cm 0cm, width=0.70\textwidth]{64B-1t1c-l2-ndrdisc}
+            \label{fig:64B-1t1c-l2-ndrdisc-dpdk}
+    \end{figure}
+
 *Figure 1. Testpmd 1thread 1core - NDR Throughput for Phy-to-Phy L2 Ethernet
 Looping.*
 
 CSIT source code for the test cases used for above plots can be found in CSIT
 git repository:
 
-.. program-output:: cd ../../ && set -x && cd tests/dpdk/perf && grep -P '64B-1t1c-eth-l2xcbase-testpmd-ndrdisc' *
-   :shell:
+.. only:: html
+
+   .. program-output:: cd ../../ && set -x && cd tests/dpdk/perf && grep -P '64B-1t1c-eth-l2xcbase-testpmd-ndrdisc' *
+      :shell:
+
+.. only:: latex
+
+   .. code-block:: bash
+
+      $ cd tests/dpdk/perf
+      $ grep -P '64B-1t1c-eth-l2xcbase-testpmd-ndrdisc' *
 
 Testpmd NDR 64B packet throughput in 2t2c setup (2thread, 2core) is presented
 in the graph below.
@@ -33,14 +51,32 @@ in the graph below.
 
     <iframe width="700" height="1000" frameborder="0" scrolling="no" src="../../_static/dpdk/64B-2t2c-l2-ndrdisc.html"></iframe>
 
+.. raw:: latex
+
+    \begin{figure}[H]
+        \centering
+            \graphicspath{{../_build/_static/dpdk/}}
+            \includegraphics[clip, trim=0cm 8cm 5cm 0cm, width=0.70\textwidth]{64B-2t2c-l2-ndrdisc}
+            \label{fig:64B-2t2c-l2-ndrdisc-dpdk}
+    \end{figure}
+
 *Figure 2. Testpmd 2threads 2cores - NDR Throughput for Phy-to-Phy L2 Ethernet
 Looping.*
 
 CSIT source code for the test cases used for above plots can be found in CSIT
 git repository:
 
-.. program-output:: cd ../../ && set -x && cd tests/dpdk/perf && grep -P '64B-2t2c-eth-l2xcbase-testpmd-ndrdisc' *
-   :shell:
+.. only:: html
+
+   .. program-output:: cd ../../ && set -x && cd tests/dpdk/perf && grep -P '64B-2t2c-eth-l2xcbase-testpmd-ndrdisc' *
+      :shell:
+
+.. only:: latex
+
+   .. code-block:: bash
+
+      $ cd tests/dpdk/perf
+      $ grep -P '64B-2t2c-eth-l2xcbase-testpmd-ndrdisc' *
 
 PDR Throughput
 ~~~~~~~~~~~~~~
@@ -52,14 +88,32 @@ in the graph below. PDR measured for 0.5% packet loss ratio.
 
     <iframe width="700" height="1000" frameborder="0" scrolling="no" src="../../_static/dpdk/64B-1t1c-l2-pdrdisc.html"></iframe>
 
+.. raw:: latex
+
+    \begin{figure}[H]
+        \centering
+            \graphicspath{{../_build/_static/dpdk/}}
+            \includegraphics[clip, trim=0cm 8cm 5cm 0cm, width=0.70\textwidth]{64B-1t1c-l2-pdrdisc}
+            \label{fig:64B-1t1c-l2-pdrdisc-dpdk}
+    \end{figure}
+
 *Figure 3. Testpmd 1thread 1core - PDR Throughput for Phy-to-Phy L2 Ethernet
 Looping.*
 
 CSIT source code for the test cases used for above plots can be found in CSIT
 git repository:
 
-.. program-output:: cd ../../ && set -x && cd tests/dpdk/perf && grep -P '64B-1t1c-eth-l2xcbase-testpmd-pdrdisc' *
-   :shell:
+.. only:: html
+
+   .. program-output:: cd ../../ && set -x && cd tests/dpdk/perf && grep -P '64B-1t1c-eth-l2xcbase-testpmd-pdrdisc' *
+      :shell:
+
+.. only:: latex
+
+   .. code-block:: bash
+
+      $ cd tests/dpdk/perf
+      $ grep -P '64B-1t1c-eth-l2xcbase-testpmd-pdrdisc' *
 
 Testpmd PDR 64B packet throughput in 2t2c setup (2thread, 2core) is presented
 in the graph below. PDR measured for 0.5% packet loss ratio.
@@ -68,11 +122,29 @@ in the graph below. PDR measured for 0.5% packet loss ratio.
 
     <iframe width="700" height="1000" frameborder="0" scrolling="no" src="../../_static/dpdk/64B-2t2c-l2-pdrdisc.html"></iframe>
 
+.. raw:: latex
+
+    \begin{figure}[H]
+        \centering
+            \graphicspath{{../_build/_static/dpdk/}}
+            \includegraphics[clip, trim=0cm 8cm 5cm 0cm, width=0.70\textwidth]{64B-2t2c-l2-pdrdisc}
+            \label{fig:64B-2t2c-l2-pdrdisc-dpdk}
+    \end{figure}
+
 *Figure 4. Testpmd 2thread 2core - PDR Throughput for Phy-to-Phy L2 Ethernet
 Looping.*
 
 CSIT source code for the test cases used for above plots can be found in CSIT
 git repository:
 
-.. program-output:: cd ../../ && set -x && cd tests/dpdk/perf && grep -P '64B-2t2c-eth-l2xcbase-testpmd-pdrdisc' *
-   :shell:
+.. only:: html
+
+   .. program-output:: cd ../../ && set -x && cd tests/dpdk/perf && grep -P '64B-2t2c-eth-l2xcbase-testpmd-pdrdisc' *
+      :shell:
+
+.. only:: latex
+
+   .. code-block:: bash
+
+      $ cd tests/dpdk/perf
+      $ grep -P '64B-2t2c-eth-l2xcbase-testpmd-pdrdisc' *