外部ラテックスパッケージ| Java用のAspose.TeX

外部ラテックスパッケージ

JavaのAspose.TeXライブラリには、 一般的なラテックスパッケージが含まれています。したがって、これらのパッケージをライブラリのTexエンジンに提供する方法に注意する必要はありません。しかし、(おそらく)ラテックスファイルには、パッケージの「ネイティブにサポートされている「バンドル」を超えたパッケージが必要になる場合があります。この場合、 setRequiredInputDirectory() texoptionsクラスインスタンスのメソッドを使用して、必要な入力、つまり必要なパッケージのソースファイルを提供することを試みることができます。これが2つの例でどのように機能するかを確認します。

inputFile に対応する LaTeX 文書の完全なパスを、outputDirectory に既存の出力フォルダーを指定します。両方の変換例は 150 DPI の PNG を生成します。選択した例の Aspose.TeX クラス、com.aspose.tex.rendering.ImageDevice、com.aspose.tex.rendering.PngSaveOptions、ZIP 入力用の java.io.InputStream と java.nio.file.Files をインポートします。呼び出し元のメソッドは例外を処理するか宣言します。 ライセンスガイドに従ってライセンスを適用してください。

未解決の必要な入力(fancyboxパッケージ)

次の単純なラテックスファイルがあるとしましょう。

\documentclass{article}
\usepackage[a6paper,landscape]{geometry}
\usepackage{fancybox}
\begin{document}
Test: \fbox{
  \begin{Bitemize}[b]
  \item First item
  \item A second one\\ on two lines
  \item(2pt) A third with extra space
  \end{Bitemize}
}
\par\bigskip
Test: \fbox{
  \begin{Beqnarray}
  y & = & x^2 \\
  a^2 + 2ab + b^2 & = & (a + b)^2 \\
  \int_0^\infty e^{-ax} dx & = & \frac{1}{a}
  \end{Beqnarray}
}
\end{document}

3 行目では外部パッケージ fancybox が必要です。packagesDirectory に fancybox.sty とその依存ファイルを含むローカルフォルダーを指定します。以下の完全な例はこのフォルダーを RequiredInputDirectory に設定し、PNG 画像を生成します。デバイスと作業ディレクトリはジョブ終了まで開いたままにし、その後に解放または閉じます。

これが例の完全なソースコードです。

// Render the fancybox document using external package sources from a local folder.
// inputFile is the full TeX input path; packagesDirectory contains fancybox.sty.
// outputDirectory is an existing output folder.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
OutputFileSystemDirectory output = new OutputFileSystemDirectory(outputDirectory);
InputFileSystemDirectory packages = new InputFileSystemDirectory(packagesDirectory);
options.setOutputWorkingDirectory(output);
options.setRequiredInputDirectory(packages);
PngSaveOptions saving = new PngSaveOptions();
saving.setResolution(150);
options.setSaveOptions(saving);
options.setInteraction(Interaction.NonstopMode);
options.setTerminalOut(new OutputMemoryTerminal());
ImageDevice device = new ImageDevice();
TeXJobResult result;
int pages;
try {
    result = new TeXJob(inputFile, device, options).run();
    pages = device.getPageCount();
} finally {
    device.dispose();
    output.close();
    packages.close();
}

必要な入力( pgfplotsパッケージ)アーカイブ

次に、次の非常に単純なLaTexファイルもあります。これは、required-input-zip.texです。

\documentclass{article}
\usepackage[margin=0.25in]{geometry}
\usepackage{pgfplots}
\pgfplotsset{width=10cm,compat=1.18}
\begin{document}

First example is 2D and 3D math expressions plotted side-by-side.

%Here begins the 2D plot
\begin{tikzpicture}
\begin{axis}
\addplot[color=red]{exp(x)};
\end{axis}
\end{tikzpicture}
%Here ends the 2D plot
\hskip 5pt
%Here begins the 3D plot
\begin{tikzpicture}
\begin{axis}
\addplot3[
    surf,
]
{exp(-x^2-y^2)*x};
\end{axis}
\end{tikzpicture}
%Here ends the 3D plot

\end{document}

3行目では、このファイルがpgfplotsパッケージを必要としていることがわかりますが、これも「ネイティブ」サポートされていません。ここでも、pgfplots パッケージのソースファイルが存在することを前提としています。これは、LaTeX 組版アプリケーションのインストールディレクトリで見つけると、2つの場所に分かれた非常に大きなファイルセットです。pgfplots フォルダは、\tex\generic フォルダと \tex\latex フォルダの両方にあります。そして、これら両方のフォルダの内容は、Aspose.TeX ライブラリへの必須入力として提供する必要があります。これらのソースファイルを ZIP アーカイブにパッケージ化したいので、アーカイブのレイアウトは以下のようになります。

packagesZip に、パッケージの generic と LaTeX のソースを含むアーカイブへの java.nio.file.Path を指定します。以下の完全な Java 例は Files.newInputStream(...) で開き、InputZipDirectory を RequiredInputDirectory に設定します。空のベースパス引数はアーカイブ全体を選択します。TeX ジョブが終了するまで ZIP ストリームとディレクトリを開いたままにし、その後に閉じます。結果は 2 つのグラフを含む PNG 画像です。

これが例の完全なソースコードです。

// Render the 2D/3D plots using pgfplots package sources from a ZIP archive.
// inputFile is the full TeX input path; packagesZip is a java.nio.file.Path.
// outputDirectory is an existing output folder; the ZIP includes generic and latex sources.
TeXJobResult result;
int pages;
try (InputStream zipStream = Files.newInputStream(packagesZip)) {
    TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
    OutputFileSystemDirectory output = new OutputFileSystemDirectory(outputDirectory);
    InputZipDirectory packages = new InputZipDirectory(zipStream, "");
    options.setOutputWorkingDirectory(output);
    options.setRequiredInputDirectory(packages);
    PngSaveOptions saving = new PngSaveOptions();
    saving.setResolution(150);
    options.setSaveOptions(saving);
    options.setInteraction(Interaction.NonstopMode);
    options.setTerminalOut(new OutputMemoryTerminal());
    ImageDevice device = new ImageDevice();
    try {
        result = new TeXJob(inputFile, device, options).run();
        pages = device.getPageCount();
    } finally {
        device.dispose();
        output.close();
        packages.close();
    }
}

注意: この結果は pgfplots パッケージのバージョン 1.18.1 を使用して検証されました。Aspose.TeX ライブラリに含まれる pfg パッケージのバージョンは 3.1.9a です。

外部フォントパッケージを使用します

通常、LaTeXディストリビューションには、タイプセッティングに使用できるデフォルトのフォントがいくつか付属しています。これらのフォントに加えて、Aspose.TeX は amsfonts、eurosym、wasysym といった非標準フォントパッケージも提供しています。前述の通り、Aspose.TeX は外部パッケージの使用もサポートしていますが、ここでは主にフォントを含まないパッケージに焦点を当ててきました。

Aspose.TeX の Object TeX エンジン拡張機能には、フォント マップが必要です。フォント マップは、各 TeX の内部フォント名に対応する物理フォントを指定する、拡張子 .map を持つテキスト ファイルです。これらのフォント マップは、初期化フェーズで TeX のメモリに読み込む必要があり、パッケージ ファイルに含める必要があります。エンジンはすべてのフォント マップの名前を認識していないため、拡張子 .map を持つファイルを検索します。そのため、 RequiredInputDirectory オプションの値として使用される IInputWorkingDirectory インターフェイスの実装では、拡張子に基づいてファイル名のコレクションにアクセスする方法を提供する必要があります。具体的には、この実装は IFileCollectorインターフェースも実装する必要があります。標準実装である InputFileSystemDirectoryと InputZipDirectoryは既にこの要件を満たしています。

以下のカスタム RequiredInputDirectory は両方のインターフェースを実装し、明示的に登録されたローカルファイルを読み込みます。含まれる import とともに RequiredInputDirectory.java として保存します。各ファイルを storeFileName(...) で登録し、options.setRequiredInputDirectory(...) でインスタンスを設定して、ジョブ終了後に閉じます。階層を持たないレジストリなので、完全なパスを指定せずに要求するファイル名は一意である必要があります。拡張子の比較は大文字と小文字を区別せず、任意の収集パスでファイルシステムのディレクトリを選択できます。必要なパッケージ、フォントマップ、メトリック、実際のフォントファイルをすべて登録します。ファイル収集によりマップを検出できますが、不足するフォントデータは提供されません。

import com.aspose.tex.IInputWorkingDirectory;
import com.aspose.tex.IFileCollector;
import com.aspose.tex.TeXInputStream;
import java.io.IOException;
import java.io.UncheckedIOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.ArrayList;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Locale;
import java.util.Set;

// Register local package files explicitly, including font maps and their dependencies.
// Save this class as RequiredInputDirectory.java and close it after the TeX job.
public class RequiredInputDirectory implements IInputWorkingDirectory, IFileCollector {
    private final Set<Path> files = new LinkedHashSet<Path>();
    private final List<TeXInputStream> streams = new ArrayList<TeXInputStream>();

    public void storeFileName(String fileName) {
        Path file = Paths.get(fileName).toAbsolutePath().normalize();
        if (!Files.isRegularFile(file)) {
            throw new IllegalArgumentException("Package file does not exist: " + file);
        }
        files.add(file);
    }

    @Override
    public TeXInputStream getFile(String fileName, boolean searchSubdirectories) {
        // This registry is a flat virtual directory; only registered files are accessible.
        for (Path file : files) {
            if (file.toString().equals(fileName) || file.getFileName().toString().equals(fileName)) {
                try {
                    TeXInputStream stream = new TeXInputStream(Files.newInputStream(file), file.toString());
                    streams.add(stream);
                    return stream;
                } catch (IOException exception) {
                    throw new UncheckedIOException(exception);
                }
            }
        }
        return new TeXInputStream(null, fileName);
    }

    @Override
    public String[] getFileNamesByExtension(String extension) {
        return getFileNamesByExtension(extension, null);
    }

    @Override
    public String[] getFileNamesByExtension(String extension, String path) {
        String requested = extension.toLowerCase(Locale.ROOT);
        if (!requested.isEmpty() && !requested.startsWith(".")) {
            requested = "." + requested;
        }
        Path directory = path == null ? null : Paths.get(path).toAbsolutePath().normalize();
        List<String> matches = new ArrayList<String>();
        for (Path file : files) {
            String name = file.getFileName().toString();
            int dot = name.lastIndexOf('.');
            String actual = dot < 0 ? "" : name.substring(dot).toLowerCase(Locale.ROOT);
            if (actual.equals(requested) && (directory == null || file.getParent().equals(directory))) {
                matches.add(file.toString());
            }
        }
        return matches.toArray(new String[0]);
    }

    @Override
    public void close() throws IOException {
        IOException failure = null;
        for (TeXInputStream stream : streams) {
            try {
                stream.close();
            } catch (IOException exception) {
                if (failure == null) { failure = exception; }
                else { failure.addSuppressed(exception); }
            }
        }
        streams.clear();
        files.clear();
        if (failure != null) { throw failure; }
    }
}

制限

ラテックスファイルに必要なパッケージは、 LaTeX3eカーネルの下で開発できます。このようなパッケージは、Aspose.TeXライブラリで動作しない可能性が最も高くなります。後者はlatex2eカーネルに基づいているためです。

また、ラテックスファイルが必要とするパッケージは、Aspose.TeXライブラリのオブジェクトtexエンジンによってサポートされていないデバイス依存のプリミティブコマンドを直接呼び出すことができます。残念ながら、このようなパッケージは確かに機能しません。