イグアナテックス
(C) Jonathan Le Roux および Zvika Ben-Haim (Windows)、Tsung-Ju Chiang および Jonathan Le Roux (Mac)
ウェブサイト: https://www.jonathanleroux.org/software/iguanatex/
IguanaTex は、Windows および Mac 上の PowerPoint プレゼンテーションに LaTeX 方程式を挿入できる PowerPoint アドインです。ソースコードとともに完全に無料で配布されています。
このリポジトリは、簡単に追跡、共有、議論できる形式でソース コードをホストします (VBA コードは ExportVBA マクロを使用してエクスポートされます)。
システム要件
窓
- OS: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 経由のベクトル グラフィックス出力に使用されます (ダウンロード)。
マック
- インテルまたは Apple Silicon Mac
- Apple Silicon ベースの Mac では、PowerPoint を「Rosetta を使用して開く」設定で実行する必要があります。
- Mac 用 PowerPoint:
- パワーポイント 2019 または Office 365
- PowerPoint 2016 (バージョン 16.16.7 190210 以降) (未確認。SVG などの一部の機能が動作しない可能性があります)
- MacTeX: MacTex インストーラーの「インストール タイプ」ステップで「カスタマイズ」を選択して、SVG サポート用の
libgs
インストールしてください。 (初期インストール後に TexLive 経由で libgs をインストールする方法が見つかりませんでした。ご存知の場合はお知らせください)
ダウンロードしてインストールする
窓
- このリポジトリのリリース ページまたは IguanaTex ダウンロード ページから.ppam アドイン ファイルをダウンロードし、
%appdata%MicrosoftAddins
(つまり、 C:Usersuser_nameAppdataRoamingMicrosoftAddins
などの信頼できる場所 (Microsoft の記事を参照) に保存します。 C:Usersuser_nameAppdataRoamingMicrosoftAddins
)。 - アドインをロードします。 [ファイル] > [オプション] > [アドイン] > [管理:] (ウィンドウの下部) で、選択ボックスで [PowerPoint アドイン] を選択します。次に、「Go...」を押し、「新規追加」をクリックし、ダウンロードしたフォルダー内の
.ppam
ファイルを選択して、「閉じる」をクリックします (.pptm ソースをダウンロードして.ppam
として保存した場合は、デフォルトのアドイン フォルダーにあります)。 - 一時ファイル フォルダーを作成して設定する: IguanaTex は、一時ファイルを保存するために読み取り/書き込み権限を持つフォルダーにアクセスする必要があります。
- デフォルトは「C:Temp」です。 「C:」に書き込み権限がある場合は、「C:Temp」フォルダを作成します。準備は完了です。
- このフォルダーを作成できない場合は、他の場所に書き込み権限を持つフォルダーを選択するか作成してください。 [IguanaTex] タブで、[メイン設定] を選択し、選択したフォルダーへのパスを入力します。プレゼンテーションのフォルダーの下で相対パスを使用することもできます (たとえば、プレゼンテーション フォルダー自体の場合は「.」)。
- GhostScript と ImageMagick をインストールしてパスを設定します(「Latex (DVI)」エンジンを使用する場合を除き、画像出力に必要です)。
- PowerPoint に Picture オブジェクトとして挿入する前に、中間 PDF ファイルを PNG に変換する必要があります。画像生成プロセスでは、「Latex (DVI)」を除くすべての LaTeX エンジンが PDF ファイルを出力します。シェイプを生成する場合でも、多くの場合、最初にピクチャを生成してからシェイプに変換する方が適切です。ピクチャの生成は高速かつ堅牢であるため、ピクチャ モードでディスプレイ上で作業してから、シェイプへの最終変換を行って形状を維持すると便利です。サイズ。
- 「メイン設定」ウィンドウで、絶対パスを
gswin32c.exe
またはgswin64c.exe
(「 c
」に注意してください!) と ImageMagick の magick.exe に設定します。 - パスが正しいことを確認する最善の方法は、各パスの横にある「...」ボタンを使用して、正しいファイルに移動することです。
- 一部のデフォルトのパスには
%USERPROFILE%
が含まれます。 「...」をクリックして、パスが実際のユーザー プロファイル パスに適切に変換されていることを確認することをお勧めします。
- (オプション) TeX2img をインストールしてパスを設定します。
- EMF によるベクター グラフィックス サポートの場合にのみ必要です (SVG と比較して、EMF の長所は次のとおりです: すべての PowerPoint バージョンで利用可能、完全に形状を変更可能。短所: 一部のディスプレイではランダムに歪みが発生します)
- このリンクからダウンロードします (TeX2img の詳細は Github リポジトリにあります)
- TeX2img をマシン上のどこかに解凍した後、TeX2img.exe を 1 回実行して、latex/ghostscript へのさまざまなパスを自動的に設定してから、[メイン設定] ウィンドウで完全なパスを
TeX2imgc.exe
(「 c
」に注意してください!) に設定します。 。
- (オプション) LaTeXiT メタデータをインストールします。
- Mac 上の LaTeXiT で生成されたディスプレイを IguanaTex ディスプレイに変換するために必要
- リリース ページから
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 の説明を参照してください。
手動インストール
このリポジトリのリリース ページから「Mac 用のビルド済みファイル」zip をダウンロードします。
インストールするファイルは 3 つあります。
-
IguanaTex.scpt
: ファイルとフォルダーへのアクセスを処理するための AppleScript ファイル libIguanaTexHelper.dylib
: ネイティブ テキスト ビューを作成するためのライブラリ。 git リポジトリに含まれるソース コード (「IguanaTexHelper/」の下)-
IguanaTex_v1_XX_Y.ppam
: メインのアドイン ファイル
IguanaTex.scpt
をインストールする
mkdir -p ~ /Library/Application Scripts/com.microsoft.Powerpoint
cp ./IguanaTex.scpt ~ /Library/Application Scripts/com.microsoft.Powerpoint/IguanaTex.scpt
-
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 '
アドインをロードします: PowerPoint を起動します (dylib のインストール時に実行されていた場合は再起動します)。メニュー バーから、 [ツール] > [PowerPoint アドイン...] > ['+'] を選択し、 IguanaTex_v1_XX_Y.ppam
を選択します。
- 初めてアドイン ボタンのいずれかをクリックすると、
libIguanaTexHelper.dylib
がブロックされたことが通知される場合があります。 Mac の [設定]、[セキュリティとプライバシー] の順に移動し、[とにかく許可] をクリックします。
パスが正しく設定されていることを確認します。
- IguanaTex リボン タブの [メイン設定] をクリックし、GhostScript、LaTeX バイナリ、および libgs.9.dylib (SVG 変換で使用される) へのパスが正しく設定されていることを確認します。彼ら: パスが正しい場合は、その場所に移動するはずです。それ以外の場合は、関連するパスに移動する必要があります。デフォルトは MacTex のインストール場所と一致する必要がありますが、実際のインストールは異なる場合があります。
- それらが見つからない場合、またはコマンドが返されなかったと IguanaTex が文句を言う場合は、ターミナルを開いて、
locate gs
、 locate pdflatex
、およびlocate libgs
を使用します。
(オプション) LaTeXiT メタデータをインストールします。
- 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/'
- LaTeXiT-metadata-macos が IguanaTex によって初めて呼び出されるとき、Mac OS がそれをブロックする可能性があります。 Mac の [設定]、[セキュリティとプライバシー] の順に移動し、[とにかく許可] をクリックします。
- 実行可能ファイルは Mac OS 10.13 でコンパイルされましたが、すべてのバージョンで動作するはずです。何か問題がございましたらお知らせください。
- LaTeXiT メタデータは、私のリクエストに応じて、LaTeXiT の作者である Pierre Chatelier が親切にも作成してくれました。彼に感謝します!
- ソースコードが公開されました。
自明ではないトリック
IguanaTex の使用法はほとんど自明ですが、理解できないヒントやコツがいくつかあります。
- アクセラレータ キー (つまり、キーボード ショートカット): IguanaTex のコマンド (「生成」、「キャンセル」など) の多くは、修飾キーと 1 つの文字の組み合わせを使用してアクセスできます。対応するボタンのテキスト/ラベルで下線付きの文字を探します。
- 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 形状形式内) を変更すると、スケーリングの問題が発生する可能性があります。これに対処する最善の方法は、サイズを固定したまま希望のフォーマットで表示を再生成する「シェイプに変換」/「ピクチャに変換」機能を使用することです。必要に応じてコンテンツをさらに変更すると、スケーリングが正しくなります。
- Shape (つまり、ベクトル グラフィックス) ディスプレイの場合は、他のモードで時々問題が発生するため、デフォルトの「SVG via DVI w/ dvisvgm」が推奨されます。
- 「EMF w/ TeX2img」または「EMF w/ pdfiumdraw」で取得した一部の表示は歪んで見えます。これは、EMF ファイルを Shape オブジェクトにグループ化解除するときに発生することがある PowerPoint のバグです。
- 「SVG via PDF w/ dvisvgm」で取得した一部の表示には、シンボルまたはシンボルの一部が欠落しています。これは、PDF では特定の線が閉じたパスではなく、特定の線幅を持つ開いたパスによって表現されるため、Shape オブジェクトに変換するときに PowerPoint によって異なる処理が行われるためです。詳細については、このディスカッションを参照してください。
ライセンス
この作品は、クリエイティブ コモンズ表示 3.0 非移植ライセンスに基づいてライセンスされています。