[[TableOfContents]]

== 사용을 위한 준비 ==
 1. [[명령창열기|명령행]]에서 arara --version을 실행하여 다음과 같은 화면이 나오는지 확인한다. {{{
  __ _ _ __ __ _ _ __ __ _
 / _` | '__/ _` | '__/ _` |
| (_| | | | (_| | | | (_| |
 \__,_|_|  \__,_|_|  \__,_|

arara 3.0 - The cool TeX automation tool
Copyright (c) 2012, Paulo Roberto Massa Cereda
All rights reserved.}}}
 1. 위와 같이 실행되지 않는다면 Java로 실행되는 툴이므로 (필요하다면) Java를 설치한다.
  * Windows: [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Java runtime]에서 윈도우용 설치파일을 다운받아 설치할 수 있다.
  * Mac: homebrew로 설치할 수도 있다.{{{
# brew install openjdk}}}
 1. [wiki:"ko.TeX"]의 komkindex, kotexindy, dvipdfmx를 지시어로 사용하려면 [wiki:"KtugPrivateRepository" KTUG 사설 저장소]를 등록하고 다음 명령을 실행한다. {{{
# <sudo> tlmgr install arara-rules-ko
}}}
== 사용법 ==
 * 소스에 arara 명령 지시어를 써넣는다. {{{
% arara: xelatex
}}}
 * 명령행에서 실행한다. {{{
# arara foo.tex
}}}
 * 명령행 옵션 {{{
-v: 컴파일 진행 과정을 보여준다.
-l: 로그 파일에 기록한다.
}}}
 * 참고. {{{-v}}} 옵션을 주지 않으면 컴파일 에러 발생 시 FAILURE하고 종료한다. 이 옵션을 주면 에러 위치에서 사용자의 응답을 기다린다.
 * TeXworks에서 사용하고 싶으면 컴파일 경로를 [[TeXworks|추가]]한다.
 * NP++에서 사용하고 싶으면 [[KC2008PlusPlus]]를 참고.
== arara 명령 지시어 예시 ==
 * {{{
% arara: xelatex: { shell: yes, synctex: yes, action: nonstopmode }
}}}
   * shell은 {{{--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을 컴파일한다.

== 에디터 설정 ==
 1. TeXShop
  * [TeXShop#s-4]
 1. TeXStudio
  * [http://tex.stackexchange.com/questions/118890/how-to-configure-texstudio-editor-to-use-glossaries-package-with-makeglossaries 외부링크]
  * 설정 후 shortcut: {{{option+shift+F1}}}