IguanaTex

伊瓜纳特克斯

(C) Jonathan Le Roux 和 Zvika Ben-Haim (Windows)、Tsung-Ju Jiang 和 Jonathan Le Roux (Mac)

网站：https://www.jonathanleroux.org/software/iguanatex/

IguanaTex 是一个 PowerPoint 插件，可让您将 LaTeX 方程插入到 Windows 和 Mac 上的 PowerPoint 演示文稿中。它及其源代码完全免费分发。

该存储库以易于跟踪、共享和讨论的形式托管源代码（VBA 代码使用 ExportVBA 宏导出）。

系统要求

视窗

• 操作系统：Windows 2000 或更高版本（32 位或 64 位）。
• 微软幻灯片软件：
  • IguanaTex 已在 PowerPoint 2010、2013、2016、2019（32 位和 64 位）、Office 365 和 PowerPoint 2003 上进行了测试。它可能也适用于 PowerPoint 2000 和 2007。
  • SVG 支持适用于 Office 365 和最新零售版本的 PowerPoint。已确认至少支持 PowerPoint 2021 版本 2108 及更高版本，并且可能（尽管未经确认）支持 PowerPoint 2019，甚至可能支持相同版本的 PowerPoint 2016。请注意，截至 2023 年 8 月，批量许可版本为版本 1808，不支持 IguanaTex 所需的 SVG 转换为 Shape。
• LaTeX：TeXLive 或 MiKTeX
• GhostScript（如果最新版本出现问题，请尝试 gs9.26）
• 图像魔术师
• （可选）TeX2img，用于通过 EMF（下载）输出矢量图形。

苹果

• 英特尔或苹果芯片 Mac
  • 在基于 Apple Silicon 的 Mac 上，PowerPoint 需要使用“使用 Rosetta 打开”设置来运行。
• 适用于 Mac 的 PowerPoint：
  • Powerpoint 2019 或 Office 365
  • PowerPoint 2016（版本 16.16.7 190210 或更高版本）（待确认；某些功能（例如 SVG）可能无法使用）
• MacTeX：确保安装libgs以支持 SVG，方法是在 MacTex 安装程序的“安装类型”步骤中选择“自定义”。 （初次安装后我还没有找到通过 TexLive 安装 libgs 的方法，如果你知道请告诉我）

下载并安装

视窗

1. 从此存储库的发布页面或 IguanaTex 下载页面下载 .ppam 加载项文件，并将其保存在受信任位置（请参阅此 Microsoft 文章），例如%appdata%MicrosoftAddins （即C:Usersuser_nameAppdataRoamingMicrosoftAddins ）。
2. 加载加载项：在“文件”>“选项”>“加载项”>“管理：”（窗口下部）中，在选择框中选择“PowerPoint 加载项”。然后按“Go...”，然后单击“Add New”，选择您下载的文件夹中的.ppam文件，然后“Close”（如果您下载了 .pptm 源并将其另存为.ppam ，它将位于默认的加载项文件夹中）。
3. 创建并设置临时文件夹：IguanaTex 需要访问具有读/写权限的文件夹来存储临时文件。
   • 默认值为“C:Temp”。如果您在“C:”下具有写入权限，请创建文件夹“C:Temp”。你已经准备好了。
   • 如果无法创建此文件夹，请在任何其他位置选择或创建具有写入权限的文件夹。在 IguanaTex 选项卡中，选择“主要设置”并将路径放入您选择的文件夹中。您还可以使用演示文稿文件夹下的相对路径（例如，“.”表示演示文稿文件夹本身）。
4. 安装并设置 GhostScript 和 ImageMagick 的路径（图片输出需要，除非使用“Latex (DVI)”引擎）：
   • 在作为 Picture 对象插入 PowerPoint 之前，需要将中间 PDF 文件转换为 PNG。在图片生成过程中，除了“Latex (DVI)”之外的所有LaTeX引擎都输出PDF文件。即使在生成形状时，通常最好先生成图片，然后转换为形状：图片生成速度更快、更稳健，因此可以方便地在图片模式下在显示器上工作，然后最终转换为形状，保留尺寸。
   • 在“主设置”窗口中设置gswin32c.exe或gswin64c.exe （注意“ c ”！）以及 ImageMagick 的 magick.exe 的完整路径。
   • 确保路径正确的最佳方法是使用每个路径旁边的“...”按钮并导航到正确的文件。
   • 一些默认路径包括%USERPROFILE% 。建议单击“...”以确保路径正确转换为实际的用户配置文件路径。
5. （可选）安装并设置 TeX2img 的路径：
   • 仅需要通过 EMF 支持矢量图形（与 SVG 相比，EMF 的优点是：适用于所有 PowerPoint 版本，完全可修改形状；缺点：某些显示会随机出现扭曲）
   • 从此链接下载（有关 TeX2img 的更多详细信息，请参见其 Github 存储库）
   • 将 TeX2img 解压到计算机上的某个位置后，运行一次 TeX2img.exe，让它自动设置 Latex/ghostscript 的各种路径，然后在“主设置”窗口中设置TeX2imgc.exe的完整路径（注意“ c ”！） 。
6. （可选）安装 LaTeXiT-metadata ：
   • 需要将 Mac 上使用 LaTeXiT 生成的显示转换为 IguanaTex 显示
   • 从Releases页面下载LaTeXiT-metadata-Win.zip ，解压，并在“主设置”窗口中设置LaTeXiT-metadata.exe的路径。
   • LaTeXiT 元数据是由 LaTeXiT 的作者 Pierre Chatelier 应我的要求精心准备的。非常感谢他！
   • 源代码现已公开。

其他设置：

• 如果您安装的是非标准 LaTeX，则可以在主设置中指定包含可执行文件的文件夹。
• 如果您希望选择使用外部编辑器，例如在调试 LaTeX 源代码时，您可以在“主要设置”中指定该编辑器的路径。如果您想在 IguanaTex 编辑窗口中默认使用该编辑器，请选中“用作默认值”复选框。

苹果

使用 Homebrew 自动安装

如果您使用 Homebrew，安装非常简单：

brew tap tsung-ju/iguanatexmac
brew install --cask --no-quarantine iguanatexmac latexit-metadata

然后按照下面的手动安装说明中的5. 验证路径设置是否正确。

有关更多详细信息（例如，如何升级或卸载），请参阅 Tsung-Ju 的 Homebrew 说明。

手动安装

1. 从此存储库的发布页面下载“Mac 的预构建文件”zip
   有3个文件需要安装：

   • IguanaTex.scpt ：用于处理文件和文件夹访问的 AppleScript 文件
   • libIguanaTexHelper.dylib ：用于创建本机文本视图的库；源代码包含在 git 存储库中的“IguanaTexHelper/”下
   • IguanaTex_v1_XX_Y.ppam ：主插件文件

2. 安装IguanaTex.scpt

mkdir -p ~ /Library/Application  Scripts/com.microsoft.Powerpoint
cp ./IguanaTex.scpt ~ /Library/Application  Scripts/com.microsoft.Powerpoint/IguanaTex.scpt

3. 安装libIguanaTexHelper.dylib

sudo mkdir -p ' /Library/Application Support/Microsoft/Office365/User Content.localized/Add-Ins.localized '
sudo cp ./libIguanaTexHelper.dylib ' /Library/Application Support/Microsoft/Office365/User Content.localized/Add-Ins.localized/libIguanaTexHelper.dylib '

4. 加载加载项：启动 PowerPoint（如果在安装 dylib 时正在运行，则重新启动）。从菜单栏中选择“工具”>“PowerPoint 加载项...”>“+”，然后选择IguanaTex_v1_XX_Y.ppam

   • 第一次单击某个加载项按钮时，您可能会收到libIguanaTexHelper.dylib被阻止的通知。转到 Mac 的“设置”，然后转到“安全和隐私”，然后单击“仍然允许”。

5. 验证路径设置是否正确：

   • 单击 IguanaTex 功能区选项卡中的“主要设置”，然后通过单击旁边的每个“...”按钮来验证 GhostScript、LaTeX 二进制文件和 libgs.9.dylib（在 SVG 转换中使用）的路径设置是否正确。他们：如果路径正确，这应该将您带到它的位置；否则，您需要导航到相关路径。默认值应与 MacTex 安装位置匹配，但您的安装可能会有所不同。
   • 如果您找不到它们或者 IguanaTex 抱怨命令没有返回，请打开终端并使用locate gs 、 locate pdflatex和locate libgs 。

6. （可选）安装 LaTeXiT-metadata ：

   • 需要将 Mac 上使用 LaTeXiT 生成的显示转换为 IguanaTex 显示
   • 从发布页面下载LaTeXiT-metadata-macos ，添加可执行权限，然后在“主要设置”窗口中设置其位置的路径或将其复制到安全加载项文件夹：
     chmod 755 ./LaTeXiT-metadata-macos
sudo cp ./LaTeXiT-metadata-macos '/Library/Application Support/Microsoft/Office365/User Content.localized/Add-Ins.localized/'
   • IguanaTex 第一次调用 LaTeXiT-metadata-macos 时，Mac OS 可能会阻止它。转到 Mac 的“设置”，然后转到“安全和隐私”，然后单击“仍然允许”。
   • 该可执行文件是在 Mac OS 10.13 上编译的，但应该适用于所有版本。如果您有任何问题，请告诉我。
   • LaTeXiT 元数据是由 LaTeXiT 的作者 Pierre Chatelier 应我的要求精心准备的。非常感谢他！
   • 源代码现已公开。

不明显的技巧

IguanaTex 的用法大部分应该是不言自明的，但有一些提示和技巧可能不是。

• 加速键（即键盘快捷键）：许多 IguanaTex 的命令（“生成”、“取消”等）可以通过使用修饰键和单个字母的组合来访问。在相应按钮的文本/标签中查找带下划线的字母。
• Windows：Alt + 字母。例如，不要单击“ G生成”按钮，您可以使用Alt + g 。（这是 Windows 上的标准 Office 行为）
• Mac：Ctrl + Cmd + 字母。例如，不要单击“ G enerate”按钮，您可以使用Ctrl + Cmd + g 。（加速键在标准 Office for Mac 中不可用，这是 Tsung-Ju 为 IguanaTex 专门编码的）

已知问题

• 在 Mac 上创建的“图片”显示（插入的 PDF）周围有一个小的额外边距，这样它们在 Windows 上就不会被裁剪。在早期版本中，没有边距，但显示内容会被裁剪。这似乎是 PowerPoint 在 Mac 上处理某些 PDF（在内部将它们存储为 EMF 文件）的方式的错误。然而，LaTeXiT 创建的 PDF 不存在这个问题，因此在 IguanaTex 的未来版本中可能有办法规避这个错误。
• IguanaTex 宏无法添加到 Mac 上的快速访问工具栏：这是一个已知错误，据称 Microsoft 正在修复该错误。
• 更改文件格式（图片 <-> 形状，甚至在各种 SVG 和 EMF 形状格式中）时可能会出现一些缩放问题。处理此问题的最佳方法是使用“转换为形状”/“转换为图片”功能，它们以所需的格式重新生成显示，同时保持大小固定。如果需要的话，可以进一步修改内容，缩放比例就会正确。
• 对于形状（即矢量图形）显示，建议使用默认的“SVG via DVI w/ dvisvgm”，因为有时会在其他模式中观察到问题：
  • 通过“EMF w/ TeX2img”或“EMF w/ pdfiumdraw”获得的某些显示出现扭曲。这是一个 PowerPoint 错误，在将 EMF 文件取消分组为 Shape 对象时有时会发生。
  • 使用“SVG via PDF w/ dvisvgm”获得的某些显示缺少符号或部分符号。这是因为某些线条在 PDF 中由具有特定线宽的开放路径而不是闭合路径表示，因此在转换为 Shape 对象时 PowerPoint 的处理方式有所不同。有关更多详细信息，请参阅此讨论。

执照

本作品根据 Creative Commons Attribution 3.0 Unported License 获得许可。