arara (rev. 1.18)

EDRSPIHCRSSRSS

arara

사용을 위한 준비

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

사용법

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

arara 명령 지시어 예시

  • % arara: xelatex: { shell: yes, synctex: yes, action: nonstopmode }
    
    • shell은 <del>shell-escape, synctex은 </del>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을 컴파일한다.