AsposeTeXforPython – FAQ

F: Was ist AsposeTeXforPython?

A: AsposeTeXforPython ist eine reine Python-API (basierend auf der AsposeTeX .NET-Bibliothek über pythonnet), die LaTeX/TeX-Dokumente in PDF, XPS, SVG, PNG, JPEG, BMP, TIFF und andere Bildformate rendert und konvertiert, ohne dass eine externe TeX-Verteilung erforderlich ist. Es läuft prozessintern und eignet sich für Webdienste, Desktop-Apps und automatisierte Berichtsgeneratoren.

F: Wie installiere ich AsposeTeXforPython?

A: Führen Sie „pip install aspose-tex-python-net“ aus. Das Paket bündelt die erforderliche „Pythonnet“-Laufzeit automatisch. Installieren Sie es in einer beliebigen virtuellen Umgebung (Windows, Linux, macOS) mit Python3.8 oder höher. Überprüfen Sie die Installation mit:

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

F: Benötige ich eine lokale TeX-Distribution (MiKTeX, TeXLive usw.)?

A: Nein. Die gesamte Parsing- und Rendering-Logik ist in AsposeTeX integriert, sodass Sie nie eine externe TeX-Engine benötigen. Die Bibliothek umfasst über 300 LaTeX-Kernpakete und gängige Klassendateien sofort einsatzbereit.

F: Wie kann ich eine „.tex“-Datei mit ein paar Codezeilen in PDF konvertieren?

A: Erstellen Sie einen TeXJob mit der Object-LaTeX-Konfiguration, PdfSaveOptions und PdfDevice. Setzen Sie ASPOSE_TEX_INPUT_FILE auf Ihre LaTeX-Datei und ASPOSE_TEX_OUTPUT_DIR auf das Ausgabeverzeichnis, oder ändern Sie die Pfade im Beispiel. Die Standardwerte sind hello-world.ltx und output. Wenden Sie vorher eine Lizenz an. Zusätzliche Eingabedateien werden neben dem Hauptdokument gesucht; die Verarbeitung erfolgt ohne interaktive Eingaben. Lizenzierung

# 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()

Der Ausgabename folgt dem Eingabenamen: Aus hello-world.ltx wird hello-world.pdf. LaTeX → PDF

F: Welche Ausgabeformate kann AsposeTeXforPython generieren?

A: PDF, XPS, SVG, PNG, JPEG, BMP und TIFF. Jedes Format kann über bestimmte „SaveOptions“-Objekte gesteuert werden (z. B. „PdfSaveOptions“, „PngSaveOptions“, „SvgSaveOptions“).

F: Wie bette ich benutzerdefinierte Schriftarten in das generierte PDF ein?

A: Schriftarten werden im TeX- oder LaTeX-Dokument und seinen Paketen ausgewählt. Für Paketressourcen siehe externe LaTeX-Pakete. Die Eigenschaft subset_fonts von PdfSaveOptions legt fest, ob nur verwendete Glyphen eingebettet werden; sie wählt keine benutzerdefinierte Schriftart aus. Ein vollständiges XPS-Beispiel mit derselben Option finden Sie unter Schriftartuntergruppen.

F: Welche LaTeX-Pakete und -Klassen werden standardmäßig unterstützt?

A: Die Bibliothek enthält gängige LaTeX-Pakete und Klassen. Den Umfang zeigt die Liste eingebetteter Pakete. Das Beispiel für externe Pakete stellt die Quellen von pgfplots über required_input_directory bereit.

F: Wie kann ich eine „.sty“- oder Klassendatei eines Drittanbieters verwenden, die nicht integriert ist?

A: Setzen Sie TeXOptions.required_input_directory auf ein InputFileSystemDirectory mit den benötigten Paketdateien. Das vollständige Beispiel lädt fancybox.sty aus ExternalLaTeXPackages/packages und konvertiert required-input-fs.tex nach PNG. Informationen zu ZIP-Archiven und Einschränkungen finden Sie unter externe LaTeX-Pakete.

Wenden Sie zuerst eine Lizenz an. ASPOSE_TEX_INPUT_DIR muss auf den Ordner zeigen, der ExternalLaTeXPackages mit den beiden .tex-Dateien und dem Unterverzeichnis packages enthält (Standard: input). Setzen Sie ASPOSE_TEX_OUTPUT_DIR auf den Ausgabeordner (Standard: 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()

F: Was sind die Haupteinschränkungen der Engine?

A:

Einschränkung	Details
Shell-Escape (\write18)	Aus Sicherheitsgründen deaktiviert.
Vollständige TikZ-Externalisierung	Nicht unterstützt; die meisten TikZ-Grafiken werden im Prozess gerendert, aber extrem komplexe Zeichnungen können fehlschlagen.
Unicode-Schriftabdeckung	Nur TrueType-/OpenType-Schriften mit vollständigen Glyphensätzen werden vollständig unterstützt; ältere Type1-Schriften müssen möglicherweise konvertiert werden.
Sehr große Dokumente (>500 Seiten)	Können viel Speicherplatz beanspruchen; erwägen Sie, Seiten mit Document.save(output_stream, options) zu streamen.

F: Wie wende ich einen Lizenzschlüssel an und welche Lizenzmodelle sind verfügbar?

A: Wenden Sie die Lizenz an, bevor Sie andere Aspose.TeX-Klassen verwenden. Setzen Sie ASPOSE_TEX_PYTHON_NET_LICENSE_PATH auf den Lizenzpfad oder legen Sie Aspose.TeX.Python-net.lic im Arbeitsverzeichnis ab.

# 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)

Beispiele für die Lizenzierung per Datei, Stream und Metered sowie Einschränkungen der Testversion finden Sie unter Lizenzierung.

F: Ist die Bibliothek threadsicher für parallele Konvertierungen?

A: Ja, vorausgesetzt, jeder Thread erstellt seine eigene „Dokument“-Instanz. Statische Objekte wie die „Lizenz“ müssen festgelegt werden, bevor parallele Arbeiten gestartet werden.

F: Welche .NET-Laufzeitversion benötigt AsposeTeXforPython?

A: Das Paket wird mit den Laufzeitbinärdateien .NET6 (x64) geliefert. Sie werden beim ersten Import automatisch von Pythonnet geladen; Sie müssen .NET nicht manuell installieren.

F: Wie kann ich Seitengröße, Ausrichtung und DPI für Rasterausgaben festlegen?

A: Legen Sie Seitengröße und Ausrichtung im LaTeX-Quelltext fest. Speichern Sie beispielsweise dieses A4-Dokument im Querformat als landscape.ltx:

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

Setzen Sie PngSaveOptions.resolution, bevor Sie die Speicheroptionen dem Auftrag zuweisen. Das Beispiel verwendet 300 DPI. Setzen Sie ASPOSE_TEX_INPUT_FILE auf landscape.ltx und ASPOSE_TEX_OUTPUT_DIR auf das Ausgabeverzeichnis, oder verwenden Sie die Standardpfade:

# 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()

Das Ergebnis ist landscape.png mit ungefähr 3508 × 2480 Pixeln.

F: Kann ich LaTeX direkt aus einem String oder einem In-Memory-Stream rendern?

A: Kodieren Sie ein vollständiges LaTeX-Dokument in einen binären BytesIO-Stream und übergeben Sie ihn an TeXJob mit TeXConfig.object_latex. Halten Sie den Stream während des Auftrags offen. Ergebnis: texput.xps und texput.log. Setzen Sie ASPOSE_TEX_OUTPUT_DIR auf das Ausgabeverzeichnis (Standard: output). Wenden Sie zuerst eine Lizenz an. 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()

F: Wo finde ich offizielle Dokumentation, Codebeispiele und Supportkanäle?

A: Sehen Sie sich die nächsten Ressourcen an:

• Offizielle Dokumentation
• Erste Schritte
• Codebeispiele und GitHub-Gists
• Supportforum
• Issue Tracker (privat für Kunden) – Wird nach dem Kauf bereitgestellt

Alle Beispiele sind sowohl in Python als auch in C# verfügbar; Der C#-Code kann dank Pythonnet direkt übersetzt werden.