Wiki source code of Enable PDF Conversion Debug Logging
Last modified by Vincent Massol on 2026/08/30 19:36
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
5.1 | 1 | The Docker converter runs ##pdflatex## inside a container and keeps to itself everything that run printed. A [[PDF conversion>>doc:documentation.extensions.admin.latex.pdf-conversion.WebHome]] that fails reports those compilation logs with its error, but one that succeeds and hands you a PDF you did not expect reports nothing at all. Raising a single logger to ##DEBUG## puts the whole compilation output in the job log of every export. |
| 2 | |||
| 3 | 1. Open **Administration** > **Logging**, the section the [[Logging application>>doc:extensions:Extension.Logging Application]] adds. Filter the **Logger** column on ##org.xwiki.contrib.latex.internal.pdf##, choose **DEBUG** in the **Actions** column of that row, and click **Set**.((( | ||
| 4 | {{image reference="logging-set-level.png" size="large" alt="The Logging administration section filtered on the LaTeX PDF logger, with DEBUG chosen in its Actions column and the Set button"/}} | ||
| 5 | |||
| 6 | Set the level on that logger rather than on one of the rows below it. Every logger nested under it inherits the level, so this one covers the converter, the container it drives, and anything else the conversion goes through. | ||
| 7 | ))) | ||
| 8 | 1. Check that the **Level** column of that row now reads **DEBUG**.((( | ||
| 9 | {{image reference="debug-logging.png" size="large" alt="The same row of the Logging administration section, its Level column now reading DEBUG"/}} | ||
| 10 | |||
| 11 | The new level applies at once, with nothing to restart. It is a runtime setting, though: XWiki comes back at the default level, so you have to set it again after each restart. | ||
| 12 | ))) | ||
| 13 | 1. Export a page to **PDF (LaTeX)** and open the **Job log** of the finished export. The ##pdflatex## run is in it line by line, exactly as the container printed it.((( | ||
| 14 | {{image reference="job-log-debug.png" size="large" alt="The job log of a finished PDF export, listing the pdflatex output line by line"/}} | ||
| 15 | ))) |
