cogConverts from LaTeX to PDF
TypeJAR
CategoryAPI
Developed by

Vincent Massol, Thomas Mortagne

Active Installs5
Rating
Rate!
0 Votes
LicenseGNU Lesser General Public License 2.1

Installable with the Extension Manager

Description

Generate a PDF by exporting to LaTeX and then using a docker image to perform the conversion to PDF.

Configuration

The following configuration parameters can be provided in xwiki.properties, shown here with default values:

## Docker image name and tag to use
latex.pdf.dockerImageName = blang/latex:ubuntu

## Command to execute in the docker container to generate the PDF
## Executed twice to have 2 compilation passes, in order to properly generate the Table of Content for example.
latex.pdf.dockerCommands = pdflatex -shell-escape index.tex; pdflatex -shell-escape index.tex

You can also pass the debug query string parameter if you wish to keep the intermediary files used for the compilation (they're normally removed), in order to debug a compilation problem.

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.

You can also use the manual method which involves dropping the JAR file and all its dependencies into the WEB-INF/lib folder and restarting XWiki.


The conversion uses Docker and thus you need to have Docker installed on the server machine where XWiki runs.

Dependencies

Dependencies for this extension (org.xwiki.contrib.latex:latex-pdf 1.12.4):

  • org.xwiki.commons:xwiki-commons-component-api 12.9
  • org.xwiki.platform:xwiki-platform-configuration-default 12.9
  • com.github.docker-java:docker-java-core 3.2.5
  • com.fasterxml.jackson.core:jackson-annotations 2.11.3
  • com.fasterxml.jackson.core:jackson-databind 2.11.3
  • org.apache.commons:commons-compress 1.20
  • com.github.docker-java:docker-java-transport-httpclient5 3.2.5
Tags:
    

Get Connected