EDRSPIHCRSSRSS

arara

Difference between r1.9 and the current

@@ -1,8 +1,62 @@
책읽기의 낙원 링크 모음
* [[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/arara-asymptote-gnuplottex.html Texniclearara 엔진 추가하기]]
* [[http://doeun.blogspot.kr/2013/11/texshop-arara.html Texshop에 arara 엔진 추가하기]]
* [[http://doeun.blogspot.kr/2013/12/arara-kotex.html arara ko.TeX, 요약]]
* [[http://doeun.blogspot.kr/2014/10/arara-20141018.html tnxtex에는 (아직) arara 없음]]
[[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}}}




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 install openjdk
  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