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 上進行了測試。
  • 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 授權。