You can run BuildVu directly from the command line which is useful for running the converter from another language or script.
- You must download buildvu-svg.jar or buildvu-html.jar
- Requires Java 8 or later (see version compatibility)
- Run from the same location as the buildvu jar or provide an absolute path
java -Xmx512M -jar buildvu-svg.jar /inputDirectory/ /outputDirectory/
java -Xmx512M -jar buildvu-html.jar /inputDirectory/ /outputDirectory/
You may want provide more memory by increasing the Xmx value.
IDRViewer or Content mode?
The default mode generates the document inside the IDRViewer. To generate just the raw content to be used inside your own custom solution, you can set -Dorg.jpedal.pdf2html.viewMode=content
java -Dorg.jpedal.pdf2html.viewMode=content -jar buildvu-svg.jar /inputDirectory/ /outputDirectory/
How are the settings controlled?
When running from command line, settings are controlled by passing in system properties. Available settings and their values can be found in the Javadocs. The key classes are:
- SVGConversionOptions (Settings available in BuildVu-SVG)
- HTMLConversionOptions (Settings available in BuildVu-HTML)
- IDRViewerOptions (Settings available in IDRViewer modes)
- ContentOptions (Settings available in Content modes)
java -Dorg.jpedal.pdf2html.compressImages=true -jar buildvu.jar /inputDirectory/ /outputDirectory/
Office Document Support:
Although BuildVu's primary function is to convert PDF files to HTML5, it is also possible to enable conversion of Office documents to HTML5 by utilising LibreOffice to pre-convert office documents to PDF.
After you have installed LibreOffice, simply pass in the absolute path to the LibreOffice executable as a system property to enable conversion of Office documents to HTML5 from command line.
java -Dorg.jpedal.pdf2html.libreOfficeExecutablePath="/path/to/soffice" -jar buildvu-svg.jar /inputDir/ /outputDir/
Conversion will fail if a PDF file with the same filename as the office document already exists.
This can be avoided by allowing the file to be overwriten, this is set with -Dorg.jpedal.pdf2html.allowLibreOfficeOverwrite=true
If you are running LibreOffice on Linux you may find that some files do not convert correctly if they make use of fonts that are not available on Linux. We would recommend installing Google Noto Fonts to increase the likelyhood that missing fonts will be substituted with a fallback.