Download IguanaTex - Download do código-fonte IguanaTex

IguanaTex

Outro código-fonte

v1.61

Baixar

IguanaTex

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

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

IguanaTex é um complemento do PowerPoint que permite inserir equações LaTeX em sua apresentação do PowerPoint no Windows e Mac. É distribuído totalmente gratuito, junto com seu código-fonte.

Este repositório hospeda o código-fonte em um formato que pode ser facilmente rastreado, compartilhado e discutido (o código VBA é exportado usando a macro ExportVBA).

Requisitos do sistema

Windows

SO: Windows 2000 ou posterior (32 ou 64 bits).
Power Point:
- O IguanaTex foi testado com PowerPoint 2010, 2013, 2016, 2019 (32 e 64 bits), Office 365 e PowerPoint 2003. É provável que também funcione no PowerPoint 2000 e 2007.
- O suporte SVG está disponível para o Office 365 e versões comerciais recentes do PowerPoint. O suporte está confirmado para PowerPoint 2021, pelo menos para versões 2108 e superiores, e provavelmente (embora não confirmado) para PowerPoint 2019 e talvez até PowerPoint 2016 para as mesmas versões. Observe que as versões licenciadas por volume, que estão na versão 1808 em agosto de 2023, não suportam a conversão de SVG para Shape, que é exigida pela IguanaTex.
LaTeX: TeXLive ou MiKTeX
GhostScript (se a versão mais recente apresentar problemas, tente gs9.26)
ImagemMagick
(Opcional) TeX2img, usado para saída de gráficos vetoriais via EMF (Download).

Mac

Intel ou Apple Silicon Mac
- Em Macs baseados em Apple Silicon, o PowerPoint precisa ser executado com a configuração “Abrir usando Rosetta”.
PowerPoint para Mac:
- PowerPoint 2019 ou Office 365
- PowerPoint 2016 (versão 16.16.7 190210 ou posterior) (a confirmar; alguns recursos, por exemplo, SVG, podem não funcionar)
MacTeX: Certifique-se de instalar libgs para suporte SVG, selecionando "Personalizar" na etapa "Tipo de instalação" do instalador MacTex. (Não encontrei uma maneira de instalar libgs via TexLive após a instalação inicial, se você souber de alguma, por favor me avise)

Baixe e instale

Windows

Baixe o arquivo do suplemento .ppam na página de lançamentos deste repositório ou na página de download do IguanaTex e salve-o em um local confiável (consulte este artigo da Microsoft), como %appdata%MicrosoftAddins (ou seja, C:Usersuser_nameAppdataRoamingMicrosoftAddins ).
Carregue o suplemento : em "Arquivo" > "Opções" > "Suplementos" > "Gerenciar:" (parte inferior da janela), escolha "Suplementos do PowerPoint" na caixa de seleção. Em seguida, pressione "Ir...", depois clique em "Adicionar novo", selecione o arquivo .ppam na pasta onde você baixou e depois "Fechar" (se você baixou a fonte .pptm e salvou como .ppam , ele irá estar na pasta Add-In padrão).
Crie e defina uma pasta de arquivos temporários : IguanaTex precisa de acesso a uma pasta com permissões de leitura/gravação para armazenar arquivos temporários.
- O padrão é "C:Temp". Se você tiver permissões de gravação em "C:", crie a pasta "C:Temp". Está tudo pronto.
- Se você não conseguir criar esta pasta, escolha ou crie uma pasta com permissão de gravação em qualquer outro local. Na aba IguanaTex, escolha “Configurações Principais” e coloque o caminho da pasta de sua preferência. Você também pode usar um caminho relativo na pasta da apresentação (por exemplo, "." para a própria pasta da apresentação).
Instale e defina o caminho para GhostScript e ImageMagick (necessário para saídas de imagem, exceto se estiver usando o mecanismo "Latex (DVI)"):
- Necessário para converter arquivos PDF intermediários em PNG antes de inseri-los no PowerPoint como um objeto Imagem. No processo de geração de imagens, todos os mecanismos LaTeX, exceto "Latex (DVI)", geram arquivos PDF. Mesmo ao gerar uma Forma, muitas vezes é melhor gerar primeiro uma Imagem e depois converter para Forma: A geração de imagens é mais rápida e robusta, por isso pode ser conveniente trabalhar em uma exibição no modo Imagem e depois fazer uma conversão final para Forma, preservando o tamanho.
- Defina o caminho completo para gswin32c.exe ou gswin64c.exe (observe o " c "!) e para magick.exe do ImageMagick na janela "Configurações principais".
- A melhor maneira de ter certeza de que o caminho está correto é usar o botão "..." próximo a cada caminho e navegar até o arquivo correto.
- Alguns caminhos padrão incluem %USERPROFILE% . Recomenda-se clicar em "..." para garantir que o caminho seja convertido corretamente no caminho real do perfil do usuário.
(Opcional) Instale e defina o caminho para TeX2img :
- Necessário apenas para suporte a gráficos vetoriais via EMF (em comparação com SVG, os prós do EMF são: disponível em todas as versões do PowerPoint, formas totalmente modificáveis; contras: algumas telas sofrem distorções aleatoriamente)
- Baixe neste link (mais detalhes sobre TeX2img em seu repositório Github)
- Depois de descompactar o TeX2img em algum lugar da sua máquina, execute TeX2img.exe uma vez para permitir que ele defina automaticamente os vários caminhos para latex/ghostscript e, em seguida, defina o caminho completo para TeX2imgc.exe (observe o " c "!) na janela "Configurações principais" .
(Opcional) Instale os metadados LaTeXiT :
- Necessário para converter displays gerados com LaTeXiT no Mac em displays IguanaTex
- Baixe LaTeXiT-metadata-Win.zip na página Releases, descompacte e defina o caminho para LaTeXiT-metadata.exe na janela "Configurações principais".
- Os metadados do LaTeXiT foram gentilmente preparados por Pierre Chatelier, autor do LaTeXiT, a meu pedido. Muito obrigado a ele!
- O código-fonte agora é público.

Outras configurações :

Se você tiver uma instalação LaTeX não padrão, poderá especificar em Configurações principais a pasta na qual os executáveis estão incluídos.
Se você quiser ter a opção de usar um editor externo, por exemplo, ao depurar o código-fonte LaTeX, você pode especificar o caminho para esse editor em Configurações Principais. Se você quiser usar esse editor por padrão na janela de edição do IguanaTex, marque a caixa de seleção "usar como padrão".

Mac

Instalação automática com Homebrew

Se você usa o Homebrew, a instalação é tão simples quanto:

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

Em seguida, siga 5. Verifique se os caminhos estão definidos corretamente nas instruções de instalação manual abaixo.

Para mais detalhes (por exemplo, como atualizar ou desinstalar ), consulte as instruções do Homebrew de Tsung-Ju.

Instalação manual

Baixe o zip "arquivos pré-construídos para Mac" na página de lançamentos deste repositório
Existem 3 arquivos para instalar:
- IguanaTex.scpt : arquivo AppleScript para lidar com acesso a arquivos e pastas
- libIguanaTexHelper.dylib : biblioteca para criação de visualizações de texto nativo; código fonte incluído no repositório git, em "IguanaTexHelper/"
- IguanaTex_v1_XX_Y.ppam : arquivo de suplemento principal
Instale IguanaTex.scpt

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

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

Carregue o suplemento : Inicie o PowerPoint (reinicie se ele estava em execução durante a instalação do dylib). Na barra de menu, selecione Ferramentas > Suplementos do PowerPoint... > '+' e escolha IguanaTex_v1_XX_Y.ppam
- Na primeira vez que você clicar em um dos botões do suplemento, você poderá ser notificado de que libIguanaTexHelper.dylib foi bloqueado. Vá para Configurações do Mac, depois Segurança e Privacidade e clique em “Permitir assim mesmo”.
Verifique se os caminhos estão definidos corretamente :
- Clique em "Configurações principais" na guia da faixa de opções do IguanaTex e verifique se os caminhos para GhostScript, binários LaTeX e libgs.9.dylib (usado em conversões SVG) estão definidos corretamente clicando em cada botão "..." ao lado de eles: se o caminho estiver correto, isso deverá levá-lo ao seu local; caso contrário, você precisará navegar até o caminho relevante. Os padrões devem corresponder aos locais de instalação do MacTex, mas sua instalação pode ser diferente.
- Se você não conseguir encontrá-los ou se o IguanaTex reclamar que um comando não retornou, abra um terminal e use locate gs , locate pdflatex e locate libgs .
(Opcional) Instale os metadados LaTeXiT :
- Necessário para converter displays gerados com LaTeXiT no Mac em displays IguanaTex
- Baixe LaTeXiT-metadata-macos da página Releases, adicione permissão executável e defina o caminho para seu local na janela "Configurações principais" ou copie-o para a pasta segura do suplemento:
  chmod 755 ./LaTeXiT-metadata-macos
  sudo cp ./LaTeXiT-metadata-macos '/Library/Application Support/Microsoft/Office365/User Content.localized/Add-Ins.localized/'
- A primeira vez que LaTeXiT-metadata-macos é chamado pelo IguanaTex, o Mac OS pode bloqueá-lo. Vá para Configurações do Mac, depois Segurança e Privacidade e clique em “Permitir assim mesmo”.
- O executável foi compilado no Mac OS 10.13, mas deve funcionar em todas as versões. Por favor, deixe-me saber se você tiver algum problema.
- Os metadados do LaTeXiT foram gentilmente preparados por Pierre Chatelier, autor do LaTeXiT, a meu pedido. Muito obrigado a ele!
- O código-fonte agora é público.

Truques não óbvios

O uso do IguanaTex deve ser autoexplicativo, mas existem algumas dicas e truques que podem não ser.

Teclas aceleradoras (isto é, atalhos de teclado): muitos dos comandos do IguanaTex ("Gerar", "Cancelar", etc) podem ser acessados usando uma combinação de teclas modificadoras e uma única letra. Procure a letra sublinhada no texto/rótulo do botão correspondente.
Windows: Alt + letra. Por exemplo, em vez de clicar no botão " G botão "enerate", você pode usar Alt + g . (Este é o comportamento padrão do Office no Windows)
Mac: Ctrl + Cmd + letra. Por exemplo, em vez de clicar no botão " G enerate", você pode usar Ctrl + Cmd + g . (As teclas do acelerador não estão disponíveis no Office padrão para Mac, isso foi especialmente codificado por Tsung-Ju para IguanaTex)

Problemas conhecidos

As exibições de "imagem" criadas no Mac (que são PDFs inseridos) possuem uma pequena margem extra ao seu redor para que não apareçam cortadas no Windows. Nas versões anteriores, não havia margem, mas a tela aparecia cortada. Isso parece ser um bug na maneira como o PowerPoint lida com alguns PDFs no Mac, armazenando-os internamente como arquivos EMF. Os PDFs criados pelo LaTeXiT não apresentam esse problema, portanto, pode haver uma maneira de contornar esse bug em uma versão futura do IguanaTex.
As macros IguanaTex não podem ser adicionadas à barra de ferramentas de acesso rápido no Mac: este é um bug conhecido no qual a Microsoft está supostamente trabalhando.
Pode haver alguns problemas de dimensionamento ao alterar o formato de um arquivo (Imagem <-> Forma, ou mesmo dentro dos vários formatos SVG e EMF Shape). A melhor maneira de lidar com isso é usar as funções "Convert to Shape"/"Convert to Picture", que regeneram a exibição no formato desejado, mantendo o tamanho fixo. Pode-se então modificar ainda mais o conteúdo, se necessário, e a escala estará correta.
Para exibições de forma (ou seja, gráficos vetoriais), o padrão "SVG via DVI com dvisvgm" é recomendado devido a problemas às vezes observados com outros modos:
- Algumas exibições obtidas via "EMF w/ TeX2img" ou "EMF w/ pdfiumdraw" aparecem distorcidas. Este é um bug do PowerPoint que às vezes ocorre ao desagrupar um arquivo EMF em um objeto Shape.
- Algumas exibições obtidas com "SVG via PDF com dvisvgm" apresentam símbolos ou partes de símbolos faltando. Isso ocorre porque certas linhas são representadas no PDF por caminhos abertos com uma determinada largura de linha, em vez de caminhos fechados e, portanto, são tratadas de forma diferente pelo PowerPoint ao converter para um objeto Shape. Veja esta discussão para mais detalhes.