Pacotes de LaTeX externos | Python via .NET

Pacotes de LaTeX externos

A biblioteca Aspose.TeX vem com uma variedade de pacotes comuns de LaTeX, portanto não há necessidade de fornecer manualmente esses pacotes ao mecanismo TEX. No entanto, pode haver situações em que seu arquivo de LaTeX requer um pacote que não esteja incluído no “pacote” de pacotes da biblioteca. Nesses casos, você pode tentar fornecer a entrada necessária, como os arquivos de origem do pacote necessário, através da opção requerir_input_directory da instância da classe texoptions. Vamos explorar como isso funciona com dois exemplos.

Aplique primeiro uma licença. Defina ASPOSE_TEX_INPUT_DIR como a pasta que contém ExternalLaTeXPackages, com os dois arquivos .tex e o subdiretório packages (padrão: input). Defina ASPOSE_TEX_OUTPUT_DIR como a pasta de saída (padrão: output).

Entrada necessária fornecida em um formulário não embalado (o pacote FancyBox).

Suponha que tenhamos o seguinte arquivo BASIC LATEX chamado requerir-input-f-fs.tex, que faz parte da nossa Solução de Exemplo:

\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}

A terceira linha do arquivo indica que requer o pacote FancyBox, que não está incluído no suporte" nativo “. Vamos supor que temos o arquivo de origem do pacote FancyBox. Como é um pacote simples composto por um único arquivo, podemos colocar esse arquivo em qualquer lugar do nosso sistema de arquivos e especificar o caminho do diretório da seguinte forma:

from aspose.tex.io import InputFileSystemDirectory

# Configure an existing TeXOptions instance.
options.required_input_directory = InputFileSystemDirectory('path-to-directory-where-fancybox.sty-located')

Depois de executar um trabalho de Tex com esta opção (lembre -se de ajustar as outras opções conforme necessário), obteremos o documento de saída, que neste caso é uma imagem PNG.

Aqui está o código -fonte completo para o exemplo:

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

Fornecendo entrada necessária em um formulário arquivado (o pacote pgfplots)

Agora, suponha que tenhamos o seguinte arquivo LATEX chamado requerir-in-zip.tex, que também é um arquivo simples da nossa solução de exemplo:

\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}

Na terceira linha, pode -se observar que o arquivo requer o pacote pgfplots, que não é suportado” nativamente “. Mais uma vez, assumindo que possuímos os arquivos de origem para o pacote PGFPLOTS, esses arquivos são bastante numerosos e estão localizados em dois diretórios diferentes no diretório de instalação de qualquer aplicativo de tipógrafo de LaTeX. A pasta pgfplots pode ser encontrada nos diretórios\tex \generic e \tex \latex. Para que a biblioteca Aspose.TeX funcione corretamente, é necessário fornecer o conteúdo dessas duas pastas como entrada. Para conseguir isso, desejamos empacotar esses arquivos de origem em um arquivo zip. Abaixo está o layout desejado do arquivo:

E aqui está o método pelo qual definimos a acessibilidade a esses arquivos de origem:

from aspose.tex.io import InputZipDirectory

# Configure an existing TeXOptions instance and run the job while the stream is open.
with open("path-to-zip-with-pgfplots-sources", "rb") as zip_stream:
    options.required_input_directory = InputZipDirectory(zip_stream, "")
    # Run TeXJob here, as shown in the complete example below.

Depois de executar um trabalho de Tex com esta opção, obtemos o documento de saída:

Aqui está o código -fonte completo para o exemplo:

# Load external LaTeX packages from a ZIP archive.
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))
# 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(str(input_dir), "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(str(input_dir), "required-input-zip.tex"), ImageDevice(True), options).run()

NOTA: O resultado foi verificado através do pacote pgfplots versão 1.18.1. Quanto à versão do pacote pfg incluída na biblioteca Aspose.TeX é a 3.1.9a.

Restrições

Se você se deparar com um pacote desenvolvido noLatex3ekernel e for necessário pelo seu arquivo LaTex, é improvável que trabalhe com a biblioteca Aspose.TeX. Isso ocorre porque a biblioteca é baseada no kernel LATEX2E.

Além disso, pode haver casos em que um pacote exigido pelo seu arquivo de LaTeX use diretamente comandos primitivos dependentes do dispositivo que não são suportados pelo mecanismo aspose.tex da biblioteca tex. Nesses casos, o pacote não funcionará com a biblioteca.