コマンドラインからBuildVuを実行する
BuildVuはコマンドラインから直接変換を実行することができます。これは、他の言語やスクリプトからコンバーターを呼び出す際に便利です。
- buildvu-svg.jar または buildvu-html.jar をダウンロード する必要があります
- Java 17以降が必要です（バージョン互換性についてはこちら ）
- buildvu の jar ファイルと同じディレクトリから実行するか、絶対パスを指定してください
java -Xmx512M -jar buildvu-svg.jar /inputDirectory/ /outputDirectory/
java -Xmx512M -jar buildvu-html.jar /inputDirectory/ /outputDirectory/
Xmx の値を大きくすることで、より多くのメモリを割り当てることができます。
デフォルトモードでは、IDRViewer 内にドキュメントが生成されます。独自のカスタムソリューションで使用するための生コンテンツのみを生成したい場合は、-Dorg.jpedal.pdf2html.viewMode=content を設定してください。BuildVu-HTML では -Dorg.jpedal.pdf2html.viewMode=singlefile もサポートしており、これにより単一の自己完結型HTMLファイルが生成されます。詳細は View Mode を参照してください。
java -Dorg.jpedal.pdf2html.viewMode=content -jar buildvu-svg.jar /inputDirectory/ /outputDirectory/
コマンドラインから実行する場合、設定はシステムプロパティを引数として渡すことで制御します。利用可能な設定とその値については、変換オプション のセクションを参照してください。
java -Dorg.jpedal.pdf2html.imageScale="1.5" -jar buildvu.jar /inputDirectory/ /outputDirectory/
BuildVuの主な機能はPDFファイルをHTML5に変換することですが、LibreOffice を使用してOfficeドキュメントをあらかじめPDFに変換することで、OfficeドキュメントをHTML5に変換することも可能です。
LibreOfficeをインストールした後、LibreOffice の実行ファイルへの絶対パスをシステムプロパティとして渡すだけで、コマンドラインからOfficeドキュメントをHTML5に変換できるようになります。
java -Dorg.jpedal.pdf2html.libreOfficeExecutablePath="/path/to/soffice" -jar buildvu-svg.jar /inputDir/ /outputDir/
Officeドキュメントと同じファイル名のPDFファイルがすでに存在する場合、変換は失敗します。ファイルの上書きを許可することでこの問題を回避できます。上書きを許可するには -Dorg.jpedal.pdf2html.allowLibreOfficeOverwrite=true を設定してください。
Linux上でLibreOfficeを実行している場合、Linuxで利用できないフォントを使用しているファイルが正しく変換されないことがあります。不足しているフォントが代替フォントに置き換えられる可能性を高めるために、Google Noto Fonts のインストールをお勧めします。