EDRSPIHCRSSRSS

Enabling Shell Escape

개요

  • TeX 컴파일 시 shell-escaping을 가능하게 해주는 기능이 있다. 이를 통해서 외부 프로그램을 실행하고 그 결과를 이용하여 조판하여야 할 때가 있다. 예를 들면,
    • lualatex이나 pdflatex에서 pstricks 그림을 포함할 때 pst2pdf를 쓰는 경우
    • minted와 같이 python을 실행해야 하는 경우
    • GnuplotTex과 같이 gnuplot을 실행해야 하는 경우
    • imakeidx 패키지가 xindy를 호출할 수 있도록 하여 index 만들기를 자동화하려는 경우
  • 그러나 보안 상의 이유로 TeX Live는 이 기능을 제한적으로 안전한 프로그램만을 허용하고 기본적으로는 동작하지 않도록 해두었다. 허용된 프로그램 중 대표적인 것이 epstopdf이다.

shell escape 활성화

  • TeX Live의 기본 설정을 shell escape 항상 허용으로 만들 수 있으나, 이를 사용하지 않을 것을 강력히 권장
  • 예컨대 foo.tex에 대하여 shell escape가 필요하다면, 명령행에서 다음과 같은 컴파일 옵션을 준다.
    # pdflatex --shell-escape foo
    
  • 참고로 MiKTeX
    # pdflatex --enable-write18 foo
    

작업흐름 자동화 유틸리티 또는 에디터 설정

TeXworks

  • 명령행에 익숙하지 않고 에디터 내에서 컴파일 명령을 부르는 것이 편하다면, "XeLaTeX (shell)"이라는 이름으로 현재의 "XeLaTeX" 조판 명령 설정을 하나 복사하여 여기에 --shell-escape를 붙여서 저장한 다음 shell-escape가 필요할 때 이 조판 명령을 쓰도록 한다.

arara

  • arara 지시자를 다음과 같이 하면 shell-escape가 가능하다.
    % arara: xelatex: { shell: yes }
    

SpiX

  • SpiX 지시문에 shell escape 옵션을 준다.
    %$ xelatex -shell-escape $texame
    

latexmk

  • latexmk를 명령행에서 직접 실행한다면, 다음과 같이 할 수 있다.
    $ latexmk -xelatex -latexoption='--interaction=nonstopmode -synctex=1 -shell-escape' <texfile>
    
  • 작업 폴더에 latexmkrc 파일을 만들고 그 내용을 다음과 같이 해두면, latexmk가 실행될 때 이 파일의 설정을 불러온다. 예를 들어 Visual Studio Code 편집기 또는 vim에서 latexmk 컴파일 방식을 사용하고 있다면 이 방법이 제일 확실하다.
$pdflatex = "xelatex --shell-escape --synctex=1 --interaction=nonstopmode";
$pdf_mode = 1;
$postscript_mode = $dvi_mode = 0;

overleaf.com

  • 놀랍게도, overleaf에서 shell escape를 활성화할 수 있다. 가장 큰 이유는 minted 때문이었던 것으로 보인다.
  • 방법은, 다음과 같은 latexmkrc 파일을 폴더에 함께 올리는 것이다.
    $pdflatex = 'xelatex %O %S --shell-escape';
    $pdf_mode = 1;
    $postscript_mode = $dvi_mode = 0;
    

TeX Live 설정 변경

이 항목은 일반사용자에게 권장하지 않는 것이며 참고사항입니다.
  1. shell-escape를 항상 허용. (사용하지 말 것)
    shell_escape = t
    
  2. shell-escape 허용 프로그램의 목록 추가 (기본적으로 허용되는 프로그램 목록을 유지할 것)
    shell_escape_commands = bibtex,bibtex8,extractbb,kpsewhich,makeindex,mpost,repstopdf,<safe program>