이구아나텍스
(C) Jonathan Le Roux 및 Zvika Ben-Haim(Windows), Tsung-Ju Chiang 및 Jonathan Le Roux(Mac)
웹사이트: https://www.jonathanleroux.org/software/iguanatex/
IguanaTex는 Windows 및 Mac의 PowerPoint 프레젠테이션에 LaTeX 방정식을 삽입할 수 있는 PowerPoint 추가 기능입니다. 소스 코드와 함께 완전히 무료로 배포됩니다.
이 저장소는 쉽게 추적, 공유 및 논의할 수 있는 형식으로 소스 코드를 호스팅합니다(VBA 코드는 ImportVBA 매크로를 사용하여 내보냅니다).
시스템 요구 사항
윈도우
- OS: Windows 2000 이상(32비트 또는 64비트).
- 파워포인트:
- IguanaTex는 PowerPoint 2010, 2013, 2016, 2019(32비트 및 64비트 모두), Office 365 및 PowerPoint 2003에서 테스트되었습니다. PowerPoint 2000 및 2007에서도 작동할 가능성이 높습니다.
- SVG 지원은 Office 365 및 최신 정품 버전의 PowerPoint에서 사용할 수 있습니다. 최소한 버전 2108 이상에서는 PowerPoint 2021에 대한 지원이 확인되었으며, PowerPoint 2019에서는 (확인되지는 않았지만) 동일한 버전에 대해서는 PowerPoint 2016에서도 지원될 수 있습니다. 2023년 8월 현재 버전 1808인 볼륨 라이선스 버전은 IguanaTex에서 요구하는 Shape로의 SVG 변환을 지원하지 않습니다.
- LaTeX: TeXLive 또는 MiKTeX
- GhostScript(최신 버전에서 문제가 발생하는 경우 gs9.26을 사용해 보세요)
- 이미지매직
- (선택 사항) EMF를 통한 벡터 그래픽 출력에 사용되는 TeX2img(다운로드).
스코틀랜드 사람
- Intel 또는 Apple Silicon Mac
- Apple Silicon 기반 Mac에서는 "Rosetta를 사용하여 열기" 설정으로 PowerPoint를 실행해야 합니다.
- Mac용 파워포인트:
- 파워포인트 2019 또는 오피스 365
- PowerPoint 2016(버전 16.16.7 190210 이상)(확인 예정, SVG 등 일부 기능이 작동하지 않을 수 있음)
- MacTeX: MacTex 설치 프로그램의 "설치 유형" 단계에서 "사용자 정의"를 선택하여 SVG 지원을 위한
libgs
설치했는지 확인하세요. (초기 설치 후 TexLive를 통해 libgs를 설치하는 방법을 찾지 못했습니다. 알고 계시다면 알려주시기 바랍니다.)
다운로드 및 설치
윈도우
- 이 저장소의 릴리스 페이지 또는 IguanaTex 다운로드 페이지에서 .ppam 추가 기능 파일을 다운로드하고
%appdata%MicrosoftAddins
(예: C:Usersuser_nameAppdataRoamingMicrosoftAddins
와 같은 신뢰할 수 있는 위치(이 Microsoft 문서 참조)에 저장합니다. C:Usersuser_nameAppdataRoamingMicrosoftAddins
). - 추가 기능 로드 : "파일" > "옵션" > "추가 기능" > "관리:"(창 하단) 선택 상자에서 "PowerPoint 추가 기능"을 선택합니다. 그런 다음 "이동..."을 누른 다음 "새로 추가"를 클릭하고 다운로드한 폴더에서
.ppam
파일을 선택한 다음 "닫기"를 클릭합니다(.pptm 소스를 다운로드하고 .ppam
으로 저장한 경우 기본 Add-In 폴더에 있어야 합니다). - 임시 파일 폴더 생성 및 설정 : IguanaTex는 임시 파일을 저장하기 위해 읽기/쓰기 권한이 있는 폴더에 접근해야 합니다.
- 기본값은 "C:Temp"입니다. "C:"에 쓰기 권한이 있는 경우 "C:Temp" 폴더를 만듭니다. 모든 준비가 완료되었습니다.
- 이 폴더를 생성할 수 없는 경우 다른 위치에서 쓰기 권한이 있는 폴더를 선택하거나 생성하세요. IguanaTex 탭에서 "기본 설정"을 선택하고 원하는 폴더의 경로를 입력하세요. 프레젠테이션 폴더 아래의 상대 경로를 사용할 수도 있습니다(예: 프레젠테이션 폴더 자체의 경우 ".").
- GhostScript 및 ImageMagick에 대한 경로 설치 및 설정 ("Latex(DVI)" 엔진을 사용하는 경우를 제외하고 그림 출력에 필요):
- PowerPoint에 그림 개체로 삽입하기 전에 중간 PDF 파일을 PNG로 변환하는 데 필요합니다. 그림 생성 과정에서 "Latex(DVI)"를 제외한 모든 LaTeX 엔진은 PDF 파일을 출력합니다. 모양을 생성할 때에도 먼저 그림을 생성한 다음 모양으로 변환하는 것이 더 나은 경우가 많습니다. 그림 생성은 더 빠르고 강력하므로 그림 모드에서 디스플레이 작업을 한 다음 모양으로 최종 변환하여 보존하는 것이 편리할 수 있습니다. 크기.
- "기본 설정" 창에서
gswin32c.exe
또는 gswin64c.exe
(" c
" 참고) 및 ImageMagick의 Magick.exe에 대한 전체 경로를 설정합니다. - 경로가 올바른지 확인하는 가장 좋은 방법은 각 경로 옆에 있는 "..." 버튼을 사용하여 올바른 파일을 탐색하는 것입니다.
- 일부 기본 경로에는
%USERPROFILE%
포함됩니다. 경로가 실제 사용자 프로필 경로로 올바르게 변환되었는지 확인하려면 "..."를 클릭하는 것이 좋습니다.
- (선택 사항) TeX2img 경로를 설치하고 설정합니다 .
- EMF를 통한 벡터 그래픽 지원에만 필요합니다(SVG와 비교하여 EMF의 장점은 모든 PowerPoint 버전에서 사용 가능하고 완전히 수정 가능한 모양입니다. 단점: 일부 디스플레이는 무작위로 왜곡이 발생합니다).
- 이 링크에서 다운로드하세요(Github 저장소의 TeX2img에 대한 자세한 내용).
- 컴퓨터 어딘가에서 TeX2img의 압축을 푼 후 TeX2img.exe를 한 번 실행하여 latex/ghostscript에 대한 다양한 경로를 자동으로 설정한 다음 "기본 설정" 창에서
TeX2imgc.exe
(" c
" 참고!)의 전체 경로를 설정합니다. .
- (선택 사항) LaTeXiT 메타데이터를 설치합니다 .
- Mac에서 LaTeXiT로 생성된 디스플레이를 IguanaTex 디스플레이로 변환하는 데 필요함
- 릴리스 페이지에서
LaTeXiT-metadata-Win.zip
다운로드하고 압축을 푼 다음 "기본 설정" 창에서 LaTeXiT-metadata.exe
경로를 설정합니다. - LaTeXiT-metadata는 LaTeXiT의 저자인 Pierre Chatelier가 저의 요청에 따라 친절하게 작성해 주었습니다. 그에게 정말 감사드립니다!
- 이제 소스 코드가 공개되었습니다.
기타 설정 :
- 비표준 LaTeX 설치가 있는 경우 기본 설정에서 실행 파일이 포함된 폴더를 지정할 수 있습니다.
- 예를 들어 LaTeX 소스 코드를 디버깅할 때 외부 편집기를 사용하는 옵션을 원할 경우 기본 설정에서 해당 편집기에 대한 경로를 지정할 수 있습니다. IguanaTex 편집 창에서 해당 편집기를 기본적으로 사용하려면 "기본값으로 사용" 확인란을 선택하세요.
스코틀랜드 사람
Homebrew를 이용한 자동 설치
Homebrew를 사용하는 경우 설치는 다음과 같이 간단합니다.
brew tap tsung-ju/iguanatexmac
brew install --cask --no-quarantine iguanatexmac latexit-metadata
그런 다음 5를 따르십시오. 아래 수동 설치 지침에 따라 경로가 올바르게 설정되었는지 확인하십시오 .
자세한 내용(예: 업그레이드 또는 제거 방법)은 Tsung-Ju의 Homebrew 지침을 참조하세요.
수동 설치
이 저장소의 릴리스 페이지에서 "Mac용 사전 구축된 파일" zip을 다운로드하세요.
설치할 파일은 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 gs
, locate pdflatex
및 locate libgs
.
(선택 사항) LaTeXiT 메타데이터를 설치합니다 .
- Mac에서 LaTeXiT로 생성된 디스플레이를 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/'
- IguanaTex가 LaTeXiT-metadata-macos를 처음 호출하면 Mac OS에서 이를 차단할 수 있습니다. Mac 설정으로 이동한 다음 보안 및 개인정보 보호로 이동하여 '어쨌든 허용'을 클릭하세요.
- 실행 파일은 Mac OS 10.13에서 컴파일되었지만 모든 버전에서 작동합니다. 문제가 있으면 알려주시기 바랍니다.
- LaTeXiT-metadata는 LaTeXiT의 저자인 Pierre Chatelier가 저의 요청에 따라 친절하게 작성해 주었습니다. 그에게 정말 감사드립니다!
- 이제 소스 코드가 공개되었습니다.
명백하지 않은 트릭
IguanaTex의 사용법은 대부분 자명해야 하지만 그렇지 않은 몇 가지 팁과 요령이 있습니다.
- 단축키(예: 키보드 단축키): IguanaTex의 많은 명령("생성", "취소" 등)은 보조 키와 단일 문자의 조합을 사용하여 액세스할 수 있습니다. 해당 버튼의 텍스트/라벨에서 밑줄이 그어진 문자를 찾으세요.
- Windows: Alt + 문자. 예를 들어 '를 클릭하는 대신 G 생성" 버튼을 누르면
Alt + g
사용할 수 있습니다. (이는 Windows의 표준 Office 동작입니다.) - Mac: Ctrl + Cmd + 문자. 예를 들어 '를 클릭하는 대신 G 활성화" 버튼을 사용하려면
Ctrl + Cmd + g
사용할 수 있습니다. (가속 키는 Mac용 표준 Office에서 사용할 수 없습니다. 이는 Tsung-Ju가 IguanaTex용으로 특별히 코딩한 것입니다.)
알려진 문제
- Mac에서 생성된(PDF가 삽입된) "그림" 디스플레이에는 Windows에서 잘려 보이지 않도록 주위에 작은 추가 여백이 있습니다. 이전 버전에서는 여백이 없었지만 디스플레이가 잘려 표시되었습니다. 이는 PowerPoint가 Mac에서 일부 PDF를 처리하여 내부적으로 EMF 파일로 저장하는 방식의 버그인 것 같습니다. 그러나 LaTeXiT에서 생성된 PDF에는 해당 문제가 없으므로 IguanaTex의 향후 버전에서 이 버그를 피할 수 있는 방법이 있을 수 있습니다.
- IguanaTex 매크로는 Mac의 빠른 액세스 도구 모음에 추가할 수 없습니다. 이는 Microsoft가 작업 중인 알려진 버그입니다.
- 파일 형식(그림 <-> 모양 또는 다양한 SVG 및 EMF 모양 형식 내에서도)을 변경할 때 일부 크기 조정 문제가 발생할 수 있습니다. 이를 처리하는 가장 좋은 방법은 "모양으로 변환"/"그림으로 변환" 기능을 사용하는 것입니다. 이 기능은 크기를 고정한 상태로 원하는 형식으로 디스플레이를 다시 생성합니다. 그런 다음 필요한 경우 콘텐츠를 추가로 수정할 수 있으며 크기 조정이 정확합니다.
- 모양(예: 벡터 그래픽) 디스플레이의 경우 다른 모드에서 가끔 관찰되는 문제로 인해 기본 "SVG via DVI w/ dvisvgm"을 권장합니다.
- "TeX2img 포함 EMF" 또는 "pdfiumdraw 포함 EMF"를 통해 얻은 일부 디스플레이가 왜곡되어 나타납니다. EMF 파일을 Shape 개체로 그룹 해제할 때 가끔 발생하는 PowerPoint 버그입니다.
- "dvisvgm이 포함된 PDF를 통한 SVG"로 얻은 일부 디스플레이에는 기호 또는 기호 일부가 누락되어 있습니다. 이는 PDF에서 특정 선이 닫힌 경로 대신 특정 선 너비를 가진 열린 경로로 표시되어 Shape 개체로 변환할 때 PowerPoint에서 다르게 처리되기 때문입니다. 자세한 내용은 이 토론을 참조하세요.
특허
이 저작물은 Creative Commons Attribution 3.0 Unported License에 따라 라이센스가 부여됩니다.