Wiki source code of Configure PDF Conversion with a Local Process
Last modified by Vincent Massol on 2026/08/30 19:36
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | The local process converter compiles an exported LaTeX package by running a ##pdflatex## installed on the XWiki server itself. [[PDF Conversion>>doc:documentation.extensions.admin.latex.pdf-conversion.WebHome]] says when it is the one to choose. | ||
| 2 | |||
| 3 | 1. Install the **LaTeX to PDF Converter using local process** extension. It does not come with the LaTeX exporter, which carries the Docker converter instead. In **Administration** > **Extensions** the plain search lists recommended extensions only and does not find it, so use **Advanced search**, with the extension identifier ##org.xwiki.contrib.latex:latex-pdf-process## and the version of the LaTeX exporter you have installed.((( | ||
| 4 | {{image reference="pdf-process-extension-install.png" size="large" alt="The extension found by an advanced search of the Extension Manager, with its Install button highlighted"/}} | ||
| 5 | ))) | ||
| 6 | 1. Install a LaTeX distribution providing ##pdflatex## on the server machine where XWiki runs. It has to be on the ##PATH## of the process XWiki itself runs in, which is often narrower than the one your shell has; where it is not, name it by its absolute path in ##latex.pdf.process.commands##. | ||
| 7 | 1. Point the exporter at this converter in ##xwiki.properties##, then restart XWiki: the file is read at startup, so nothing changes until you do.((( | ||
| 8 | {{code language="none"}} | ||
| 9 | latex.pdf.export.hint=process | ||
| 10 | {{/code}} | ||
| 11 | |||
| 12 | ##latex.pdf.process.commands## needs no change unless your installation compiles differently; [[Configuration Properties>>doc:documentation.extensions.admin.latex.configuration.WebHome]] gives its default and how to override it. | ||
| 13 | ))) | ||
| 14 | 1. Export a page to **PDF (LaTeX)**. The job runs ##pdflatex## on the server and offers the compiled PDF for download.((( | ||
| 15 | {{image reference="pdf-process-export-finished.png" size="large" alt="A finished PDF (LaTeX) export, reporting that the export can now be downloaded"/}} | ||
| 16 | ))) |
