AsposeTeXforPython – FAQ

Q: AsposeTeXforPython とは何ですか?

A: AsposeTeXforPython は、外部 TeX ディストリビューションを必要とせずに、LaTeX/TeX ドキュメントをレンダリングし、PDF、XPS、SVG、PNG、JPEG、BMP、TIFF およびその他の画像形式に変換する純粋な Python API (Pythonnet 経由で AsposeTeX .NET ライブラリ上に構築されています) です。インプロセスで実行され、Web サービス、デスクトップ アプリ、自動レポート ジェネレーターに適しています。

Q: AsposeTeXforPython をインストールするにはどうすればよいですか?

A: pip install aspose-tex-python-net を実行します。パッケージには、必要な pythonnet ランタイムが自動的にバンドルされます。 Python3.8以降を使用する任意の仮想環境(Windows、Linux、macOS)内にインストールします。次のコマンドを使用してインストールを確認します。

import aspose.tex as tex
print(tex.__version__)

Q: ローカル TeX ディストリビューション (MiKTeX、TeXLive など) が必要ですか?

A: いいえ。すべての解析およびレンダリング ロジックは AsposeTeX に組み込まれているため、外部の TeX エンジンは必要ありません。このライブラリには、すぐに使用できる 300 を超えるコア LaTeX パッケージと共通のクラス ファイルが含まれています。

Q: 数行のコードで「.tex」ファイルを PDF に変換するにはどうすればよいですか?

A: Object LaTeX 構成、PdfSaveOptions、PdfDevice を使用して TeXJob を作成します。 ASPOSE_TEX_INPUT_FILE に LaTeX ファイル、ASPOSE_TEX_OUTPUT_DIR に出力ディレクトリを指定するか、例のパスを編集してください。既定値は hello-world.ltx と output です。事前にライセンスを適用してください。追加の入力ファイルはメイン文書と同じディレクトリから読み込まれ、処理は対話入力なしで実行されます。 ライセンス

# Convert LaTeX to PDF.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.pdf import PdfDevice, PdfSaveOptions

# Set these paths to your LaTeX document and output directory.
input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "hello-world.ltx")).resolve()
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
if not input_file.is_file():
    raise FileNotFoundError(input_file)
output_dir.mkdir(parents=True, exist_ok=True)

# Use the Object LaTeX format and resolve additional inputs beside the main file.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.interaction = Interaction.NONSTOP_MODE
options.terminal_out = OutputMemoryTerminal()
options.save_options = PdfSaveOptions()
device = PdfDevice()
job_result = TeXJob(str(input_file), device, options).run()

出力名は入力名に対応します。hello-world.ltx から hello-world.pdf が生成されます。 LaTeX → PDF

Q: AsposeTeXforPython はどの出力形式を生成できますか?

A: PDF、XPS、SVG、PNG、JPEG、BMP、および TIFF。各形式は、特定の SaveOptions オブジェクト (例: PdfSaveOptions、PngSaveOptions、SvgSaveOptions) を介して制御できます。

Q: 生成された PDF にカスタム フォントを埋め込むにはどうすればよいですか?

A: フォントは TeX または LaTeX ドキュメントとそのパッケージで選択します。リソースについては 外部 LaTeX パッケージを参照してください。PdfSaveOptions の subset_fonts プロパティは使用したグリフのみを埋め込むかどうかを制御するもので、カスタムフォントを選択するものではありません。同じオプションを使う完全な XPS の例は フォントのサブセット化を参照してください。

Q: どのような LaTeX パッケージとクラスがそのままサポートされていますか?

A: ライブラリには一般的な LaTeX パッケージとクラスが含まれます。対応範囲は 組み込みパッケージ一覧を参照してください。 外部パッケージの例では、required_input_directory を通じて pgfplots のソースファイルを提供します。

Q: 組み込みではないサードパーティの .sty またはクラス ファイルを使用するにはどうすればよいですか?

A: TeXOptions.required_input_directory に、必要なパッケージファイルを含む InputFileSystemDirectory を設定します。完全な例では ExternalLaTeXPackages/packages から fancybox.sty を読み込み、required-input-fs.tex を PNG に変換します。ZIP アーカイブと互換性の制限については 外部 LaTeX パッケージを参照してください。

まず ライセンスを適用します。ASPOSE_TEX_INPUT_DIR に、2 つの .tex ファイルと packages サブフォルダーを含む ExternalLaTeXPackages の親フォルダーを指定します（既定値：input）。ASPOSE_TEX_OUTPUT_DIR に出力フォルダーを指定します（既定値：output）。

# Load an external LaTeX package from a directory.
import os
from pathlib import Path
from os import path
from io import BytesIO
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from aspose.tex.io import InputFileSystemDirectory, InputZipDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.image import ImageDevice, PngSaveOptions

output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
output_dir.mkdir(parents=True, exist_ok=True)
input_dir = Path(os.environ.get("ASPOSE_TEX_INPUT_DIR", "input")).resolve() / "ExternalLaTeXPackages"
# Create conversion options for Object LaTeX format upon Object TeX engine extension.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
options.interaction = Interaction.NONSTOP_MODE
options.terminal_out = OutputMemoryTerminal()
# Specify a file system working directory for the output.
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
# 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(str(input_dir), "packages"))
# Initialize the options for saving in PNG format.
options.save_options = PngSaveOptions()
# Run LaTeX to PNG conversion.
TeXJob(path.join(str(input_dir), "required-input-fs.tex"), ImageDevice(True), options).run()

Q: エンジンの主な制限は何ですか?

A:

制限事項	詳細
シェル エスケープ (\write18)	セキュリティ上の理由により無効です。
完全な TikZ 外部化	サポートされていません。ほとんどの TikZ グラフィックはインプロセスでレンダリングされますが、非常に複雑な描画は失敗する可能性があります。
Unicode フォントのサポート範囲	完全なグリフ セットを持つ TrueType/OpenType フォントのみが完全にサポートされています。従来の Type1 フォントは変換が必要になる場合があります。
非常に大きなドキュメント (500 ページ超)	大量のメモリを消費する可能性があります。Document.save(output_stream, options) を使用してページをストリーミングすることを検討してください。

Q: ライセンス キーを適用するにはどうすればよいですか?また、利用可能なライセンス モデルは何ですか?

A: 他の Aspose.TeX クラスを使用する前にライセンスを適用してください。ASPOSE_TEX_PYTHON_NET_LICENSE_PATH にライセンスファイルのパスを設定するか、作業ディレクトリに Aspose.TeX.Python-net.lic を配置します。

# Apply a license from a file before using other Aspose.TeX classes.
import os
from aspose.tex import License

# Set this environment variable, or place the license in the working directory.
license_path = os.environ.get(
    "ASPOSE_TEX_PYTHON_NET_LICENSE_PATH", "Aspose.TeX.Python-net.lic"
)
license = License()
license.set_license(license_path)

ファイル、ストリーム、Metered によるライセンス適用例と評価版の制限については、 ライセンスを参照してください。

Q: ライブラリは並列変換に対してスレッドセーフですか?

A: はい、各スレッドが独自の Document インスタンスを作成する場合に限ります。 「License」などの静的オブジェクトは、並行作業を開始する前に設定する必要があります。

Q: AsposeTeXforPython にはどの .NET ランタイム バージョンが必要ですか?

A: パッケージには .NET6 (x64) ランタイム バイナリが同梱されています。これらは最初のインポート時に Pythonnet によって自動的にロードされます。 .NET を手動でインストールする必要はありません。

Q: ラスター出力のページ サイズ、方向、DPI を設定するにはどうすればよいですか?

A: ページのサイズと向きは LaTeX ソースで指定します。例えば、この A4 横向き文書を landscape.ltx として保存してください。

\documentclass{article}
\usepackage[a4paper,landscape]{geometry}
\begin{document}
Hello, World!
\end{document}

保存オプションをジョブに設定する前に PngSaveOptions.resolution を指定します。この例では 300 DPI を使用します。ASPOSE_TEX_INPUT_FILE に landscape.ltx、ASPOSE_TEX_OUTPUT_DIR に出力ディレクトリを指定するか、既定のパスを使用してください。

# Convert an A4 landscape LaTeX document to PNG at 300 DPI.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.image import ImageDevice, PngSaveOptions

# Set these paths to your LaTeX document and output directory.
input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "landscape.ltx")).resolve()
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
if not input_file.is_file():
    raise FileNotFoundError(input_file)
output_dir.mkdir(parents=True, exist_ok=True)

# Use the Object LaTeX format and resolve additional inputs beside the main file.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.interaction = Interaction.NONSTOP_MODE
options.terminal_out = OutputMemoryTerminal()
# Page size and orientation are defined in the LaTeX input (geometry package).
# Set the raster resolution in dots per inch.
save_options = PngSaveOptions()
save_options.resolution = 300
options.save_options = save_options
device = ImageDevice(True)
job_result = TeXJob(str(input_file), device, options).run()

結果は約 3508 × 2480 ピクセルの landscape.png です。

Q: LaTeX を文字列またはメモリ内ストリームから直接レンダリングできますか?

A: 完全な LaTeX 文書をバイナリ BytesIO ストリームに変換し、TeXConfig.object_latex を設定した TeXJob に渡します。ジョブ中はストリームを開いたままにします。出力は texput.xps と texput.log です。 ASPOSE_TEX_OUTPUT_DIR に出力ディレクトリを指定します（既定値：output）。事前にライセンスを適用してください。 Licensing.

# Render LaTeX supplied as a binary in-memory stream to XPS.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from io import BytesIO
from aspose.tex.io import OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.xps import XpsDevice

output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
output_dir.mkdir(parents=True, exist_ok=True)

options = TeXOptions.console_app_options(TeXConfig.object_latex)
options.interaction = Interaction.NONSTOP_MODE
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.terminal_out = OutputMemoryTerminal()
latex_source = r"\documentclass{article} \begin{document} Hello, World! \end{document}"
device = XpsDevice()
with BytesIO(latex_source.encode("ascii")) as input_stream:
    job_result = TeXJob(input_stream, device, options).run()

Q: 公式ドキュメント、コード サンプル、サポート チャネルはどこで見つけられますか?

A: 次のリソースを確認してください。

• 公式ドキュメント
• 【スタートガイド】(2)
• コードサンプルとGitHub要点
• 【サポートフォーラム】(4)
• Issue Tracker (顧客専用) - 購入後に提供されます

すべての例は Python と C# の両方で利用できます。 C# コードは Pythonnet のおかげで直接変換できます。