EDRSPIHCRSSRSS

arara

last modified: 2021-04-07 19:10:29 Contributors


1. 사용을 위한 준비

  1. 명령행에서 arara --version을 실행하여 다음과 같은 화면이 나오는지 확인한다.
      __ _ _ __ __ _ _ __ __ _
     / _` | '__/ _` | '__/ _` |
    | (_| | | | (_| | | | (_| |
     \__,_|_|  \__,_|_|  \__,_|
    
    arara 3.0 - The cool TeX automation tool
    Copyright (c) 2012, Paulo Roberto Massa Cereda
    All rights reserved.
  2. 위와 같이 실행되지 않는다면 Java로 실행되는 툴이므로 (필요하다면) Java를 설치한다.
    • Windows: Java runtime에서 윈도우용 설치파일을 다운받아 설치할 수 있다.
    • Mac: homebrew로 설치할 수도 있다.
      # brew cask install java
  3. ko.TeX의 komkindex, kotexindy, dvipdfmx를 지시어로 사용하려면 KTUG 사설 저장소를 등록하고 다음 명령을 실행한다.
    # <sudo> tlmgr install arara-rules-ko
    

2. 사용법

  • 소스에 arara 명령 지시어를 써넣는다.
    % arara: xelatex
    
  • 명령행에서 실행한다.
    # arara foo.tex
    
  • 명령행 옵션
    -v: 컴파일 진행 과정을 보여준다.
    -l: 로그 파일에 기록한다.
    
  • 참고. -v 옵션을 주지 않으면 컴파일 에러 발생 시 FAILURE하고 종료한다. 이 옵션을 주면 에러 위치에서 사용자의 응답을 기다린다.
  • TeXworks에서 사용하고 싶으면 컴파일 경로를 추가한다.
  • NP++에서 사용하고 싶으면 KC2008PlusPlus를 참고.

3. arara 명령 지시어 예시

  • % arara: xelatex: { shell: yes, synctex: yes, action: nonstopmode }
    
    • shell은 <del>shell-escape, synctex은 synctex=1, action은 --interaction=nonstopmode이다. 따라서 위의 지시자로부터 다음 명령이 실제로 실행된다. 파일이름이 foo.tex이라면
      # xelatex --interaction=nonstopmode --shell-escape --synctex=1 foo.tex
      
    • 이 세 가지 이외에 추가 옵션을 명령에 주어야 하는 경우에는 options: 지시자를 사용한다.
    • `: ` 다음에 스페이스 한 칸을 두어야 한다.
  • % arara: komkindex
    % arara: komkindex: { style: kotex }
    
    • komkindex는 KTUG 사설저장소에서 arara-rules-ko를 설치하여야 한다.
    • style 옵션을 추가할 때는 komkindex 다음에 `: `를 쓰고 중괄호로 해당 요구사항을 묶어서 전달한다.
    • 위의 지시자로 실행되는 명령은 다음과 같다.
      # komkindex -s kotex foo.idx
      
  • files
    % arara: xelatex: { files: [main.tex], synctex: yes }
    
    • 위의 지시자에 의하여 컴파일될 파일을 main.tex으로 설정할 수 있다. 현재 작업 중인 폴더에 main.tex이 있어야 하고, 지금 열린 파일이 무엇이든 간에 무조건 main.tex을 컴파일한다.

4. 에디터 설정

  1. TeXShop
  2. TeXStudio