Téléchargement IguanaTex - Téléchargement du code source IguanaTex

IguanaTex

Autre code source

v1.61

Télécharger

IguaneTex

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

Site Web : https://www.jonathanleroux.org/software/iguanatex/

IguanaTex est un complément PowerPoint qui vous permet d'insérer des équations LaTeX dans votre présentation PowerPoint sous Windows et Mac. Il est distribué entièrement gratuitement, avec son code source.

Ce référentiel héberge le code source sous une forme qui peut être facilement suivi, partagé et discuté (le code VBA est exporté à l'aide de la macro ExportVBA).

Configuration système requise

Fenêtres

Système d'exploitation : Windows 2000 ou version ultérieure (32 ou 64 bits).
PowerPoint :
- IguanaTex a été testé avec PowerPoint 2010, 2013, 2016, 2019 (32 et 64 bits), Office 365 et PowerPoint 2003. Il est probable qu'il fonctionnera également avec PowerPoint 2000 et 2007.
- La prise en charge SVG est disponible pour Office 365 et les versions commerciales récentes de PowerPoint. La prise en charge est confirmée pour PowerPoint 2021 au moins pour les versions 2108 et supérieures, et probablement (bien que non confirmé) pour PowerPoint 2019 et peut-être même PowerPoint 2016 pour les mêmes versions. Notez que les versions sous licence en volume, qui sont à la version 1808 en août 2023, ne prennent pas en charge la conversion SVG en Shape, qui est requise par IguanaTex.
LaTeX : TeXLive ou MiKTeX
GhostScript (si la dernière version pose des problèmes, essayez gs9.26)
ImageMagick
(Facultatif) TeX2img, utilisé pour la sortie de graphiques vectoriels via EMF (Téléchargement).

Mac

Intel ou Apple Silicon Mac
- Sur les Mac basés sur Apple Silicon, PowerPoint doit être exécuté avec le paramètre « Ouvrir à l'aide de Rosetta ».
PowerPoint pour Mac :
- Powerpoint 2019 ou Office 365
- PowerPoint 2016 (version 16.16.7 190210 ou ultérieure) (à confirmer ; certaines fonctionnalités, par exemple SVG, peuvent ne pas fonctionner)
MacTeX : assurez-vous d'installer libgs pour le support SVG, en sélectionnant "Personnaliser" à l'étape "Type d'installation" du programme d'installation MacTex. (Je n'ai pas trouvé de moyen d'installer libgs via TexLive après l'installation initiale, si vous en connaissez un, faites-le moi savoir)

Télécharger et installer

Fenêtres

Téléchargez le fichier de complément .ppam depuis la page des versions de ce référentiel ou depuis la page de téléchargement d'IguanaTex, et enregistrez-le dans un emplacement approuvé (voir cet article Microsoft), tel que %appdata%MicrosoftAddins (c'est-à-dire C:Usersuser_nameAppdataRoamingMicrosoftAddins ).
Chargez le complément : dans « Fichier » > « Options » > « Compléments » > « Gérer : » (partie inférieure de la fenêtre), choisissez « Compléments PowerPoint » dans la zone de sélection. Appuyez ensuite sur "Go...", puis cliquez sur "Ajouter nouveau", sélectionnez le fichier .ppam dans le dossier où vous l'avez téléchargé, puis "Fermer" (si vous avez téléchargé la source .pptm et l'avez enregistré sous .ppam , il sera être dans le dossier du complément par défaut).
Créer et définir un dossier de fichiers temporaires : IguanaTex a besoin d'accéder à un dossier avec des autorisations de lecture/écriture pour stocker les fichiers temporaires.
- La valeur par défaut est "C:Temp". Si vous disposez des droits d'écriture sous "C:", créez le dossier "C:Temp". Vous êtes prêt.
- Si vous ne parvenez pas à créer ce dossier, choisissez ou créez un dossier avec autorisation en écriture à n'importe quel autre emplacement. Dans l'onglet IguanaTex, choisissez "Paramètres principaux" et indiquez le chemin d'accès au dossier de votre choix. Vous pouvez également utiliser un chemin relatif sous le dossier de la présentation (par exemple, "." pour le dossier de présentation lui-même).
Installez et définissez le chemin vers GhostScript et ImageMagick (obligatoire pour les sorties image, sauf si vous utilisez le moteur "Latex (DVI)") :
- Nécessaire pour convertir les fichiers PDF intermédiaires en PNG avant leur insertion dans PowerPoint en tant qu'objet Image. Dans le processus de génération d'images, tous les moteurs LaTeX, à l'exception de « Latex (DVI) », génèrent des fichiers PDF. Même lors de la génération d'une forme, il est souvent préférable de générer d'abord une image puis de la convertir en forme : la génération d'images est plus rapide et plus robuste, il peut donc être pratique de travailler sur un affichage en mode Image puis d'effectuer une conversion finale en forme, en préservant la taille.
- Définissez le chemin complet vers gswin32c.exe ou gswin64c.exe (notez le « c » !) et vers magick.exe d'ImageMagick dans la fenêtre « Paramètres principaux ».
- La meilleure façon de vous assurer que le chemin est correct est d'utiliser le bouton "..." à côté de chaque chemin et d'accéder au fichier correct.
- Certains chemins par défaut incluent %USERPROFILE% . Il est recommandé de cliquer sur "..." pour vous assurer que le chemin est correctement converti en chemin réel du profil utilisateur.
(Facultatif) Installez et définissez le chemin vers TeX2img :
- Nécessaire uniquement pour la prise en charge des graphiques vectoriels via EMF (par rapport au SVG, les avantages d'EMF sont : disponible sur toutes les versions PowerPoint, formes entièrement modifiables ; inconvénients : certains affichages souffrent de distorsions de manière aléatoire)
- Téléchargez à partir de ce lien (plus de détails sur TeX2img sur leur dépôt Github)
- Après avoir décompressé TeX2img quelque part sur votre machine, exécutez TeX2img.exe une fois pour le laisser définir automatiquement les différents chemins vers latex/ghostscript, puis définissez le chemin complet vers TeX2imgc.exe (notez le « c » !) dans la fenêtre « Paramètres principaux » .
(Facultatif) Installez les métadonnées LaTeXiT :
- Nécessaire pour convertir les affichages générés avec LaTeXiT sur Mac en affichages IguanaTex
- Téléchargez LaTeXiT-metadata-Win.zip depuis la page Releases, décompressez-le et définissez le chemin d'accès à LaTeXiT-metadata.exe dans la fenêtre « Paramètres principaux ».
- Les métadonnées LaTeXiT ont été aimablement préparées par Pierre Chatelier, l'auteur de LaTeXiT, à ma demande. Un grand merci à lui !
- Le code source est désormais public.

Autres paramètres :

Si vous disposez d'une installation LaTeX non standard, vous pouvez spécifier dans Paramètres principaux le dossier dans lequel les exécutables sont inclus.
Si vous souhaitez avoir la possibilité d'utiliser un éditeur externe, par exemple lors du débogage du code source LaTeX, vous pouvez spécifier le chemin d'accès à cet éditeur dans les paramètres principaux. Si vous souhaitez utiliser cet éditeur par défaut sur la fenêtre d'édition d'IguanaTex, cochez la case "utiliser par défaut".

Mac

Installation automatique avec Homebrew

Si vous utilisez Homebrew, l'installation est aussi simple que :

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

Suivez ensuite 5. Vérifiez que les chemins sont correctement définis dans les instructions d'installation manuelle ci-dessous.

Pour plus de détails (par exemple, comment mettre à niveau ou désinstaller ), veuillez consulter les instructions Homebrew de Tsung-Ju.

Installation manuelle

Téléchargez le zip « fichiers prédéfinis pour Mac » à partir de la page des versions de ce référentiel
Il y a 3 fichiers à installer :
- IguanaTex.scpt : fichier AppleScript pour gérer l'accès aux fichiers et aux dossiers
- libIguanaTexHelper.dylib : bibliothèque pour créer des vues de texte natives ; code source inclus dans le dépôt git, sous "IguanaTexHelper/"
- IguanaTex_v1_XX_Y.ppam : fichier principal du complément
Installer IguanaTex.scpt

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

Installer 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 '

Chargez le complément : Démarrez PowerPoint (redémarrez s'il était en cours d'exécution lors de l'installation du dylib). Dans la barre de menu, sélectionnez Outils > Compléments PowerPoint... > '+' et choisissez IguanaTex_v1_XX_Y.ppam
- La première fois que vous cliquez sur l'un des boutons du complément, vous serez peut-être informé que libIguanaTexHelper.dylib a été bloqué. Accédez aux paramètres du Mac, puis à Sécurité et confidentialité, et cliquez sur « Autoriser quand même ».
Vérifiez que les chemins sont correctement définis :
- Cliquez sur "Paramètres principaux" dans l'onglet du ruban IguanaTex et vérifiez que les chemins vers les binaires GhostScript, LaTeX et libgs.9.dylib (utilisés dans les conversions SVG) sont correctement définis en cliquant sur chaque bouton "..." à côté de eux : si le chemin est correct, cela devrait vous amener à son emplacement ; sinon, vous devrez accéder au chemin approprié. Les valeurs par défaut doivent correspondre aux emplacements d'installation de MacTex, mais votre installation peut différer.
- Si vous ne les trouvez pas ou si IguanaTex se plaint qu'une commande n'a pas été renvoyée, ouvrez un terminal et utilisez locate gs , locate pdflatex et locate libgs .
(Facultatif) Installez les métadonnées LaTeXiT :
- Nécessaire pour convertir les affichages générés avec LaTeXiT sur Mac en affichages IguanaTex
- Téléchargez LaTeXiT-metadata-macos depuis la page Releases, ajoutez l'autorisation d'exécutable et définissez le chemin d'accès à son emplacement dans la fenêtre « Paramètres principaux » ou copiez-le dans le dossier de complément sécurisé :
  chmod 755 ./LaTeXiT-metadata-macos
  sudo cp ./LaTeXiT-metadata-macos '/Library/Application Support/Microsoft/Office365/User Content.localized/Add-Ins.localized/'
- La première fois que LaTeXiT-metadata-macos est appelé par IguanaTex, Mac OS peut le bloquer. Accédez aux paramètres du Mac, puis à Sécurité et confidentialité, et cliquez sur « Autoriser quand même ».
- L'exécutable a été compilé sur Mac OS 10.13 mais devrait fonctionner sur toutes les versions. S'il vous plaît laissez-moi savoir si vous avez un problème.
- Les métadonnées LaTeXiT ont été aimablement préparées par Pierre Chatelier, l'auteur de LaTeXiT, à ma demande. Un grand merci à lui !
- Le code source est désormais public.

Astuces non évidentes

L'utilisation d'IguanaTex devrait pour la plupart être explicite, mais il existe quelques trucs et astuces qui peuvent ne pas l'être.

Touches accélératrices (c'est-à-dire raccourcis clavier) : de nombreuses commandes d'IguanaTex ("Générer", "Annuler", etc.) sont accessibles en utilisant une combinaison de touches de modification et une seule lettre. Recherchez la lettre soulignée dans le texte/l'étiquette du bouton correspondant.
Windows : Alt + lettre. Par exemple, au lieu de cliquer sur le " G "Enerate", vous pouvez utiliser Alt + g . (Il s'agit du comportement standard d'Office sous Windows)
Mac : Ctrl + Cmd + lettre. Par exemple, au lieu de cliquer sur le " G "Enerate", vous pouvez utiliser Ctrl + Cmd + g . (Les touches d'accélération ne sont pas disponibles dans Office standard pour Mac, cela a été spécialement codé par Tsung-Ju pour IguanaTex)

Problèmes connus

Les affichages « Image » créés sur Mac (qui sont des PDF insérés) ont une petite marge supplémentaire autour d'eux afin qu'ils n'apparaissent pas rognés sous Windows. Dans les versions antérieures, il n'y avait pas de marge mais l'affichage apparaissait tronqué. Cela semble être un bug dans la façon dont PowerPoint gère certains PDF sur Mac, en les stockant en interne sous forme de fichiers EMF. Les PDF créés par LaTeXiT ne présentent cependant pas ce problème, il pourrait donc y avoir un moyen de contourner ce bug dans une future version d'IguanaTex.
Les macros IguanaTex ne peuvent pas être ajoutées à la barre d'outils d'accès rapide sur Mac : il s'agit d'un bug connu sur lequel Microsoft travaillerait.
Il peut y avoir des problèmes de mise à l'échelle lors du changement de format d'un fichier (Image <-> Forme, ou même dans les différents formats SVG et EMF Shape). La meilleure façon de gérer cela est d'utiliser les fonctions "Convertir en forme"/"Convertir en image", qui régénèrent l'affichage au format souhaité tout en gardant la taille fixe. On peut alors modifier davantage le contenu si nécessaire, et la mise à l'échelle sera correcte.
Pour les affichages de forme (c'est-à-dire les graphiques vectoriels), la valeur par défaut « SVG via DVI avec dvisvgm » est recommandée en raison de problèmes parfois observés avec d'autres modes :
- Certains affichages obtenus via "EMF w/TeX2img" ou "EMF w/pdfiumdraw" apparaissent déformés. Il s'agit d'un bug PowerPoint qui se produit parfois lors du dissociation d'un fichier EMF en un objet Shape.
- Certains affichages obtenus avec "SVG via PDF w/dvisvgm" comportent des symboles ou des parties de symboles manquants. En effet, certaines lignes sont représentées dans le PDF par des tracés ouverts avec une certaine largeur de trait, au lieu de tracés fermés, et sont donc gérées différemment par PowerPoint lors de la conversion en objet Shape. Voir cette discussion pour plus de détails.