IguanaTex Download - IguanaTex Quellcode herunterladen

IguanaTex

Anderer Quellcode

v1.61

Herunterladen

LeguanTex

(C) Jonathan Le Roux und Zvika Ben-Haim (Windows), Tsung-Ju Chiang und Jonathan Le Roux (Mac)

Website: https://www.jonathanleroux.org/software/iguanatex/

IguanaTex ist ein PowerPoint-Add-In, mit dem Sie LaTeX-Gleichungen in Ihre PowerPoint-Präsentation unter Windows und Mac einfügen können. Es wird zusammen mit seinem Quellcode völlig kostenlos verteilt.

Dieses Repository hostet den Quellcode in einer Form, die leicht verfolgt, geteilt und diskutiert werden kann (der VBA-Code wird mit dem ExportVBA-Makro exportiert).

Systemanforderungen

Windows

Betriebssystem: Windows 2000 oder höher (32- oder 64-Bit).
Steckdose:
- IguanaTex wurde mit PowerPoint 2010, 2013, 2016, 2019 (sowohl 32 als auch 64 Bit), Office 365 und PowerPoint 2003 getestet. Es funktioniert wahrscheinlich auch in PowerPoint 2000 und 2007.
- SVG-Unterstützung ist für Office 365 und aktuelle Einzelhandelsversionen von PowerPoint verfügbar. Die Unterstützung für PowerPoint 2021 ist zumindest für die Versionen 2108 und höher bestätigt und wahrscheinlich (wenn auch unbestätigt) für PowerPoint 2019 und möglicherweise sogar PowerPoint 2016 für dieselben Versionen. Beachten Sie, dass volumenlizenzierte Versionen, die ab August 2023 die Version 1808 haben, die von IguanaTex benötigte SVG-Konvertierung in Shape nicht unterstützen.
LaTeX: TeXLive oder MiKTeX
GhostScript (wenn die neueste Version Probleme verursacht, versuchen Sie es mit gs9.26)
ImageMagick
(Optional) TeX2img, wird für die Ausgabe von Vektorgrafiken über EMF verwendet (Download).

Mac

Intel oder Apple Silicon Mac
- Auf Apple Silicon-basierten Macs muss PowerPoint mit der Einstellung „Mit Rosetta öffnen“ ausgeführt werden.
PowerPoint für Mac:
- Powerpoint 2019 oder Office 365
- PowerPoint 2016 (Version 16.16.7 190210 oder höher) (noch zu bestätigen; einige Funktionen, z. B. SVG, funktionieren möglicherweise nicht)
MacTeX: Stellen Sie sicher, dass Sie libgs für die SVG-Unterstützung installieren, indem Sie im Schritt „Installationstyp“ des MacTex-Installationsprogramms „Anpassen“ auswählen. (Ich habe nach der Erstinstallation keine Möglichkeit gefunden, libgs über TexLive zu installieren. Wenn Sie eine kennen, lassen Sie es mich bitte wissen.)

Herunterladen und installieren

Windows

Laden Sie die .ppam-Add-In- Datei von der Release-Seite dieses Repositorys oder von der IguanaTex-Download-Seite herunter und speichern Sie sie an einem vertrauenswürdigen Speicherort (siehe diesen Microsoft-Artikel), z. B. %appdata%MicrosoftAddins (d. h. C:Usersuser_nameAppdataRoamingMicrosoftAddins ).
Laden Sie das Add-In : Wählen Sie unter „Datei“ > „Optionen“ > „Add-Ins“ > „Verwalten:“ (unterer Teil des Fensters) im Auswahlfeld „PowerPoint-Add-Ins“. Klicken Sie dann auf „Los...“, dann auf „Neu hinzufügen“, wählen Sie die .ppam Datei in dem Ordner aus, in den Sie sie heruntergeladen haben, und klicken Sie dann auf „Schließen“ (wenn Sie die .pptm-Quelle heruntergeladen und als .ppam gespeichert haben, wird dies der Fall sein sich im Standard-Add-In-Ordner befinden).
Erstellen Sie einen temporären Dateiordner und legen Sie ihn fest : IguanaTex benötigt Zugriff auf einen Ordner mit Lese-/Schreibberechtigungen, um temporäre Dateien zu speichern.
- Der Standardwert ist „C:Temp“. Wenn Sie Schreibrechte unter „C:“ haben, erstellen Sie den Ordner „C:Temp“. Sie sind bereit.
- Wenn Sie diesen Ordner nicht erstellen können, wählen oder erstellen Sie einen Ordner mit Schreibberechtigung an einem anderen Ort. Wählen Sie im IguanaTex-Tab „Haupteinstellungen“ und geben Sie den Pfad zum Ordner Ihrer Wahl ein. Sie können auch einen relativen Pfad unter dem Präsentationsordner verwenden (z. B. „.“ für den Präsentationsordner selbst).
Installieren und legen Sie den Pfad zu GhostScript und ImageMagick fest (erforderlich für Bildausgaben, außer bei Verwendung der „Latex (DVI)“-Engine):
- Wird benötigt, um PDF-Zwischendateien in PNG zu konvertieren, bevor sie als Bildobjekt in PowerPoint eingefügt werden. Bei der Bildgenerierung geben alle LaTeX-Engines außer „Latex (DVI)“ PDF-Dateien aus. Selbst beim Generieren einer Form ist es oft besser, zuerst ein Bild zu generieren und dann in eine Form zu konvertieren: Die Bilderzeugung ist schneller und robuster, daher kann es praktisch sein, an einer Anzeige im Bildmodus zu arbeiten und dann eine abschließende Konvertierung in eine Form durchzuführen und diese beizubehalten die Größe.
- Legen Sie im Fenster „Haupteinstellungen“ den vollständigen Pfad auf gswin32c.exe oder gswin64c.exe (beachten Sie das „ c “!) und auf magick.exe von ImageMagick fest.
- Der beste Weg, um sicherzustellen, dass der Pfad korrekt ist, besteht darin, die Schaltfläche „…“ neben jedem Pfad zu verwenden und zur richtigen Datei zu navigieren.
- Einige Standardpfade umfassen %USERPROFILE% . Es wird empfohlen, auf „…“ zu klicken, um sicherzustellen, dass der Pfad ordnungsgemäß in den tatsächlichen Benutzerprofilpfad konvertiert wird.
(Optional) Installieren Sie TeX2img und legen Sie den Pfad fest :
- Wird nur für die Unterstützung von Vektorgrafiken über EMF benötigt (im Vergleich zu SVG sind die Vorteile von EMF: verfügbar in allen PowerPoint-Versionen, vollständig modifizierbare Formen; Nachteile: einige Anzeigen leiden zufällig unter Verzerrungen)
- Über diesen Link herunterladen (weitere Details zu TeX2img in ihrem Github-Repo)
- Nachdem Sie TeX2img irgendwo auf Ihrem Computer entpackt haben, führen Sie TeX2img.exe einmal aus, damit es automatisch die verschiedenen Pfade zu Latex/Ghostscript festlegt, und legen Sie dann im Fenster „Haupteinstellungen“ den vollständigen Pfad zu TeX2imgc.exe fest (beachten Sie das „ c “!). .
(Optional) LaTeXiT-Metadaten installieren :
- Wird benötigt, um mit LaTeXiT auf dem Mac erstellte Displays in IguanaTex-Displays zu konvertieren
- Laden Sie LaTeXiT-metadata-Win.zip von der Seite „Releases“ herunter, entpacken Sie es und legen Sie im Fenster „Haupteinstellungen“ den Pfad zu LaTeXiT-metadata.exe fest.
- Die LaTeXiT-Metadaten wurden freundlicherweise von Pierre Chatelier, dem Autor von LaTeXiT, auf meine Anfrage hin erstellt. Vielen Dank an ihn!
- Der Quellcode ist jetzt öffentlich.

Andere Einstellungen :

Wenn Sie eine nicht standardmäßige LaTeX-Installation haben, können Sie in den Haupteinstellungen den Ordner angeben, in dem die ausführbaren Dateien enthalten sind.
Wenn Sie die Möglichkeit haben möchten, einen externen Editor zu verwenden, z. B. beim Debuggen von LaTeX-Quellcode, können Sie in den Haupteinstellungen den Pfad zu diesem Editor angeben. Wenn Sie diesen Editor standardmäßig über das IguanaTex-Bearbeitungsfenster verwenden möchten, aktivieren Sie das Kontrollkästchen „Als Standard verwenden“.

Mac

Automatische Installation mit Homebrew

Wenn Sie Homebrew verwenden, ist die Installation so einfach wie:

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

Befolgen Sie dann Schritt 5. Überprüfen Sie, ob die Pfade in den Anweisungen zur manuellen Installation unten korrekt festgelegt sind .

Weitere Einzelheiten (z. B. zum Aktualisieren oder Deinstallieren ) finden Sie in den Homebrew-Anweisungen von Tsung-Ju.

Manuelle Installation

Laden Sie die ZIP-Datei „Vorgefertigte Dateien für Mac“ von der Release-Seite dieses Repositorys herunter
Es müssen 3 Dateien installiert werden:
- IguanaTex.scpt : AppleScript-Datei zur Handhabung des Datei- und Ordnerzugriffs
- libIguanaTexHelper.dylib : Bibliothek zum Erstellen nativer Textansichten; Quellcode im Git-Repo enthalten, unter „IguanaTexHelper/“
- IguanaTex_v1_XX_Y.ppam : Haupt-Add-In-Datei
Installieren Sie IguanaTex.scpt

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

Installieren Sie 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 '

Laden Sie das Add-In : Starten Sie PowerPoint (starten Sie neu, wenn es bei der Installation der Dylib ausgeführt wurde). Wählen Sie in der Menüleiste Extras > PowerPoint-Add-Ins... > „+“ und dann IguanaTex_v1_XX_Y.ppam
- Wenn Sie zum ersten Mal auf eine der Add-In-Schaltflächen klicken, werden Sie möglicherweise benachrichtigt, dass libIguanaTexHelper.dylib blockiert wurde. Gehen Sie zu den Mac-Einstellungen, dann zu Sicherheit und Datenschutz und klicken Sie auf „Trotzdem zulassen“.
Überprüfen Sie, ob die Pfade richtig eingestellt sind :
- Klicken Sie auf der Registerkarte „IguanaTex“ im Menüband auf „Haupteinstellungen“ und überprüfen Sie, ob die Pfade zu GhostScript, LaTeX-Binärdateien und libgs.9.dylib (für SVG-Konvertierungen verwendet) korrekt eingestellt sind, indem Sie auf die Schaltfläche „…“ daneben klicken sie: Wenn der Pfad korrekt ist, sollte dies Sie zu seinem Standort führen; Andernfalls müssen Sie zum entsprechenden Pfad navigieren. Die Standardeinstellungen sollten mit den MacTex-Installationsverzeichnissen übereinstimmen, Ihre Installation kann jedoch abweichen.
- Wenn Sie sie nicht finden können oder wenn IguanaTex sich darüber beschwert, dass ein Befehl nicht zurückgegeben wurde, öffnen Sie ein Terminal und verwenden Sie locate gs , locate pdflatex und locate libgs .
(Optional) LaTeXiT-Metadaten installieren :
- Wird benötigt, um mit LaTeXiT auf dem Mac erstellte Displays in IguanaTex-Displays zu konvertieren
- Laden Sie LaTeXiT-metadata-macos von der Seite „Releases“ herunter, fügen Sie die ausführbare Berechtigung hinzu und legen Sie entweder den Pfad zu seinem Speicherort im Fenster „Haupteinstellungen“ fest oder kopieren Sie ihn in den sicheren Add-In-Ordner:
  chmod 755 ./LaTeXiT-metadata-macos
  sudo cp ./LaTeXiT-metadata-macos '/Library/Application Support/Microsoft/Office365/User Content.localized/Add-Ins.localized/'
- Wenn LaTeXiT-metadata-macos zum ersten Mal von IguanaTex aufgerufen wird, blockiert Mac OS es möglicherweise. Gehen Sie zu den Mac-Einstellungen, dann zu Sicherheit und Datenschutz und klicken Sie auf „Trotzdem zulassen“.
- Die ausführbare Datei wurde unter Mac OS 10.13 kompiliert, sollte aber auf allen Versionen funktionieren. Bitte lassen Sie mich wissen, wenn Sie ein Problem haben.
- Die LaTeXiT-Metadaten wurden freundlicherweise von Pierre Chatelier, dem Autor von LaTeXiT, auf meine Anfrage hin erstellt. Vielen Dank an ihn!
- Der Quellcode ist jetzt öffentlich.

Nicht offensichtliche Tricks

Die Verwendung von IguanaTex sollte größtenteils selbsterklärend sein, es gibt jedoch ein paar Tipps und Tricks, die möglicherweise nicht selbsterklärend sind.

Zugriffstasten (d. h. Tastaturkürzel): Auf viele der Befehle von IguanaTex („Generieren“, „Abbrechen“ usw.) kann über eine Kombination aus Zusatztasten und einem einzelnen Buchstaben zugegriffen werden. Suchen Sie nach dem unterstrichenen Buchstaben im Text/Beschriftung der entsprechenden Schaltfläche.
Windows: Alt + Buchstabe. Anstatt beispielsweise auf das „ G Wenn Sie auf die Schaltfläche „Erzeugen“ klicken, können Sie Alt + g verwenden. (Dies ist das Standardverhalten von Office unter Windows.)
Mac: Strg + Befehlstaste + Buchstabe. Anstatt beispielsweise auf das „ G Wenn Sie auf die Schaltfläche „Enerate“ klicken, können Sie Ctrl + Cmd + g verwenden. (Beschleunigungstasten sind im Standard-Office für Mac nicht verfügbar, dies wurde von Tsung-Ju speziell für IguanaTex codiert.)

Bekannte Probleme

Auf dem Mac erstellte „Bild“-Anzeigen (bei denen es sich um eingefügte PDFs handelt) haben einen kleinen zusätzlichen Rand um sich herum, damit sie unter Windows nicht abgeschnitten erscheinen. In früheren Versionen gab es keinen Rand, aber die Anzeige erschien beschnitten. Dies scheint ein Fehler in der Art und Weise zu sein, wie PowerPoint einige PDF-Dateien auf dem Mac verarbeitet und sie intern als EMF-Dateien speichert. Die von LaTeXiT erstellten PDFs weisen dieses Problem jedoch nicht auf, sodass es möglicherweise eine Möglichkeit gibt, diesen Fehler in einer zukünftigen Version von IguanaTex zu umgehen.
IguanaTex-Makros können nicht zur Symbolleiste für den Schnellzugriff auf dem Mac hinzugefügt werden: Dies ist ein bekannter Fehler, an dem Microsoft angeblich arbeitet.
Beim Ändern des Formats einer Datei (Bild <-> Form oder sogar innerhalb der verschiedenen SVG- und EMF-Formformate) kann es zu Skalierungsproblemen kommen. Der beste Weg, dies zu bewältigen, ist die Verwendung der Funktionen „In Form konvertieren“/„In Bild konvertieren“, die die Anzeige im gewünschten Format neu generieren und dabei die Größe beibehalten. Bei Bedarf kann man den Inhalt dann noch weiter modifizieren und die Skalierung ist korrekt.
Für Shape-Anzeigen (d. h. Vektorgrafiken) wird die Standardeinstellung „SVG über DVI mit dvisvgm“ empfohlen, da bei anderen Modi manchmal Probleme auftreten:
- Einige über „EMF w/ TeX2img“ oder „EMF w/ pdfiumdraw“ erhaltene Anzeigen erscheinen verzerrt. Dies ist ein PowerPoint-Fehler, der manchmal auftritt, wenn die Gruppierung einer EMF-Datei in ein Shape-Objekt aufgehoben wird.
- Bei einigen mit „SVG via PDF w/dvisvgm“ erhaltenen Anzeigen fehlen Symbole oder Teile von Symbolen. Dies liegt daran, dass bestimmte Linien im PDF durch offene Pfade mit einer bestimmten Linienstärke statt durch geschlossene Pfade dargestellt werden und daher von PowerPoint bei der Konvertierung in ein Shape-Objekt unterschiedlich behandelt werden. Weitere Einzelheiten finden Sie in dieser Diskussion.