<div id="readability-page-1" class="page"><div id="gh-main">
    <article>
        <header>
                <span>
                    By <a href="/author/jiwon/">Jiwon Park</a>
                        in
                        <a href="https://www.jiwon.me/tag/tex/">TeX</a>
                    —
                    <time datetime="2021-11-05">2021년 11월 5일</time>
                </span>

            


        </header>

        <div>
            <blockquote>본 글의 내용은 Apple arm 환경에서 실행되었으며, 명령어 및 벤치마킹 결과는 운영체제나 아키텍쳐에 따라 차이가 있을 수 있습니다.</blockquote><p>논문이나 아티클을 작성하기 위해 TeX Live나 Overleaf를 사용하다 보면 느린 컴파일 속도가 인내심을 테스트하는 일이 자주 있다. 도중에 에러가 발생하면 짜증은 제곱이 된다. 심지어 TeX Live는 프로그램이 무거워서 맥북 용량이 한계에 다다르면 삭제해야 하나 말아야하나 하는 딜레마에 빠진다.</p><p>그래서 더 빠르고 편한 컴파일러를 찾던 중, Rust로 작성된 Tectonic을 발견했다.</p><p>Tectonic의 주요 컨셉은 다음과 같다.</p><ul><li>Rust를 이용해 <strong>더 빠른 컴파일</strong>을 제공한다.</li><li>TeX Live의 모든 패키지를 지원하되, 프로그램이 무거워지지 않도록 최초 빌드시에 <strong>필요한 패키지만</strong> 자동 다운로드 한다.</li><li><strong>watch 모드</strong>로 내용이 바뀌면 자동으로 컴파일을 실행한다.</li></ul><h2 id="%EC%84%A4%EC%B9%98-%EB%B0%8F-%EC%8B%A4%ED%96%89">설치 및 실행</h2><p>Tectonic은 Rust로 작성되어 있으므로 사용을 위해서는 먼저 rust 컴파일러와 rust의 패키지 매니저인 Cargo를 설치해야한다. 그러나 macOS와 linux에서는 각각 brew와 linuxbrew를 이용해 다음 명령어로 한 번에 설치가 가능하다. (windows에서는 WSL환경을 이용하는 것을 추천한다.)</p><pre><code>brew install tectonic
</code></pre><p>이미 cargo가 설치되어 있다면 다음 명령어로도 설치할 수 있다.</p><pre><code>cargo install tectonic
</code></pre><p>설치가 완료되면 프로젝트를 생성할 디렉토리로 이동 후 다음 명령어를 실행한다.</p><pre><code>tectonic -X new [project name]
</code></pre><p>프로젝트가 생성되면 다음과 같은 구조로 파일들이 생성된다.</p><pre><code>myproject
├── Tectonic.toml
└── src
    ├── _preamble.tex
    ├── _postamble.tex
    └── index.tex
</code></pre><ul><li><code>_preamble.tex</code>tex 문서의 제일 상단에 올 내용을 작성한다. 제목이나 사용할 패키지, 문서 설정들을 명시해주자.</li><li><code>_postamble.tex</code>tex 문서의 제일 마지막에 올 내용을 작성한다. 참고문헌이나 문서 정보등을 적는다.</li><li><code>index.tex</code> 문서의 주요 내용이 되는 파일이다. 여기에 원하는 내용을 작성하면 된다.</li><li><code>Tectonic.toml</code>프로젝트 설정 파일이다. 문서의 이름이나 의존성 패키지, 컴파일 결과물 등을 설정할 수 있다.</li></ul><p>프로젝트가 잘 생성되었으면 이제 컴파일을 해볼 차례다. 프로젝트의 루트 디렉토리(프로젝트 이름)에서 다음 명령어를 실행하자.</p><pre><code>tectonic -X build
</code></pre><p>build 디렉토리가 생성되면서 <code>Tectonic.toml</code>에서 설정해둔 출력물 형식으로 tex 파일이 렌더링된다.</p><p>문서를 수정하면서 자동으로 빌드되도록 하고 싶으면 다음 명령어를 사용하면 된다.</p><pre><code>tectonic -X watch
</code></pre><p>더 자세한 설명은 <a href="https://tectonic-typesetting.github.io/book/latest/index.html">tectonic 공식문서</a> 에서 확인할 수 있다.</p><h2 id="%EB%B2%A4%EC%B9%98%EB%A7%88%ED%81%AC-%EA%B2%B0%EA%B3%BC">벤치마크 결과</h2><p>몇 가지 TeX 문서를 Overleaf와 Tectonic에서 각각 테스트 해 본 결과, 대략 200% 정도의 속도 향상이 있었다. 컴파일 속도는 CPU의 싱글스레드 성능에 영향을 받으므로 더 상위급의 CPU를 사용한다면 속도 차이는 더 날 수 있다.</p><h3 id="example-butterfly-lemma"><a href="https://texample.net/tikz/examples/butterfly-lemma/">Example: Butterfly Lemma</a></h3><pre><code>tectonic -X build  0.57s user 0.07s system 92% cpu 0.685 total
</code></pre><p>tectonic: 0.69초<br>overleaf: 1.54초</p><h4 id="100%EA%B0%9C-%EC%B6%9C%EB%A0%A5">100개 출력</h4><pre><code>tectonic -X build  8.96s user 0.11s system 98% cpu 9.179 total
</code></pre><p>tectonic: 9.18초<br>overleaf: 22.41초</p><h3 id="example-circumscribed-parallelepiped"><a href="https://texample.net/tikz/examples/parallelepiped/">Example: Circumscribed Parallelepiped</a></h3><pre><code>tectonic -X build  0.55s user 0.10s system 88% cpu 0.738 total
</code></pre><p>tectonic: 0.738초<br>overleaf: 1.48초</p><h4 id="100%EA%B0%9C-%EC%B6%9C%EB%A0%A5-1">100개 출력</h4><pre><code>tectonic -X build  9.41s user 0.14s system 98% cpu 9.736 total
</code></pre><p>tectonic: 9.736초<br>overleaf: 18.62초</p><h3 id="example-plane-sections-of-the-cylinderdandelin-spheres"><a href="https://texample.net/tikz/examples/dandelin-spheres/">Example: Plane Sections of the Cylinder - Dandelin Spheres</a></h3><pre><code>tectonic -X build  4.36s user 0.11s system 92% cpu 4.837 total
</code></pre><p>tectonic: 4.837초<br>overleaf: 10.22초</p><h4 id="100%EA%B0%9C-%EC%B6%9C%EB%A0%A5-2">100개 출력</h4><pre><code>tectonic -X build  4.32s user 0.10s system 99% cpu 4.453 total
</code></pre><p>tectonic: 4.453초<br>overleaf: time out (출력안됨)</p><h2 id="%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4">레퍼런스</h2><ol><li><a href="https://tectonic-typesetting.github.io/">https://tectonic-typesetting.github.io</a></li><li><a href="https://texample.net/">https://texample.net</a></li><li><a href="https://www.overleaf.com/">https://www.overleaf.com</a></li></ol><hr><p>글을 쓰기 위한 원동력을 얻기 위해 자발적인 후원을 받고 있습니다.<br>구독 및 후원해 주신 분들께는 뉴스레터로 전용 컨텐츠가 추가 발송될 예정입니다.</p><a href="https://toss.me/panic/3000"><svg width="205" height="48" viewBox="0 0 205 48" fill="none" xmlns="http://www.w3.org/2000/svg">
<rect width="204.706" height="48" rx="11.2941" fill="#2962F6"></rect>
<path d="M60.7219 28.0687H54.6569V25.1887H59.1802V23.7995H50.3539V21.8005H58.7059V20.4282H50.3539V18.5816H59.0447V17.1586H48.5751V25.1887H52.8951V28.0687H46.864V29.5087H60.7219V28.0687ZM74.9511 24.9176L75.7135 23.4776C72.698 22.9355 70.2415 20.5807 70.2415 18.1412V16.9892H68.3949V18.1412C68.3949 20.5299 65.9384 22.9355 62.9229 23.4776L63.6683 24.9176C66.1587 24.4264 68.3102 22.8 69.3097 20.7162C70.3093 22.8 72.4608 24.4264 74.9511 24.9176ZM76.3064 27.8993H62.4486V29.3393H76.3064V27.8993ZM91.891 28.0687H85.8091V25.4598H90.5865V24.0536H81.4214V21.9191H90.2477V17.0739H79.6764V18.48H88.5197V20.5299H79.7103V25.4598H84.0642V28.0687H78.0331V29.5087H91.891V28.0687ZM110.468 19.0729V17.6838H105.182V15.9558H103.437V17.6838H98.0839V19.0729H110.468ZM99.219 22.4104C99.219 24.0536 101.133 25.0024 104.318 25.0024C107.503 25.0024 109.418 24.0536 109.418 22.4104C109.418 20.7332 107.503 19.8184 104.318 19.8184C101.133 19.8184 99.219 20.7332 99.219 22.4104ZM107.588 22.4104C107.588 23.2744 106.504 23.6979 104.318 23.6979C102.133 23.6979 101.032 23.2744 101.032 22.4104C101.032 21.5633 102.133 21.1398 104.318 21.1398C106.504 21.1398 107.588 21.5633 107.588 22.4104ZM111.264 27.3233V25.9172H97.3893V27.3233H103.437V31.3214H105.182V27.3233H111.264ZM123.918 24.9854H120.919V26.2052H123.918V27.6282H125.663V15.9896H123.918V24.9854ZM117.87 21.9699C120.106 21.9699 121.648 20.9026 121.648 19.2762C121.648 17.6499 120.106 16.5826 117.87 16.5826C115.634 16.5826 114.075 17.6499 114.075 19.2762C114.075 20.9026 115.634 21.9699 117.87 21.9699ZM117.87 17.8701C119.157 17.8701 119.988 18.4122 119.988 19.2762C119.988 20.1402 119.157 20.6824 117.87 20.6824C116.582 20.6824 115.735 20.1402 115.735 19.2762C115.735 18.4122 116.582 17.8701 117.87 17.8701ZM117.175 24.2908V27.1369H118.92V24.1892C120.225 24.1214 121.563 23.9689 122.851 23.7487L122.715 22.4951C119.462 22.9016 115.718 22.9525 112.906 22.9525L113.126 24.3755C114.346 24.3755 115.684 24.3586 117.175 24.2908ZM126.019 29.5934H116.718V26.4932H114.973V31.0165H126.019V29.5934ZM142.806 23.6132V22.1562H140.451V16.0066H138.689V31.3214H140.451V23.6132H142.806ZM133.878 18.3614V16.2268H132.133V18.3614H128.491V19.7845H137.453V18.3614H133.878ZM133.031 20.8687C130.812 20.8687 129.236 22.3426 129.236 24.4433C129.236 26.544 130.812 28.0179 133.031 28.0179C135.199 28.0179 136.826 26.544 136.826 24.4433C136.826 22.3426 135.199 20.8687 133.031 20.8687ZM133.031 26.5779C131.794 26.5779 130.896 25.7308 130.896 24.4433C130.896 23.1558 131.794 22.3087 133.031 22.3087C134.268 22.3087 135.166 23.1558 135.166 24.4433C135.166 25.7308 134.268 26.5779 133.031 26.5779ZM156.781 16.0066H155.036V31.3045H156.781V16.0066ZM152.275 17.616H145.024V19.0391H150.479C150.191 22.5628 148.277 25.2395 144.262 27.1878L145.193 28.5769C150.445 26.0358 152.275 22.1732 152.275 17.616Z" fill="white"></path>
</svg>

</a>

        </div>

            
    </article>
</div></div>

jiwon.me

본 글의 내용은 Apple arm 환경에서 실행되었으며, 명령어 및 벤치마킹 결과는 운영체제나 아키텍쳐에 따라 차이가 있을 수 있습니다.
논문이나 아티클을 작성하기 위해 TeX Live나 Overleaf를 사용하다 보면 느린 컴파일 속도가 인내심을 테스트하는 일이 자주 있다. 도중에 에러가 발생하면 짜증은 제곱이 된다. 심지어 TeX Live는 프로그램이 무거워서 맥북 용량이 한계에 다다르면 삭제해야 하나 말아야하나 하는 딜레마에 빠진다.
그래서 더 빠르고 편한 컴파일러를 찾던 중, Rust로 작성된 Tectonic을 발견했다.
Tectonic의 주요 컨셉은 다음과 같다.
Rust를 이용해 더 빠른 컴파일을 제공한다.
TeX Live의 모든 패키지를 지원하되, 프로그램이 무거워지지 않도록 최초 빌드시에 필요한 패키지만 자동 다운로드 한다.
watch 모드로 내용이 바뀌면 자동으로 컴파일을 실행한다.
설치 및 실행
Tectonic은 Rust로 작성되어 있으므로 사용을 위해서는 먼저 rust 컴파일러와 rust의 패키지 매니저인 Cargo를 설치해야한다. 그러나 macOS와 linux에서는 각각 brew와 linuxbrew를 이용해 다음 명령어로 한 번에 설치가 가능하다. (windows에서는 WSL환경을 이용하는 것을 추천한다.)
brew install tectonic
이미 cargo가 설치되어 있다면 다음 명령어로도 설치할 수 있다.
cargo install tectonic
설치가 완료되면 프로젝트를 생성할 디렉토리로 이동 후 다음 명령어를 실행한다.
tectonic -X new [project name]
프로젝트가 생성되면 다음과 같은 구조로 파일들이 생성된다.
myproject
├── Tectonic.toml
└── src
    ├── _preamble.tex
    ├── _postamble.tex
    └── index.tex
_preamble.textex 문서의 제일 상단에 올 내용을 작성한다. 제목이나 사용할 패키지, 문서 설정들을 명시해주자.
_postamble.textex 문서의 제일 마지막에 올 내용을 작성한다. 참고문헌이나 문서 정보등을 적는다.
index.tex 문서의 주요 내용이 되는 파일이다. 여기에 원하는 내용을 작성하면 된다.
Tectonic.toml프로젝트 설정 파일이다. 문서의 이름이나 의존성 패키지, 컴파일 결과물 등을 설정할 수 있다.
프로젝트가 잘 생성되었으면 이제 컴파일을 해볼 차례다. 프로젝트의 루트 디렉토리(프로젝트 이름)에서 다음 명령어를 실행하자.
tectonic -X build
build 디렉토리가 생성되면서 Tectonic.toml에서 설정해둔 출력물 형식으로 tex 파일이 렌더링된다.
문서를 수정하면서 자동으로 빌드되도록 하고 싶으면 다음 명령어를 사용하면 된다.
tectonic -X watch
더 자세한 설명은 tectonic 공식문서 에서 확인할 수 있다.
벤치마크 결과
몇 가지 TeX 문서를 Overleaf와 Tectonic에서 각각 테스트 해 본 결과, 대략 200% 정도의 속도 향상이 있었다. 컴파일 속도는 CPU의 싱글스레드 성능에 영향을 받으므로 더 상위급의 CPU를 사용한다면 속도 차이는 더 날 수 있다.
Example: Butterfly Lemma
tectonic -X build  0.57s user 0.07s system 92% cpu 0.685 total
tectonic: 0.69초
overleaf: 1.54초
100개 출력
tectonic -X build  8.96s user 0.11s system 98% cpu 9.179 total
tectonic: 9.18초
overleaf: 22.41초
Example: Circumscribed Parallelepiped
tectonic -X build  0.55s user 0.10s system 88% cpu 0.738 total
tectonic: 0.738초
overleaf: 1.48초
100개 출력
tectonic -X build  9.41s user 0.14s system 98% cpu 9.736 total
tectonic: 9.736초
overleaf: 18.62초
Example: Plane Sections of the Cylinder - Dandelin Spheres
tectonic -X build  4.36s user 0.11s system 92% cpu 4.837 total
tectonic: 4.837초
overleaf: 10.22초
100개 출력
tectonic -X build  4.32s user 0.10s system 99% cpu 4.453 total
tectonic: 4.453초
overleaf: time out (출력안됨)
레퍼런스
https://tectonic-typesetting.github.io
https://texample.net
https://www.overleaf.com
글을 쓰기 위한 원동력을 얻기 위해 자발적인 후원을 받고 있습니다.
구독 및 후원해 주신 분들께는 뉴스레터로 전용 컨텐츠가 추가 발송될 예정입니다.

Rust로 작성된 $\TeX$ 컴파일러, Tectonic

댓글