外部乳胶软件包| Java的Aspose.TeX

外部乳胶软件包

Aspose.TeX库中包含许多 常见的乳胶软件包。因此，您不必关心如何将这些包装提供给图书馆的Tex引擎。但是有时(可能经常)您的乳胶文件可能需要一个包裹以外的包装包装。在这种情况下，您可以尝试使用 setRequiredInputDirectory() TexOptions类实例的方法提供所需的输入，即所需的软件包的源文件。我们将看到这两个示例如何工作。

打开包装所需的输入(fancybox软件包)

假设我们有以下简单的乳胶文件，这是我们的 示例解决方案：

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

在第三行上，我们看到该文件需要“ fancybox”软件包，而不是“本地”支持。我们还假设我们有“ fancybox”软件包源文件。这是一个简单的软件包，因此它实际上仅由一个文件组成。我们可以将此文件放置在文件系统中的任何位置，并简单地指定目录路径：

options.setRequiredInputDirectory(new InputFileSystemDirectory("path-to-directory-where-fancybox.sty-located"));

使用此选项运行Tex作业(不要忘记根据需要调整其他选项)后，我们将获得输出文档(即PNG图像)。

这是该示例的完整源代码：

// Create conversion options for Object LaTeX format upon Object TeX engine extension.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
// Specify a file system working directory for the output.
options.setOutputWorkingDirectory(new OutputFileSystemDirectory(Utils.getOutputDirectory()));
// Specify a file system working directory for the required input.
// The directory containing packages may be located anywhere.
options.setRequiredInputDirectory(new InputFileSystemDirectory(Utils.getInputDirectory() + "packages"));
// Initialize the options for saving in PNG format.
options.setSaveOptions(new PngSaveOptions());
// Run LaTeX to PNG conversion.
new TeXJob(Utils.getInputDirectory() + "required-input-fs.tex", new ImageDevice(), options).run();

存档所需的输入(pgfplots软件包)

现在，让我们假设我们也有以下简单的乳胶文件，这是我们的示例解决方案中的“必需输入” zip.tex。

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

在第三行上，我们看到该文件需要“ PGFPLOTS”软件包，这也不是“本地”支持的。同样，我们假设我们有“ PGFPLOTS”软件包源文件。如果您在任何乳胶排放应用程序的安装目录中找到两个位置，则在两个位置之间进行了大量文件。您可以在\ tex \ generic和\ tex \ latex文件夹上找到pgfplots文件夹。并且必须根据需要输入Aspose.TeX库提供两个文件夹的内容。我们希望将这些源文件包装在zip存档中，因此这是存档的布局：

这是我们指定对这些源文件的访问的方式：

final Stream zipStream = File.Open("path-to-zip-with-pgfplots-sources"), FileMode.Open))
try {
    ...
    options.setRequiredInputDirectory(new InputZipDirectory(zipStream));
    ...
} finally {
    if (zipStream != null)
        zipStream.close();
}

通过此选项运行Tex作业后，我们将获得输出文档：

这是该示例的完整源代码：

// Create conversion options for Object LaTeX format upon Object TeX engine extension.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
// Specify a file system working directory for the output.
options.setOutputWorkingDirectory(new OutputFileSystemDirectory(Utils.getOutputDirectory()));
// Initialize the options for saving in PNG format.
options.setSaveOptions(new PngSaveOptions());
// Create a file stream for the ZIP archive containing the required package.
// The ZIP archive may be located anywhere.
final InputStream stream = new FileInputStream(Utils.getInputDirectory() + "packages\\pgfplots.zip");
try {
    // Specify a ZIP working directory for the required input.
    options.setRequiredInputDirectory(new InputZipDirectory(stream, ""));
    
    // Run LaTeX to PNG conversion.
    new TeXJob(Utils.getInputDirectory() + "required-input-zip.tex", new ImageDevice(), options).run();
} finally {
    if (stream != null)
        stream.close();
}

注意： 结果是使用 pgfplots 软件包版本 1.18.1 验证的。而 Aspose.TeX 库中包含的 pfg 软件包版本为 3.1.9a。

使用外部字体软件包

通常，乳胶发行版带有一系列可用于排版的默认字体。除了这些字体外，Aspose.TeX还提供几个非标准字体软件包，例如“ amsfonts”，“ eurosym”和“ wasysym”。如前所述，Aspose.TeX也支持使用外部软件包的使用，尽管我们的重点主要集中在不包括字体的软件包上。 Aspose.TeX中的对象Tex引擎扩展名需要字体映射，它是带有.map扩展名的文本文件，该文件指定了与每个Tex的内部字体名称相对应的物理字体。这些字体地图需要在初始化阶段加载到TEX的内存中，并且必须包含在软件包文件中。由于引擎不知道所有字体映射的名称，因此它搜索了具有`.map’扩展名的任何文件。因此，将 IinputWorkingDirectory用作 InsultInputDirectory选项的接口的实现必须提供一种基于其扩展名的访问文件名的收集的方法。具体而言，此实现还必须实现 IfileCollector接口。标准实现， InputFileSystemDirectory和 InputzipDirectory，已经满足此要求。

下面，我们提供一个自定义所需输入目录的示例，该目录还实现了 IfileCollector接口。我们的主要重点是根据其扩展名来收集文件名，我们故意省略了文件存储和检索的详细信息。

// This is an implementation of IInputWorkingDirectory that is suitable for the TeX job's RequiredInputDirectory option
// in case required input contains fonts provided by external packages.
// The class additionally implements IFileCollector, which provides access to file collections by extension.
// This is necessary to load external font maps, which are files (outside TeX syntax) that map TeX's
public class RequiredInputDirectory implements IInputWorkingDirectory, IFileCollector
{
    private Map<String, Map<String, String>> _fileNames = new HashMap<String, Map<String, String>>();

    public RequiredInputDirectory()
    { 
    }

    // This method should preliminarily be called for each file entry that is supposed to be located inside
    // the required input directory. Inside is an example of how the dictionary of file names could be organized
    // for easy collection of file names by extension.
    // Here fileName is a full file name. This can be a file path on a file system, a URL, or whatever else (theoretically).
    public void storeFileName(String fileName)
    {
        String extension = getExtension(fileName);
        String name = getFileNameWithoutExtension(fileName);

        Map<String, String> files = _fileNames.get(extension);
        if (files == null)
            _fileNames.put(extension, files = new HashMap<String, String>());

        files.put(name, fileName);
    }

    // The IInputWorkingDirectory implementation.
    public TeXInputStream getFile(String fileName, boolean searchSubdirectories)
    {
        return new TeXInputStream(null, fileName); // Here we actually return a stream for the file requested by its name.
    }
    
    // Here is how we gather file collections by extension.
    public String[] getFileNamesByExtension(String extension)
    {
    	return getFileNamesByExtension(extension, null);
    }

    // Here is how we gather file collections by extension.
    public String[] getFileNamesByExtension(String extension, String path)
    {
        Map<String, String> files = _fileNames.get(extension);
        if (files == null)
            return new String[0];
        
        return files.values().toArray(new String[0]);
    }
    
    private String getExtension(String fileName)
    {
    	int pos = fileName.indexOf('.');
    	if (pos < 0)
    		return "";
    	
    	return fileName.substring(pos);
    }
    
    private String getFileNameWithoutExtension(String fileName)
    {
    	int pos = fileName.lastIndexOf('/');
    	if (pos >= 0)
    		fileName = fileName.substring(pos + 1);
    	
    	pos = fileName.indexOf('.');
    	if (pos < 0)
    		return fileName;
    	
    	return fileName.substring(0, pos);
    }

    public void close()
    {
        _fileNames.clear();
    }
}

限制

您的乳胶文件要求的包装可以在 * latex3e 内核下开发。这样的软件包很可能无法与Aspose.TeX库一起使用，因为后者基于lastx2e*内核。

此外，您的乳胶文件要求的软件包可以直接调用Aspose.TeX库对象Tex引擎不支持的设备依赖的原始命令。不幸的是，这样的软件包无法确定。