Descargar IguanaTex - Descarga del código fuente IguanaTex

IguanaTex

Otro código fuente

v1.61

Descargar

IguanaTex

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

Sitio web: https://www.jonathanleroux.org/software/iguanatex/

IguanaTex es un complemento de PowerPoint que le permite insertar ecuaciones de LaTeX en su presentación de PowerPoint en Windows y Mac. Se distribuye de forma totalmente gratuita, junto con su código fuente.

Este repositorio aloja el código fuente en un formato que se puede rastrear, compartir y discutir fácilmente (el código VBA se exporta mediante la macro ExportVBA).

Requisitos del sistema

ventanas

SO: Windows 2000 o posterior (32 o 64 bits).
PowerPoint:
- IguanaTex ha sido probado con PowerPoint 2010, 2013, 2016, 2019 (tanto de 32 como de 64 bits), Office 365 y PowerPoint 2003. Es probable que también funcione en PowerPoint 2000 y 2007.
- La compatibilidad con SVG está disponible para Office 365 y versiones comerciales recientes de PowerPoint. Se confirma la compatibilidad con PowerPoint 2021 al menos para las versiones 2108 y superiores, y probablemente (aunque no confirmado) para PowerPoint 2019 y tal vez incluso PowerPoint 2016 para las mismas versiones. Tenga en cuenta que las versiones con licencia por volumen, que son la versión 1808 a partir de agosto de 2023, no admiten la conversión de SVG a Shape, que requiere IguanaTex.
Látex: TeXLive o MiKTeX
GhostScript (si la última versión genera problemas, pruebe gs9.26)
ImagenMagia
(Opcional) TeX2img, utilizado para la salida de gráficos vectoriales a través de EMF (Descargar).

Impermeable

Mac Intel o Apple Silicon
- En Mac basadas en Apple Silicon, PowerPoint debe ejecutarse con la configuración "Abrir usando Rosetta".
PowerPoint para Mac:
- PowerPoint 2019 u Office 365
- PowerPoint 2016 (Versión 16.16.7 190210 o posterior) (por confirmar; algunas funciones, por ejemplo, SVG, pueden no funcionar)
MacTeX: asegúrese de instalar libgs para compatibilidad con SVG, seleccionando "Personalizar" en el paso "Tipo de instalación" del instalador de MacTex. (No he encontrado una manera de instalar libgs a través de TexLive después de la instalación inicial, si conoce alguna, hágamelo saber)

Descargar e instalar

ventanas

Descargue el archivo complementario .ppam desde la página de Versiones de este repositorio, o desde la página de Descarga de IguanaTex, y guárdelo en una ubicación confiable (consulte este artículo de Microsoft), como %appdata%MicrosoftAddins (es decir, C:Usersuser_nameAppdataRoamingMicrosoftAddins ).
Cargue el complemento : en "Archivo" > "Opciones" > "Complementos" > "Administrar:" (parte inferior de la ventana), elija "Complementos de PowerPoint" en el cuadro de selección. Luego presione "Ir...", luego haga clic en "Agregar nuevo", seleccione el archivo .ppam en la carpeta donde lo descargó, luego "Cerrar" (si descargó la fuente .pptm y la guardó como .ppam , se estar en la carpeta de complementos predeterminada).
Cree y configure una carpeta de archivos temporales : IguanaTex necesita acceso a una carpeta con permisos de lectura/escritura para almacenar archivos temporales.
- El valor predeterminado es "C:Temp". Si tiene permisos de escritura en "C:", cree la carpeta "C:Temp". Ya está todo listo.
- Si no puede crear esta carpeta, elija o cree una carpeta con permiso de escritura en cualquier otra ubicación. En la pestaña de IguanaTex, elige "Configuración principal" y coloca la ruta a la carpeta de tu elección. También puede utilizar una ruta relativa en la carpeta de la presentación (por ejemplo, "." para la carpeta de presentación misma).
Instale y establezca la ruta a GhostScript e ImageMagick (requerido para salidas de imágenes, excepto si usa el motor "Latex (DVI)"):
- Necesario para convertir archivos PDF intermedios a PNG antes de insertarlos en PowerPoint como un objeto de imagen. En el proceso de generación de imágenes, todos los motores LaTeX excepto "Latex (DVI)" generan archivos PDF. Incluso al generar una Forma, a menudo es mejor generar primero una Imagen y luego convertirla a Forma: la generación de imágenes es más rápida y sólida, por lo que puede ser conveniente trabajar en una pantalla en modo Imagen y luego realizar una conversión final a Forma, preservando el tamaño.
- Establezca la ruta completa a gswin32c.exe o gswin64c.exe (¡tenga en cuenta la " c "!) y a magick.exe de ImageMagick en la ventana "Configuración principal".
- La mejor manera de asegurarse de que la ruta sea correcta es usar el botón "..." al lado de cada ruta y navegar hasta el archivo correcto.
- Algunas rutas predeterminadas incluyen %USERPROFILE% . Se recomienda hacer clic en "..." para asegurarse de que la ruta se convierta correctamente a la ruta del perfil de usuario real.
(Opcional) Instale y establezca la ruta a TeX2img :
- Solo es necesario para compatibilidad con gráficos vectoriales a través de EMF (en comparación con SVG, las ventajas de EMF son: disponible en todas las versiones de PowerPoint, formas totalmente modificables; desventajas: algunas pantallas sufren distorsiones aleatorias)
- Descargue desde este enlace (más detalles sobre TeX2img en su repositorio de Github)
- Después de descomprimir TeX2img en algún lugar de su máquina, ejecute TeX2img.exe una vez para permitir que configure automáticamente las distintas rutas a latex/ghostscript, luego configure la ruta completa a TeX2imgc.exe (tenga en cuenta la " c "!) en la ventana "Configuración principal" .
(Opcional) Instale metadatos LaTeXiT :
- Necesario para convertir pantallas generadas con LaTeXiT en Mac en pantallas IguanaTex
- Descargue LaTeXiT-metadata-Win.zip desde la página de Versiones, descomprímalo y establezca la ruta a LaTeXiT-metadata.exe en la ventana "Configuración principal".
- Los metadatos de LaTeXiT fueron amablemente preparados por Pierre Chatelier, autor de LaTeXiT, a petición mía. ¡Muchas gracias a él!
- El código fuente ahora es público.

Otras configuraciones :

Si tiene una instalación de LaTeX no estándar, puede especificar en Configuración principal la carpeta en la que se incluyen los ejecutables.
Si desea tener la opción de utilizar un editor externo, por ejemplo, al depurar el código fuente de LaTeX, puede especificar la ruta a ese editor en Configuración principal. Si desea utilizar ese editor de forma predeterminada en la ventana de edición de IguanaTex, marque la casilla de verificación "usar como predeterminado".

Impermeable

Instalación automática con Homebrew

Si usas Homebrew, la instalación es tan simple como:

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

Luego siga 5. Verifique que las rutas estén configuradas correctamente en las instrucciones de instalación manual a continuación.

Para obtener más detalles (por ejemplo, cómo actualizar o desinstalar ), consulte las instrucciones de Homebrew de Tsung-Ju.

Instalación manual

Descargue el zip de "archivos prediseñados para Mac" desde la página de lanzamientos de este repositorio
Hay 3 archivos para instalar:
- IguanaTex.scpt : archivo AppleScript para manejar el acceso a archivos y carpetas
- libIguanaTexHelper.dylib : biblioteca para crear vistas de texto nativo; código fuente incluido en el repositorio de git, en "IguanaTexHelper/"
- IguanaTex_v1_XX_Y.ppam : archivo complementario principal
Instalar IguanaTex.scpt

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

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

Cargue el complemento : inicie PowerPoint (reinicie si se estaba ejecutando al instalar dylib). En la barra de menú, seleccione Herramientas > Complementos de PowerPoint... > '+' y elija IguanaTex_v1_XX_Y.ppam
- La primera vez que haga clic en uno de los botones del complemento, es posible que se le notifique que libIguanaTexHelper.dylib fue bloqueado. Vaya a Configuración de Mac, luego a Seguridad y Privacidad y haga clic en "Permitir de todos modos".
Verifique que las rutas estén configuradas correctamente :
- Haga clic en "Configuración principal" en la pestaña de la cinta de IguanaTex y verifique que las rutas a GhostScript, binarios de LaTeX y libgs.9.dylib (usados en conversiones SVG) estén configuradas correctamente haciendo clic en cada botón "..." al lado de ellos: si el camino es correcto, este debería llevarte a su ubicación; de lo contrario, deberá navegar hasta la ruta correspondiente. Los valores predeterminados deben coincidir con las ubicaciones de instalación de MacTex, pero su instalación puede diferir.
- Si no puede encontrarlos o si IguanaTex se queja de que un comando no regresó, abra una terminal y use locate gs , locate pdflatex y locate libgs .
(Opcional) Instale metadatos LaTeXiT :
- Necesario para convertir pantallas generadas con LaTeXiT en Mac en pantallas IguanaTex
- Descargue LaTeXiT-metadata-macos desde la página de Versiones, agregue permiso ejecutable y establezca la ruta a su ubicación en la ventana "Configuración principal" o cópielo en la carpeta segura del complemento:
  chmod 755 ./LaTeXiT-metadata-macos
  sudo cp ./LaTeXiT-metadata-macos '/Library/Application Support/Microsoft/Office365/User Content.localized/Add-Ins.localized/'
- La primera vez que IguanaTex llama a LaTeXiT-metadata-macos, Mac OS puede bloquearlo. Vaya a Configuración de Mac, luego a Seguridad y Privacidad y haga clic en "Permitir de todos modos".
- El ejecutable se compiló en Mac OS 10.13 pero debería funcionar en todas las versiones. Por favor, avíseme si tiene algún problema.
- Los metadatos de LaTeXiT fueron amablemente preparados por Pierre Chatelier, autor de LaTeXiT, a petición mía. ¡Muchas gracias a él!
- El código fuente ahora es público.

Trucos no obvios

El uso de IguanaTex debería explicarse por sí solo, pero hay algunos consejos y trucos que pueden no serlo.

Teclas aceleradoras (es decir, atajos de teclado): se puede acceder a muchos de los comandos de IguanaTex ("Generar", "Cancelar", etc.) usando una combinación de teclas modificadoras y una sola letra. Busque la letra subrayada en el texto/etiqueta del botón correspondiente.
Windows: Alt + letra. Por ejemplo, en lugar de hacer clic en " GRAMO botón "generar", puede usar Alt + g . (Este es el comportamiento estándar de Office en Windows)
Mac: Ctrl + Cmd + letra. Por ejemplo, en lugar de hacer clic en " GRAMO generar", puede usar Ctrl + Cmd + g . (Las teclas del acelerador no están disponibles en el Office estándar para Mac, esto fue codificado especialmente por Tsung-Ju para IguanaTex)

Problemas conocidos

Las pantallas de "imagen" creadas en Mac (que son archivos PDF insertados) tienen un pequeño margen adicional alrededor para que no aparezcan recortadas en Windows. En versiones anteriores, no había margen pero la pantalla aparecía recortada. Esto parece ser un error en la forma en que PowerPoint maneja algunos archivos PDF en Mac, almacenándolos internamente como archivos EMF. Sin embargo, los archivos PDF creados por LaTeXiT no tienen ese problema, por lo que puede haber una manera de evitar este error en una versión futura de IguanaTex.
Las macros de IguanaTex no se pueden agregar a la barra de herramientas de acceso rápido en Mac: este es un error conocido en el que supuestamente Microsoft está trabajando.
Puede haber algunos problemas de escala al cambiar el formato de un archivo (Imagen <-> Forma, o incluso dentro de los distintos formatos SVG y EMF Shape). La mejor manera de manejar esto es utilizar las funciones "Convertir a forma"/"Convertir a imagen", que regeneran la visualización en el formato deseado manteniendo el tamaño fijo. Luego se puede modificar aún más el contenido si es necesario y la escala será correcta.
Para pantallas de formas (es decir, gráficos vectoriales), se recomienda el valor predeterminado "SVG vía DVI con dvisvgm" debido a los problemas que a veces se observan con otros modos:
- Algunas visualizaciones obtenidas mediante "EMF con TeX2img" o "EMF con pdfiumdraw" aparecen distorsionadas. Este es un error de PowerPoint que a veces ocurre al desagrupar un archivo EMF en un objeto Shape.
- Algunas visualizaciones obtenidas con "SVG vía PDF con dvisvgm" tienen símbolos o faltan partes de símbolos. Esto se debe a que ciertas líneas se representan en PDF mediante trazados abiertos con un determinado ancho de línea, en lugar de trazados cerrados, y por lo tanto PowerPoint los maneja de manera diferente al convertirlos a un objeto Forma. Vea esta discusión para más detalles.