* [dpdk-stable] [PATCH 1/3] doc: robustify PDF build
[not found] <20190522202842.19818-1-thomas@monjalon.net>
@ 2019-05-22 20:28 ` Thomas Monjalon
2019-05-23 11:16 ` Mcnamara, John
2019-05-22 20:28 ` [dpdk-stable] [PATCH 2/3] doc: fix PDF with greek letter Thomas Monjalon
1 sibling, 1 reply; 4+ messages in thread
From: Thomas Monjalon @ 2019-05-22 20:28 UTC (permalink / raw)
To: dev, John McNamara, Marko Kovacevic; +Cc: stable
In some environment like the current dpdk.org server,
there can be some errors due to symbols in titles,
as it was the case before this commit in DPDK 18.05:
551d148944dc ("doc: remove flow API migration section")
! LaTeX Error: Bad math environment delimiter.
It can be avoided thanks to the Latex command \robustify.
Cc: stable@dpdk.org
Signed-off-by: Thomas Monjalon <thomas@monjalon.net>
---
doc/guides/conf.py | 3 +++
1 file changed, 3 insertions(+)
diff --git a/doc/guides/conf.py b/doc/guides/conf.py
index a85f6c9d9..6d5001a07 100644
--- a/doc/guides/conf.py
+++ b/doc/guides/conf.py
@@ -67,6 +67,9 @@
\usepackage{helvet}
\renewcommand{\familydefault}{\sfdefault}
\RecustomVerbatimEnvironment{Verbatim}{Verbatim}{xleftmargin=5mm}
+\usepackage{etoolbox}
+\robustify\(
+\robustify\)
"""
# Configuration for the latex/pdf docs.
--
2.21.0
^ permalink raw reply [flat|nested] 4+ messages in thread
* [dpdk-stable] [PATCH 2/3] doc: fix PDF with greek letter
[not found] <20190522202842.19818-1-thomas@monjalon.net>
2019-05-22 20:28 ` [dpdk-stable] [PATCH 1/3] doc: robustify PDF build Thomas Monjalon
@ 2019-05-22 20:28 ` Thomas Monjalon
2019-05-23 11:16 ` Mcnamara, John
1 sibling, 1 reply; 4+ messages in thread
From: Thomas Monjalon @ 2019-05-22 20:28 UTC (permalink / raw)
To: dev, John McNamara, Marko Kovacevic; +Cc: stable
For an unknown reason, the sign "μ" is not accepted by some environments,
probably due to the version of some Latex packages or dependencies.
! Package inputenc Error: Unicode character μ (U+03BC)
(inputenc) not set up for use with LaTeX.
It is fixed by installing texlive-langgreek.
Fixes: d0dff9ba445e ("doc: sample application user guide")
Cc: stable@dpdk.org
Signed-off-by: Thomas Monjalon <thomas@monjalon.net>
---
doc/guides/conf.py | 1 +
doc/guides/contributing/documentation.rst | 4 ++--
2 files changed, 3 insertions(+), 2 deletions(-)
diff --git a/doc/guides/conf.py b/doc/guides/conf.py
index 6d5001a07..94b97dc35 100644
--- a/doc/guides/conf.py
+++ b/doc/guides/conf.py
@@ -64,6 +64,7 @@
custom_latex_preamble = r"""
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
+\usepackage{textalpha}
\usepackage{helvet}
\renewcommand{\familydefault}{\sfdefault}
\RecustomVerbatimEnvironment{Verbatim}{Verbatim}{xleftmargin=5mm}
diff --git a/doc/guides/contributing/documentation.rst b/doc/guides/contributing/documentation.rst
index 9d381919b..27e4b13be 100644
--- a/doc/guides/contributing/documentation.rst
+++ b/doc/guides/contributing/documentation.rst
@@ -199,10 +199,10 @@ The main required packages can be installed as follows:
.. code-block:: console
# Ubuntu/Debian.
- sudo apt-get -y install texlive-latex-extra
+ sudo apt-get -y install texlive-latex-extra texlive-lang-greek
# Red Hat/Fedora, selective install.
- sudo dnf -y install texlive-collection-latexextra
+ sudo dnf -y install texlive-collection-latexextra texlive-greek-fontenc
`Latexmk <http://personal.psu.edu/jcc8/software/latexmk-jcc/>`_ is a perl script
for running LaTeX for resolving cross references,
--
2.21.0
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [dpdk-stable] [PATCH 1/3] doc: robustify PDF build
2019-05-22 20:28 ` [dpdk-stable] [PATCH 1/3] doc: robustify PDF build Thomas Monjalon
@ 2019-05-23 11:16 ` Mcnamara, John
0 siblings, 0 replies; 4+ messages in thread
From: Mcnamara, John @ 2019-05-23 11:16 UTC (permalink / raw)
To: Thomas Monjalon, dev, Kovacevic, Marko; +Cc: stable
> -----Original Message-----
> From: Thomas Monjalon [mailto:thomas@monjalon.net]
> Sent: Wednesday, May 22, 2019 9:29 PM
> To: dev@dpdk.org; Mcnamara, John <john.mcnamara@intel.com>; Kovacevic,
> Marko <marko.kovacevic@intel.com>
> Cc: stable@dpdk.org
> Subject: [PATCH 1/3] doc: robustify PDF build
>
> In some environment like the current dpdk.org server, there can be some
> errors due to symbols in titles, as it was the case before this commit in
> DPDK 18.05:
> 551d148944dc ("doc: remove flow API migration section")
>
> ! LaTeX Error: Bad math environment delimiter.
>
> It can be avoided thanks to the Latex command \robustify.
>
Acked-by: John McNamara <john.mcnamara@intel.com>
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [dpdk-stable] [PATCH 2/3] doc: fix PDF with greek letter
2019-05-22 20:28 ` [dpdk-stable] [PATCH 2/3] doc: fix PDF with greek letter Thomas Monjalon
@ 2019-05-23 11:16 ` Mcnamara, John
0 siblings, 0 replies; 4+ messages in thread
From: Mcnamara, John @ 2019-05-23 11:16 UTC (permalink / raw)
To: Thomas Monjalon, dev, Kovacevic, Marko; +Cc: stable
> -----Original Message-----
> From: Thomas Monjalon [mailto:thomas@monjalon.net]
> Sent: Wednesday, May 22, 2019 9:29 PM
> To: dev@dpdk.org; Mcnamara, John <john.mcnamara@intel.com>; Kovacevic,
> Marko <marko.kovacevic@intel.com>
> Cc: stable@dpdk.org
> Subject: [PATCH 2/3] doc: fix PDF with greek letter
>
> For an unknown reason, the sign "μ" is not accepted by some environments,
> probably due to the version of some Latex packages or dependencies.
>
> ! Package inputenc Error: Unicode character μ (U+03BC)
> (inputenc) not set up for use with LaTeX.
>
> It is fixed by installing texlive-langgreek.
>
Acked-by: John McNamara <john.mcnamara@intel.com>
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2019-05-23 11:18 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
[not found] <20190522202842.19818-1-thomas@monjalon.net>
2019-05-22 20:28 ` [dpdk-stable] [PATCH 1/3] doc: robustify PDF build Thomas Monjalon
2019-05-23 11:16 ` Mcnamara, John
2019-05-22 20:28 ` [dpdk-stable] [PATCH 2/3] doc: fix PDF with greek letter Thomas Monjalon
2019-05-23 11:16 ` Mcnamara, John
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).