JavaからBuildVuを実行する
BuildVuは、Javaアプリケーション内から直接実行できます。 このガイドは、Javaの知識を持つ開発者を対象としています。
前提条件
- buildvu-svg.jar、buildvu-html.jarをダウンロードする必要があります
- Java 17以降が必要です(バージョン互換性をご確認ください)。
- プロジェクトライブラリにbuildvu.jarを追加する
クイックスタート
SVGConversionOptions conversionOptions = new SVGConversionOptions();
// 変換オプションをここで設定します。例：conversionOptions.setCompressImages(true)；
IDRViewerOptions viewerOptions = new IDRViewerOptions();
// ここでビューアオプションを設定します。例：viewerOptions.setViewerUI(IDRViewerOptions.ViewerUI.Clean)；
File pdfFile = new File("C:/MyDocument.pdf");
File outputDir = new File("C:/MyOutputDirectory/");
PDFtoSVGConverter converter = new PDFtoSVGConverter(pdfFile, outputDir, conversionOptions, viewerOptions);
try {
converter.convert();
} catch (PdfException e) {
e.printStackTrace();
}
詳細については、PDFtoSVGConverterのJavadocページを参照してください。
BuildVu-HTML:
HTMLConversionOptions conversionOptions = new HTMLConversionOptions();
// 変換オプションをここで設定します 例：conversionOptions.setCompressImages(true)；
IDRViewerOptions viewerOptions = new IDRViewerOptions();
// ここでビューアオプションを設定します。例：viewerOptions.setViewerUI(IDRViewerOptions.ViewerUI.Clean)；
File pdfFile = new File("C:/MyDocument.pdf");
File outputDir = new File("C:/MyOutputDirectory/");
PDFtoHTML5Converter converter = new PDFtoHTML5Converter(pdfFile, outputDir, conversionOptions, viewerOptions);
try {
converter.convert();
} catch (PdfException e) {
e.printStackTrace();
}
詳細については、PDFtoHTML5ConverterのJavadocページを参照してください。
ハイブリッド版：
HTMLConversionOptions conversionOptions = new HTMLConversionOptions();
// ここで変換オプションを設定します。例：conversionOptions.setCompressImages(true)；
IDRViewerOptions viewerOptions = new IDRViewerOptions();
// ここでビューアオプションを設定します。例：viewerOptions.setViewerUI(IDRViewerOptions.ViewerUI.Clean)；
File pdfFile = new File("C:/MyDocument.pdf");
File outputDir = new File("C:/MyOutputDirectory/");
PDFtoHTML5Converter converter = new PDFtoHTML5Converter(pdfFile, outputDir, conversionOptions, viewerOptions);
try {
converter.convert();
} catch (PdfException e) {
e.printStackTrace();
}
詳細については、PDFtoHTML5ConverterのJavadocページを参照してください。
SVGコンテンツを使用する場合は、PDFtoSVGConverterを参照下さい。
設定方法
利用可能な設定とその値はJavadocにあります。 主要なクラスは次のとおりです：
- SVGConversionOptions（SVGモードで使用可能な設定）
- HTMLConversionOptions（HTMLモードで使用可能な設定）
- IDRViewerOptions（IDRViewerモードで使用可能な設定）
- ContentOptions（コンテンツモードで使用可能な設定）
また、利用可能な設定とその値のリストは、変換オプションセクションにあります。
Officeドキュメントのサポート
BuildVuの主な機能はPDFファイルをHTML5に変換することですが、OfficeドキュメントをHTML5に変換するには、LibreOfficeを使用してオフィスドキュメントをPDFに変換しておくこともできます。
LibreOfficeをインストールした後、DocumentToPDFConverterクラスを使用してLibreOfficeを呼び出して、Officeドキュメントを前処理することができます。
if (DocumentToPDFConverter.hasConvertibleFileType(document)) {
try {
DocumentToPDFConverter.convert(document, libreOfficeExecutablePath);
// 生成されたPDFファイルをHTML5に変換するコードはここに入れる
} catch (IOException e) {
// 問題が発生しました - 原因についてはJavadocを参照してください
} catch (InterruptedException e) {
// プロセスが中断されました
}
} else {
// サポートされていないファイルタイプ*
}
詳しくは、Javadocを読むことをお勧めします。 DocumentToPDFConverterクラスのソースコードをオンラインで表示する。
フォントで起こりうる問題
LinuxでLibreOfficeを実行している場合、Linuxで利用できないフォントを使用すると、一部のファイルが正しく変換されないことがあります。 欠落したフォントを代替フォントに置き換える可能性を高めるには、Google Notoフォントをインストールすることをおすすめします。