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

arara 3.0 - The cool TeX automation tool
Copyright (c) 2012, Paulo Roberto Massa Cereda
All rights reserved.}}}
 1. 위와 같이 실행되지 않는다면 Java로 실행되는 툴이므로 (필요하다면) Java runtime을 설치한다.
 1. [wiki:"ko.TeX"]의 komkindex, texindy, dvipdfmx를 지시어로 사용하려면 [wiki:"KtugPrivateRepository" KTUG 사설 저장소]를 등록하고 다음 명령을 실행한다. {{{
> tlmgr install arara-rules-ko
}}}
== 사용법 ==
 * 소스에 arara 명령 지시어를 써넣는다. {{{
% arara: xelatex
}}}
 * 명령행에서 실행한다. {{{
# arara foo.tex
}}}
 * 명령행 옵션 {{{
-v: 컴파일 진행 과정을 보여준다.
-l: 로그 파일에 기록한다.
}}}
== arara 명령 지시어 예시 ==
 * {{{
% arara: xelatex: { shell: yes, synctex: yes }
}}}
   * shell은 {{{--shell-escape}}}, synctex은 `--synctex=1`이다. 따라서 위의 지시자로부터 다음 명령이 실제로 실행된다. 파일이름이 foo.tex이라면 {{{
# xelatex --shell-escape --synctex=1 foo.tex
}}}
   * `: ` 다음에 스페이스 한 칸을 두어야 한다.
 * {{{
% 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을 컴파일한다.
== 책읽기의 낙원 링크 모음 ==
 * [[http://doeun.blogspot.kr/2013/11/arara.html 아라라를 아시나요]]
 * [[http://doeun.blogspot.kr/2013/11/arara-kotex-rule.html arara, ko.TeX 관련 rule 세 개]]
 * [[http://doeun.blogspot.kr/2013/11/arara-asymptote-gnuplottex.html asymptote와 gnuplottet 테스트]]
 * [[http://doeun.blogspot.kr/2013/11/texnicle-arara.html Texnicle에 arara 엔진 추가하기]]
 * [[http://doeun.blogspot.kr/2013/11/texshop-arara.html Texshop에 arara 엔진 추가하기]]
 * [http://doeun.blogspot.kr/2014/08/miktex-arara.html MiKTeX에서 아라라(arara standalone 설치)]
 * [[http://doeun.blogspot.kr/2013/12/arara-kotex.html arara와 ko.TeX, 요약]]
 * [[http://doeun.blogspot.kr/2014/10/arara-20141018.html tnxtex에는 (아직) arara 없음]]