AsposeTeXforPython – Domande frequenti

D: Cos’è AsposeTeXforPython?

R: AsposeTeXforPython è un’API Python pura (creata sulla libreria AsposeTeX .NET tramite pythonnet) che esegue il rendering e converte documenti LaTeX/TeX in PDF, XPS, SVG, PNG, JPEG, BMP, TIFF e altri formati di immagine senza richiedere alcuna distribuzione TeX esterna. Viene eseguito in-process ed è adatto per servizi Web, app desktop e generatori di report automatizzati.

D: Come installo AsposeTeXforPython?

R: Esegui pip install aspose-tex-python-net. Il pacchetto raggruppa automaticamente il runtime pythonnet richiesto. Installalo all’interno di qualsiasi ambiente virtuale (Windows, Linux, macOS) con Python 3.8 o successivo. Verificare l’installazione con:

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

D: Ho bisogno di una distribuzione TeX locale (MiKTeX, TeXLive, ecc.)?

R: No. Tutta la logica di analisi e rendering è integrata in AsposeTeX, quindi non è mai necessario un motore TeX esterno. La libreria include oltre 300 pacchetti LaTeX principali e file di classi comuni pronti all’uso.

D: Come posso convertire un file .tex in PDF con poche righe di codice?

R: Creare un TeXJob con la configurazione Object LaTeX, PdfSaveOptions e PdfDevice. Impostare ASPOSE_TEX_INPUT_FILE sul file LaTeX e ASPOSE_TEX_OUTPUT_DIR sulla directory di output, oppure modificare i percorsi nell’esempio. I valori predefiniti sono hello-world.ltx e output. Applicare prima una licenza. I file di input aggiuntivi vengono cercati accanto al documento principale; l’elaborazione non è interattiva. Licenze

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

Il nome di output segue quello di input: hello-world.ltx produce hello-world.pdf. LaTeX → PDF

D: Quali formati di output può generare AsposeTeXforPython?

R: PDF, XPS, SVG, PNG, JPEG, BMP e TIFF. Ogni formato può essere controllato tramite oggetti SaveOptions specifici (ad esempio, PdfSaveOptions, PngSaveOptions, SvgSaveOptions).

D: Come faccio a incorporare caratteri personalizzati nel PDF generato?

R: I caratteri vengono selezionati nel documento TeX o LaTeX e nei suoi pacchetti. Per le risorse, consultare i pacchetti LaTeX esterni. La proprietà subset_fonts di PdfSaveOptions controlla se incorporare solo i glifi utilizzati; non seleziona un carattere personalizzato. Consultare i sottoinsiemi di caratteri per un esempio XPS completo con la stessa opzione.

D: Quali pacchetti e classi LaTeX sono supportati immediatamente?

R: La libreria include pacchetti e classi LaTeX comuni. Consultare l’ elenco dei pacchetti incorporati. L’ esempio di pacchetti esterni fornisce i sorgenti di pgfplots tramite required_input_directory.

D: Come posso utilizzare un file .sty o di classe di terze parti che non sia integrato?

R: Impostare TeXOptions.required_input_directory su un InputFileSystemDirectory contenente i file del pacchetto. L’esempio completo carica fancybox.sty da ExternalLaTeXPackages/packages e converte required-input-fs.tex in PNG. Per gli archivi ZIP e i limiti di compatibilità, consultare i pacchetti LaTeX esterni.

Applicare prima una licenza. Impostare ASPOSE_TEX_INPUT_DIR sulla cartella contenente ExternalLaTeXPackages, con i due file .tex e la sottocartella packages (predefinita: input). Impostare ASPOSE_TEX_OUTPUT_DIR sulla cartella di output (predefinita: 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()

D: Quali sono i principali limiti del motore?

R:

Limitazione	Dettagli
Shell escape (\write18)	Disabilitato per motivi di sicurezza.
Esternalizzazione completa di TikZ	Non supportato; la maggior parte della grafica TikZ viene renderizzata in-process, ma i disegni estremamente complessi potrebbero non funzionare.
Copertura dei font Unicode	Sono completamente supportati solo i font TrueType/OpenType con set di glifi completi; i font Type1 legacy potrebbero richiedere la conversione.
Documenti molto grandi (>500 pagine)	Possono consumare molta memoria; si consiglia di eseguire lo streaming delle pagine con Document.save(output_stream, options).

D: Come posso applicare una chiave di licenza e quali modelli di licenza sono disponibili?

R: Applicare la licenza prima di utilizzare le altre classi Aspose.TeX. Impostare ASPOSE_TEX_PYTHON_NET_LICENSE_PATH sul percorso della licenza oppure collocare Aspose.TeX.Python-net.lic nella directory di lavoro.

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

Per esempi di licenze da file, da flusso e Metered e per i limiti della versione di valutazione, consultare Licenze.

D: La libreria è thread-safe per le conversioni parallele?

R: Sì, a condizione che ogni thread crei la propria istanza “Document”. Gli oggetti statici come la “Licenza” devono essere impostati prima che inizi qualsiasi lavoro parallelo.

D: Quale versione runtime .NET richiede AsposeTeXforPython?

R: Il pacchetto viene fornito con i file binari runtime .NET6 (x64). Vengono caricati automaticamente da Pythonnet alla prima importazione; non è necessario installare .NET manualmente.

D: Come posso impostare le dimensioni della pagina, l’orientamento e i DPI per gli output raster?

R: Definire dimensioni e orientamento della pagina nel sorgente LaTeX. Ad esempio, salvare questo documento A4 orizzontale come landscape.ltx:

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

Impostare PngSaveOptions.resolution prima di assegnare le opzioni di salvataggio al lavoro. Questo esempio usa 300 DPI. Impostare ASPOSE_TEX_INPUT_FILE su landscape.ltx e ASPOSE_TEX_OUTPUT_DIR sulla directory di output, oppure usare i percorsi predefiniti:

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

Il risultato è landscape.png, di circa 3508 × 2480 pixel.

D: Posso eseguire il rendering di LaTeX direttamente da una stringa o da un flusso in memoria?

R: Codificare un documento LaTeX completo in un flusso binario BytesIO e passarlo a TeXJob con TeXConfig.object_latex. Mantenere aperto il flusso durante il lavoro. Risultato: texput.xps e texput.log. Impostare ASPOSE_TEX_OUTPUT_DIR sulla directory di output (predefinita: output). Applicare prima una licenza. 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()

D: Dove posso trovare documentazione ufficiale, esempi di codice e canali di supporto?

R: Controlla le prossime risorse:

• Documentazione ufficiale
• Guida introduttiva
• Esempi di codice e sintesi di GitHub
• Forum di supporto
• Tracker dei problemi (privato per i clienti): fornito dopo l’acquisto

Tutti gli esempi sono disponibili sia in Python che in C#; il codice C# può essere tradotto direttamente grazie a pythonnet.