업데이트 내역

2019.5.25 - latexmk를 사용하는 방법으로 변경. 크게 다시 썼습니다.
2019.4.16 - 초판 공개

필자의 환경

Windows 10 Home

TeX Live 2018

Visual Studio Code(이하, VS Code로 약칭하는 경우 있음)

LaTeX Workshop (Plugin)

[1] TeX Live 설치

TeX Live ISO 다운로드는 여기
Acquiring TeX Live as an ISO image - TeX Users Group

[2] pLaTeX 동작 확인

적절한 TeX 파일을 만들고 명령으로 동작을 확인했습니다. 정상적으로 PDF화되면 OK.

※파일명은 확장자 없이.

platex filename
dvipdfmx filename

[3] Visual Studio Code 설치

Visual Studio Code – 코드 편집기 | Microsoft Azure

[4] LaTeX Workshop 설치

LaTeX Workshop - Visual Studio Marketplace

[5] Latexmk 초기 설정

Latexmk는 여러 번 컴파일 ~ PDF 작성까지 모두 자동으로 해주는 도구입니다. (스스로 여러 번 컴파일 할 필요가 없습니다.) 이번에는 이것을 사용합니다.

명령 프롬프트를 시작하고 다음 명령을 실행합니다.

cd %USERPROFILE%
copy nul .latexmkrc
code .latexmkrc

다음을 복사하여 저장합니다.

#!/usr/bin/env perl
$latex            = 'platex %B -halt-on-error';
$latex_silent     = 'platex %B -halt-on-error -interaction=batchmode';
$bibtex           = 'pbibtex';
$biber            = 'biber --bblencoding=utf8 -u -U --output_safechars';
$dvipdf           = 'dvipdfmx %B';
$makeindex        = 'mendex %O -o %D %S';
$max_repeat       = 5;
$pdf_mode         = 3;
$pvc_view_file_via_temporary = 0;

[6] LaTeX Workshop 초기 설정

VS Code를 시작하고 Ctrl+,에서 설정을 엽니 다.

화면 오른쪽 상단의 {} 아이콘을 클릭하여 settings.json을 엽니 다.

setting.json은 VS Code 설정이 작성된 파일입니다. LaTeX workshop에서는, 처음부터 Latexmk에 대응한 설정이 쓰여져 있습니다만, 이대로라면 platex에서는 사용할 수 없기 때문에, 아래를 덧붙입니다.

settings.json

"latex-workshop.latex.tools": [
    {
            "name": "latexmk",
            "command": "latexmk",
            "args": [
                "%DOCFILE%"
            ],
            "env": {}
        },
],
"latex-workshop.latex.recipes": [
    {
            "name": "latexmk 🔃",
            "tools": [
                "latexmk"
            ]
        }
],
"latex-workshop.view.pdf.viewer": "browser"

[7] 실제로 TeX를 써 보자

VS Code에서 적절한 TeX 파일을 열고 편집.

Ctrl+Shift+P에서 명령 팔레트를 엽니 다.

LaTeX Workshop:Build with recipe 선택.

latexmk 🔃 선택.

처리가 완료되면 명령 팔레트를 다시 열고 LaTeX Workshop:View LaTeX PDF file in VSCode tab에서 PDF를 확인할 수 있습니다.

또한 한 번 수동으로 컴파일 처리를 실시하면 TeX 파일을 실시간으로 감시 · 자동 컴파일 해주기 때문에 실시간으로 미리보기가 가능하다.
(settings.json에 여러 recipe가있는 경우 맨 위가 우선합니다)

[8] LaTeX Workshop의 상태가 좋지 않을 때

그러나 (나의 설정 방법이 나쁜 것일지도 모르지만), LaTeX Workshop에서, 컴파일이 처리중인 채 진행되지 않게 되어 버리는 일이 있다. 그 경우에는

Ctrl+Shift+P에서 명령 팔레트를 엽니 다.

LaTeX Workshop:Kill LaTeX compiler process 선택.

처리가 중지되면 다시 컴파일을 시도합니다.