Загрузка IguanaTex - Загрузка исходного кода IguanaTex

IguanaTex

Другой исходный код

v1.61

Скачать

ИгуанаТекс

(C) Джонатан Ле Ру и Звика Бен-Хаим (Windows), Цунг-Джу Чианг и Джонатан Ле Ру (Mac)

Веб-сайт: https://www.jonathanleroux.org/software/iguanatex/

IguanaTex — это надстройка PowerPoint, которая позволяет вставлять уравнения LaTeX в презентацию PowerPoint на Windows и Mac. Он распространяется совершенно бесплатно вместе со своим исходным кодом.

В этом репозитории хранится исходный код в форме, которую можно легко отслеживать, публиковать и обсуждать (код VBA экспортируется с помощью макроса ExportVBA).

Системные требования

Окна

ОС: 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 для тех же версий. Обратите внимание, что версии с корпоративной лицензией (версия 1808 по состоянию на август 2023 г.) не поддерживают преобразование SVG в Shape, которое требуется IguanaTex.
LaTeX: TeXLive или MiKTeX
GhostScript (если последняя версия вызывает проблемы, попробуйте gs9.26)
ИзображениеМагия
(Необязательно) TeX2img, используется для вывода векторной графики через EMF (Загрузить).

Мак

Intel или Apple Silicon Mac
- На компьютерах Mac на базе Apple Silicon PowerPoint необходимо запускать с настройкой «Открыть с помощью Rosetta».
PowerPoint для Mac:
- Powerpoint 2019 или Office 365.
- PowerPoint 2016 (версия 16.16.7 190210 или новее) (подлежит подтверждению; некоторые функции, например SVG, могут не работать)
MacTeX: убедитесь, что вы установили libgs для поддержки SVG, выбрав «Настроить» на этапе «Тип установки» установщика MacTex. (Я не нашел способа установить libgs через TexLive после первоначальной установки, если вы знаете такой, дайте мне знать)

Загрузите и установите

Окна

Загрузите файл надстройки .ppam со страницы «Выпуски» этого репозитория или со страницы загрузки IguanaTex и сохраните его в надежном месте (см. эту статью Microsoft), например %appdata%MicrosoftAddins (т. е. C:Usersuser_nameAppdataRoamingMicrosoftAddins ).
Загрузите надстройку : в «Файл» > «Параметры» > «Надстройки» > «Управление:» (нижняя часть окна) выберите «Надстройки PowerPoint» в поле выбора. Затем нажмите «Перейти...», затем нажмите «Добавить новый», выберите файл .ppam в папке, в которую вы его скачали, затем «Закрыть» (если вы загрузили исходный код .pptm и сохранили его как .ppam , он будет находиться в папке надстроек по умолчанию).
Создайте и настройте папку для временных файлов : IguanaTex необходим доступ к папке с разрешениями на чтение/запись для хранения временных файлов.
- По умолчанию — «C:Temp». Если у вас есть права на запись в папку «C:», создайте папку «C:Temp». Все готово.
- Если вы не можете создать эту папку, выберите или создайте папку с разрешением на запись в любом другом месте. На вкладке IguanaTex выберите «Основные настройки» и укажите путь к выбранной вами папке. Вы также можете использовать относительный путь к папке презентации (например, «.» для самой папки презентации).
Установите и укажите путь к GhostScript и ImageMagick (требуется для вывода изображения, за исключением использования механизма «Latex (DVI)»):
- Необходимо преобразовать промежуточные файлы PDF в PNG перед вставкой в PowerPoint как объект изображения. В процессе создания изображения все механизмы LaTeX, кроме «Latex (DVI)», выводят файлы PDF. Даже при создании фигуры зачастую лучше сначала сгенерировать изображение, а затем преобразовать его в форму: создание изображения происходит быстрее и надежнее, поэтому может быть удобно работать с дисплеем в режиме изображения, а затем выполнить окончательное преобразование в форму, сохраняя размер.
- Задайте полный путь к gswin32c.exe или gswin64c.exe (обратите внимание на « c »!) и к файлу Magick.exe ImageMagick в окне «Основные настройки».
- Лучший способ убедиться в правильности пути — использовать кнопку «...» рядом с каждым путем и перейти к правильному файлу.
- Некоторые пути по умолчанию включают %USERPROFILE% . Рекомендуется нажать «...», чтобы убедиться, что путь правильно преобразован в фактический путь к профилю пользователя.
(Необязательно) Установите и укажите путь к TeX2img :
- Требуется только для поддержки векторной графики через EMF (по сравнению с SVG, плюсы EMF: доступны во всех версиях PowerPoint, полностью изменяемые формы; минусы: некоторые дисплеи случайным образом искажаются)
- Загрузите по этой ссылке (подробнее о TeX2img в репозитории Github)
- После распаковки TeX2img где-нибудь на вашем компьютере запустите TeX2img.exe один раз, чтобы он автоматически установил различные пути к latex/ghostscript, затем установите полный путь к TeX2imgc.exe (обратите внимание на « c »!) в окне «Основные настройки». .
(Необязательно) Установите метаданные LaTeXiT :
- Необходимо преобразовать дисплеи, созданные с помощью LaTeXiT на Mac, в дисплеи IguanaTex.
- Загрузите LaTeXiT-metadata-Win.zip со страницы «Релизы», разархивируйте и укажите путь к LaTeXiT-metadata.exe в окне «Основные настройки».
- Метаданные LaTeXiT были любезно подготовлены Пьером Шателье, автором LaTeXiT, по моей просьбе. Большое ему спасибо!
- Исходный код теперь общедоступен.

Другие настройки :

Если у вас нестандартная установка LaTeX, вы можете указать в основных настройках папку, в которую включены исполняемые файлы.
Если вы хотите иметь возможность использовать внешний редактор, например, при отладке исходного кода LaTeX, вы можете указать путь к этому редактору в основных настройках. Если вы хотите использовать этот редактор по умолчанию в окне редактирования IguanaTex, установите флажок «Использовать по умолчанию».

Мак

Автоматическая установка с помощью Homebrew

Если вы используете Homebrew, установка проста:

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

Затем выполните 5. Убедитесь, что пути указаны правильно в инструкциях по ручной установке ниже.

Для получения более подробной информации (например, как обновить или удалить ) см. инструкции Tsung-Ju Homebrew.

Ручная установка

Загрузите zip-архив «готовых файлов для Mac» со страницы «Релиз» этого репозитория.
Для установки необходимо 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 locate gs , locate pdflatex и locate libgs .
(Необязательно) Установите метаданные LaTeXiT :
- Необходимо преобразовать дисплеи, созданные с помощью LaTeXiT на Mac, в дисплеи 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, по моей просьбе. Большое ему спасибо!
- Исходный код теперь общедоступен.

Неочевидные трюки

Использование IguanaTex в основном не требует пояснений, но есть несколько советов и приемов, которые могут быть неочевидны.

Клавиши быстрого доступа (т. е. сочетания клавиш): доступ ко многим командам IguanaTex («Создать», «Отмена» и т. д.) можно получить, используя комбинацию клавиш-модификаторов и одну букву. Найдите подчеркнутую букву в тексте/метке соответствующей кнопки.
Windows: Alt + буква. Например, вместо нажатия кнопки « Г кнопку «enerate», вы можете использовать Alt + g . (Это стандартное поведение Office в Windows).
Mac: Ctrl + Cmd + буква. Например, вместо нажатия кнопки « Г кнопку «enerate», вы можете использовать Ctrl + Cmd + g . (Клавиши быстрого доступа недоступны в стандартном Office для Mac, это было специально написано Цунг-Джу для IguanaTex)

Известные проблемы

Отображения «Изображения», созданные на Mac (которые представляют собой вставленные PDF-файлы), имеют вокруг себя небольшой дополнительный край, чтобы они не выглядели обрезанными в Windows. В более ранних версиях полей не было, но изображение выглядело обрезанным. Похоже, это ошибка в том, как PowerPoint обрабатывает некоторые PDF-файлы на Mac, сохраняя их внутри как файлы EMF. Однако PDF-файлы, созданные LaTeXiT, не имеют этой проблемы, поэтому может быть способ обойти эту ошибку в будущей версии IguanaTex.
Макросы IguanaTex невозможно добавить на панель быстрого доступа на Mac: это известная ошибка, над которой предположительно работает Microsoft.
При изменении формата файла могут возникнуть проблемы с масштабированием (Изображение <-> Форма или даже в различных форматах фигур SVG и EMF). Лучший способ справиться с этой проблемой — использовать функции «Преобразовать в форму»/«Преобразовать в изображение», которые восстанавливают отображение в нужном формате, сохраняя фиксированный размер. При необходимости можно дополнительно изменить содержимое, и масштабирование будет правильным.
Для дисплеев Shape (т. е. векторной графики) рекомендуется использовать по умолчанию «SVG через DVI с dvisvgm» из-за проблем, иногда наблюдаемых в других режимах:
- Некоторые изображения, полученные с помощью «EMF с TeX2img» или «EMF с pdfiumdraw», выглядят искаженными. Это ошибка PowerPoint, которая иногда возникает при разгруппировании файла EMF в объект Shape.
- На некоторых дисплеях, полученных с помощью «SVG через PDF с dvisvgm», символы или их части отсутствуют. Это связано с тем, что определенные линии представлены в PDF открытыми путями определенной ширины, а не закрытыми путями, и поэтому PowerPoint по-разному обрабатывается при преобразовании в объект Shape. Подробнее смотрите в этом обсуждении.