Em Mon, 7 Nov 2016 09:05:05 -0800 Josh Triplett <josh@xxxxxxxxxxxxxxxx> escreveu: > On Mon, Nov 07, 2016 at 09:46:48AM -0200, Mauro Carvalho Chehab wrote: > > That's said, PNG also doesn't seem to work fine on Sphinx 1.4.x. > > > > On my tests, I installed *all* texlive extensions on Fedora 24, to > > be sure that the issue is not the lack of some extension[1], with: > > > > # dnf install $(sudo dnf search texlive |grep all|cut -d. -f 1|grep texlive-) > > > > When running LaTeX in interactive mode, building just the media > > PDF file with: > > > > $ cls;make cleandocs; make SPHINXOPTS="-j5" DOCBOOKS="" SPHINXDIRS=media latexdocs > > $ PDFLATEX=xelatex LATEXOPTS="-interaction=interactive" -C Documentation/output/media/latex > > > > I get this: > > > > LaTeX Warning: Hyper reference `uapi/v4l/subdev-formats:bayer-patterns' on page > > 153 undefined on input line 21373. > > > > <use "bayer.png" > [153] > > ! Extra alignment tab has been changed to \cr. > > <template> \endtemplate > > > > l.21429 \unskip}\relax \unskip} > > \relax \\ > > ? > > > > This patch fixes the issue: > > https://git.linuxtv.org/mchehab/experimental.git/commit/?h=dirty-pdf&id=b709de415f34d77cc121cad95bece9c7ef4d12fd > > > > That means that Sphinx is not generating the right LaTeX output even for > > (some?) PNG images. > > \includegraphics normally works just fine for PNG images in PDF > documents. I didn't try to fix the Sphinx output in LaTeX format when a PNG image is used, but, from the above log, clearly it did something wrong. Perhaps there's something bad defined at the sphinx.sty file, or it simply generates the wrong LaTeX code when the image is not on PDF format. > [...] > > And it may even require "--shell-escape" to be passed at the xelatex > > call if inkscape is not in the path, with seems to be a strong > > indication that SVG support is not native to texlive, but, instead, > > just a way to make LaTeX to call inkscape to do the image conversion. > > Please don't require --shell-escape as part of the TeX workflow. If > LaTeX can't handle the desired image format natively, it needs > conversion in advance. Agreed. I sent a patch series to linux-doc, doing the conversion in advance: https://marc.info/?l=linux-doc&m=147859902804144&w=2 Not sure why, but the archives don't have all patches yet. Anyway, the relevant one is this: https://git.linuxtv.org/mchehab/experimental.git/commit/?h=pdf-fixes&id=5d41c452c787f6a6c755a3855312435bc439acb8 It basically calls ImageMagick "convert" tool for all png and pdf files currently at the documentation (they're all at media, ATM). Thanks, Mauro -- 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
