BuildVuは、Javaアプリケーション内から直接実行できます。 このガイドは、Javaの知識を持つ開発者を対象としています。

前提条件

• buildvu.jarをダウンロードする必要があります
• Java 8以降が必要です（バージョンの互換性を参照）
• プロジェクトライブラリにbuildvu.jarを追加する

クイックスタート

HTMLConversionOptions conversionOptions = new HTMLConversionOptions();
// Set conversion options here e.g. conversionOptions.setCompressImages(true);

IDRViewerOptions viewerOptions = new IDRViewerOptions();
// Set viewer options here e.g. 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();
}

詳細については、BuildVuのJavadocページを参照してください。 代わりにSVGコンテンツを使用したい場合は、PDFtoSVGConverterを使用することもできます。

設定方法

利用可能な設定とその値はJavadocにあります。 主要なクラスは次のとおりです：

• HTMLConversionOptions（HTMLモードで使用可能な設定）
• SVGConversionOptions（SVGモードで使用可能な設定）
• IDRViewerOptions（IDRViewerモードで使用可能な設定）
• ContentOptions（コンテンツモードで使用可能な設定）

java -Dorg.jpedal.pdf2html.compressImages=true -jar buildvu.jar /inputDirectory/ /outputDirectory/

暗号化されたPDFファイル

BuildVuには暗号化されたPDFファイルを解読する機能が含まれていますが、代わりのプロバイダを指定する場合は、-Dorg.jpedal.securityproviderを使用して引き続き行うことができます。 必要に応じて、クラスパスにセキュリティプロバイダを追加することを忘れないでください。

-Dorg.jpedal.securityprovider="org.bouncycastle.jce.provider.BouncyCastleProvider"

Officeドキュメントのサポート

BuildVuの主な機能はPDFファイルをHTML5に変換することですが、OfficeドキュメントをHTML5に変換するには、LibreOfficeを使用してオフィスドキュメントをPDFに変換しておくこともできます。

LibreOfficeをインストールした後、DocumentToPDFConverterクラスを使用してLibreOfficeを呼び出して、Officeドキュメントを前処理することができます。

if (DocumentToPDFConverter.hasConvertibleFileType(document)) {
    try {
        DocumentToPDFConverter.convert(document, libreOfficeExecutablePath);

        // Code to convert generated PDF file to HTML5 goes here

    } catch (IOException e) {
        // Problem occurred - see Javadoc for reasons
    } catch (InterruptedException e) {
        // Process was interrupted
    }
} else {
    // File type not supported
}

詳しくは、Javadocを読むことをお勧めします。 DocumentToPDFConverterクラスのソースコードをオンラインで表示する。

フォントで起こりうる問題

LinuxでLibreOfficeを実行している場合、Linuxで利用できないフォントを使用すると、一部のファイルが正しく変換されないことがあります。 欠落したフォントを代替フォントに置き換える可能性を高めるには、Google Notoフォントをインストールすることをおすすめします。