Pacotes de LaTeX externos | Python

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.

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:

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:

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

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:

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

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:

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

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.