[dpdk-dev] [PATCH v2 1/4] mk: Add 'make doc-pdf' target to convert guide docs to pdf

Thomas Monjalon thomas.monjalon at 6wind.com
Mon Feb 2 14:35:19 CET 2015


2015-02-02 13:10, Mcnamara, John:
> From: Thomas Monjalon [mailto:thomas.monjalon at 6wind.com]
> > > +        # Change the svg image includes to png in the latex docs.
> > > +	$(Q)sed -i 's/\.svg/.png/g' $(RTE_OUTPUT)/doc/latex/guides/$*/*.tex
> > 
> > No, you could avoid that if every image references where x.* instead of
> > x.svg or x.png.
> > The image extension should always be .* in rst to be format agnostic.
> > Then there is a (configurable) rule to choose the best format.
> 
> This works for the html output but Sphinx throws a warning for the
> latex output since Sphinx doesn't support svg for that target. As a
> result the relative image include in the Latex file is incorrect and
> fails. So the sed conversion is a workaround.

I think it's possible. Look at this link:
http://stackoverflow.com/questions/6473660/using-sphinx-docs-how-can-i-specify-png-image-formats-for-html-builds-and-pdf-im
In this example, SVG files are converted into PDF files, not PNG.

-- 
Thomas


More information about the dev mailing list