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

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

Aspose.TeXライブラリには、さまざまな 一般的なラテックスパッケージが付属しているため、これらのパッケージをTexエンジンに手動で提供する必要はありません。ただし、ラテックスファイルには、ライブラリのパッケージの「バンドル」に含まれていないパッケージが必要な状況がある場合があります。そのような場合、 rebused_input_directory texoptionsクラスインスタンスのオプションを介して、必要なパッケージのソースファイルなど、必要な入力を提供してみてください。これが2つの例でどのように機能するかを探ります。

未梱包のフォーム(「ファンシーボックス」パッケージ)で提供される必要な入力。

「required-input-fs.tex」という名前の次の基本的なラテックスファイルがあるとします。これは サンプルソリューションの一部です。

\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}[t]
  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」パッケージが必要であることを示しています。 「Fancybox」パッケージのソースファイルがあると仮定しましょう。単一のファイルで構成される単純なパッケージであるため、このファイルをファイルシステムのどこにでも配置して、次のようにディレクトリパスを指定できます。

options.required_input_directory = InputFileSystemDirectory('path-to-directory-where-fancybox.sty-located')

このオプションでTEXジョブを実行したら(必要に応じて他のオプションを調整することを忘れないでください)、この場合はPNG画像である出力ドキュメントを取得します。

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

from aspose.tex import *
from aspose.tex.io import *
from aspose.tex.presentation.image import *
from util import Util
from os import path
###############################################
###### Class and Method declaration here ######
###############################################

# Create conversion options for Object LaTeX format upon Object TeX engine extension.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
# Specify a file system working directory for the output.
options.output_working_directory = OutputFileSystemDirectory(Util.output_directory)
# Specify a file system working directory for the required input.
# The directory containing packages may be located anywhere.
options.required_input_directory = InputFileSystemDirectory(path.join(Util.input_directory, "packages"))
# Initialize the options for saving in PNG format.
options.save_options = PngSaveOptions()
# Run LaTeX to PNG conversion.
TeXJob(path.join(Util.input_directory, "required-input-fs.tex"), ImageDevice(True), options).run()

アーカイブフォームで必要な入力を提供する(「pgfplots」パッケージ)

次に、「必要な入力Zip.tex」という名前の次のLaTexファイルがあるとします。これは、例のソリューションからの簡単なファイルでもあります。

\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アーカイブにパッケージ化したいと考えています。以下は、アーカイブの目的のレイアウトです。

そして、これらのソースファイルへのアクセシビリティを定義する方法は次のとおりです。

with open("path-to-zip-with-pgfplots-sources") as zipStream:
    ...
    options.required_input_directory = InputZipDirectory(zipStream)
    ...

このオプションでTEXジョブを実行した後、出力ドキュメントを取得します。

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

from aspose.tex import *
from aspose.tex.io import *
from aspose.tex.presentation.image import *
from util import Util
from os import path
###############################################
###### Class and Method declaration here ######
###############################################

# Create conversion options for Object LaTeX format upon Object TeX engine extension.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
# Specify a file system working directory for the output.
options.output_working_directory = OutputFileSystemDirectory(Util.output_directory)
# Initialize the options for saving in PNG format.
options.save_options = PngSaveOptions()
# Create a file stream for the ZIP archive containing the required package.
# The ZIP archive may be located anywhere.
with open(path.join(Util.input_directory, "packages\\pgfplots.zip"), "rb") as zip_stream:
    # Specify a ZIP working directory for the required input.
    options.required_input_directory = InputZipDirectory(zip_stream, "")

    # Run LaTeX to PNG conversion.
    TeXJob(path.join(Util.input_directory, "required-input-zip.tex"), ImageDevice(True), options).run()

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

制限

latex3eカーネルANの下で開発されたパッケージに出くわした場合、LaTexファイルで必要とされている場合、Aspose.TeXライブラリを使用する可能性は低いです。これは、ライブラリが * latex2e *カーネルに基づいているためです。

さらに、ラテックスファイルに必要なパッケージが、Aspose.TeXライブラリのオブジェクトtexエンジンによってサポートされていないデバイス依存のプリミティブコマンドを直接使用する場合があります。そのような場合、パッケージはライブラリで動作しません。