Re: [PATCH RFC v2 3/9] docs-rst: Don't mangle with UTF-8 chars on LaTeX/PDF output

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Am 15.08.2016 um 23:21 schrieb Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxxxxx>:

> pdflatex doesn't accept using some UTF-8 chars, like
> "equal or less than" or "equal or greater than" chars. However,
> the media documents use them. So, we need to use XeLaTeX for
> conversion, and a font that accepts such characters.

Right, we should use the XeLaTeX engine. But ...

Sphinx LaTeX output was/is developed for LaTeX, not for XeLaTeX.
E.g. in its defaults it uses "inputenc" and other stuff which
is not a part of XeLaTeX.

* https://github.com/sphinx-doc/sphinx/issues/894#issuecomment-220786426

This patch removes the "inputenc", thats right, but I think over
short/long term we will see more errors related to LaTeX/XeLaTeX
distinction. And we will see that some conversion will break, depending
on the sphinx version we use (There might be some non XeLateX friendly 
changes in the sphinx-versions, since it is not tested with XeLaTeX).

   Nevertheless, XeLaTeX is the right choice!

My Suggestion is, that you merge this patch on top of Jon's doc-next. 
There, we have the sub-folders feature, with we can test book by book
and improve our toolchain.

-- Markus --


> 
> Signed-off-by: Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxxxxx>
> ---
> Documentation/Makefile.sphinx |  6 +++---
> Documentation/conf.py         | 11 +++++++++++
> 2 files changed, 14 insertions(+), 3 deletions(-)
> 
> diff --git a/Documentation/Makefile.sphinx b/Documentation/Makefile.sphinx
> index fc29e08085aa..aa7ff32be589 100644
> --- a/Documentation/Makefile.sphinx
> +++ b/Documentation/Makefile.sphinx
> @@ -26,7 +26,7 @@ else ifneq ($(DOCBOOKS),)
> else # HAVE_SPHINX
> 
> # User-friendly check for pdflatex
> -HAVE_PDFLATEX := $(shell if which pdflatex >/dev/null 2>&1; then echo 1; else echo 0; fi)
> +HAVE_PDFLATEX := $(shell if which xelatex >/dev/null 2>&1; then echo 1; else echo 0; fi)
> 
> # Internal variables.
> PAPEROPT_a4     = -D latex_paper_size=a4
> @@ -45,11 +45,11 @@ htmldocs:
> 
> pdfdocs:
> ifeq ($(HAVE_PDFLATEX),0)
> -	$(warning The 'pdflatex' command was not found. Make sure you have it installed and in PATH to produce PDF output.)
> +	$(warning The 'xelatex' command was not found. Make sure you have it installed and in PATH to produce PDF output.)
> 	@echo "  SKIP    Sphinx $@ target."
> else # HAVE_PDFLATEX
> 	$(call cmd,sphinx,latex)
> -	$(Q)$(MAKE) -C $(BUILDDIR)/latex
> +	$(Q)$(MAKE) PDFLATEX=xelatex -C $(BUILDDIR)/latex
> endif # HAVE_PDFLATEX
> 
> epubdocs:
> diff --git a/Documentation/conf.py b/Documentation/conf.py
> index bbf2878d9945..f4469cd0340d 100644
> --- a/Documentation/conf.py
> +++ b/Documentation/conf.py
> @@ -260,6 +260,10 @@ latex_elements = {
> # Latex figure (float) alignment
> #'figure_align': 'htbp',
> 
> +# Don't mangle with UTF-8 chars
> +'inputenc': '',
> +'utf8extra': '',
> +
> # Additional stuff for the LaTeX preamble.
>     'preamble': '''
>         % Allow generate some pages in landscape
> @@ -287,6 +291,13 @@ latex_elements = {
>           \\end{graybox}
>         }
> 	\\makeatother
> +
> +	% Use some font with UTF-8 support with XeLaTeX
> +        \\usepackage{fontspec}
> +        \\setsansfont{DejaVu Serif}
> +        \\setromanfont{DejaVu Sans}
> +        \\setmonofont{DejaVu Sans Mono}
> +
>      '''
> }
> 
> -- 
> 2.7.4
> 
> 
> --
> To unsubscribe from this list: send the line "unsubscribe linux-media" in
> the body of a message to majordomo@xxxxxxxxxxxxxxx
> More majordomo info at  http://vger.kernel.org/majordomo-info.html

--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux