Texmaker

Texmaker는 프랑스의 Pascal Brachet이 2003년부터 개발한 무료 오픈 소스 LaTeX IDE입니다. 이는 Windows, macOS 및 Linux, 수집 편집기, PDF 뷰어, 빌드 구성 및 완료를 단일 창으로 실행합니다. 최신 TeXstudio는 Texmaker의 포크입니다. 이것이 바로 둘이 비슷하게 보이는 이유입니다. 이 페이지에서는 Texmaker의 특징인 빌드 구성(빠른 빌드), 쓰기 속도를 높이는 완성 및 구조 보기, 소스와 PDF 간 이동을 위한 SyncTeX 등을 안내합니다.

텍스메이커란?

Texmaker는 Qt로 작성되었으므로 세 가지 운영 체제에서 거의 동일하게 보이고 동작합니다. GPL(GNU General Public License, v2)에 따라 배포됩니다. 무료로 사용하고 수정할 수 있습니다. Unicode 지원, 철자 검사, 코드 접기(\part, \chapter, \section 및 \begin{...}…\end{...} 블록 축소 가능), 400개 이상의 수학 기호 팔레트 및 내장 PDF 뷰어를 제공합니다. 첫 번째 릴리스는 2003년 5월 29일에 출시되었으며 현재 안정 버전은 6.0.1, 2025년 4월 26일에 릴리스입니다.

핵심은 Texmaker가 LaTeX 자체를 번들로 제공하지 않는다는 것입니다. 컴파일은 별도로 설치한 Texmaker 실행 명령(pdflatex, uplatex, dvipdfmx 등)을 사용하여 작동합니다. 따라서 설치 순서는 TeX 배포판 먼저(예: TeX Live 2026), 그 다음 Texmaker입니다. Texmaker 측에서 수행하는 작업은 해당 명령이 어떻게 연결되는지 구성하는 것뿐입니다.

TeXstudio와의 관계를 이해하는 데 도움이 됩니다. TeXstudio는 Texmaker 코드베이스에서 분기되어 문법 검사 및 미러 커서와 같은 자체 기능을 추가하는 별도의 프로젝트입니다. 대략적인 구분은 Texmaker가 원본에서 기대하는 것처럼 단순한 구성을 유지하는 반면, TeXstudio는 더 많은 기능을 제공한다는 것입니다. 둘 다 동일한 모델을 공유하므로 한 쪽이 편안하면 다른 쪽도 즉시 이전됩니다.

빌드 구성(빠른 빌드)

모든 설정은 옵션 → Texmaker 구성(macOS에서는 기본 설정이라고 함) 아래에 있습니다. 빌드를 관리하는 두 섹션이 있습니다. 명령은 각 명령이 실제로 무엇인지(실행 파일과 해당 인수)를 지정하고 빠른 빌드는 실행 순서를 선택합니다.

Texmaker의 핵심은 빠른 빌드입니다. 도구 모음 버튼(또는 F1 키)을 한 번 누르면 선택한 명령 순서가 시작부터 끝까지 실행됩니다. Quick Build 섹션에는 일반적인 조합이 라디오 버튼으로 나열되며 사용자는 그 중 하나를 선택합니다.

• PdfLaTeX + PDF 보기 — pdfLaTeX로 직접 PDF를 만들고 표시합니다. 배송된 기본값; 대부분 서양 텍스트에 적합합니다.
• LaTeX + dvips + Ps 보기 — DVI를 통해 이동하여 dvips를 사용하여 PostScript로 변환한 다음 표시합니다.
• LaTeX + dvipdfm + PDF 보기 — DVI를 통해 dvipdfm(x)을 사용하여 PDF로 변환한 다음 표시합니다. 일본인의 표준 노선.
• 사용자: (직접 정의) — 위 필드의 |와 함께 원하는 명령을 연결하여 사용자 정의 흐름을 구축합니다.

각 명령의 인수에서 %는 확장자(마스터 모드의 마스터 문서 이름) 없이 파일 이름으로 확장됩니다. 예를 들어 Commands 섹션의 PdfLaTeX 필드는 기본적으로 다음과 같이 읽습니다. -interaction=nonstopmode는 오류 시 중지되지 않도록 하며 -synctex=1는 아래에 설명된 SyncTeX 정보를 내보냅니다.

pdflatex -synctex=1 -interaction=nonstopmode %.tex

참고문헌, 색인 및 재실행 횟수를 자동으로 처리하려는 경우 다른 옵션은 빠른 빌드 "사용자" 필드에 latexmk를 입력하는 것입니다. latexmk는 종속성을 해결하고 필요한 만큼 각 단계를 실행하므로 조합을 직접 배치할 필요가 없습니다.

latexmk -pdf -synctex=1 -interaction=nonstopmode %.tex

빠른 빌드 경로 하나를 선택하세요.

Texmaker에서는 F1이 무엇을 실행하는지 정확히 알면 글쓰기 리듬이 안정됩니다. 디버깅하는 동안 pdfLaTeX, upLaTeX 및 LuaLaTeX 사이를 전환하는 대신 진지한 글쓰기가 시작되기 전에 해당 원고에 대한 하나의 표준 경로를 선택하세요. 나중에 변경하면 그림, 글꼴, 참고문헌 및 줄 바꿈에 영향을 미칠 수 있습니다.

• 대부분 서양 보고서의 경우 PdfLaTeX + PDF 보기 또는 latexmk를 호출하는 사용자 설정으로 시작합니다.
• 상속된 일본어 템플릿의 경우 LaTeX 필드를 uplatex로, Dvipdfm 필드를 dvipdfmx로 설정하고 LaTeX + dvipdfm + PDF 보기를 선택합니다.
• OpenType 글꼴을 사용하는 새 일본어 문서의 경우 LuaLaTeX 사용자 설정을 준비하고 유지하세요.
• F1이 동일한 명령 시퀀스를 안정적으로 실행한 후에만 장과 참조로 확장해야 합니다.

일본어용 빌드 구성

일본어의 오랜 표준은 upLaTeX + dvipdfmx입니다. Texmaker에서는 두 곳을 변경합니다. 먼저 명령 섹션에서 LaTeX 필드를 uplatex를 사용하도록 다시 작성하고 Dvipdfm 필드를 dvipdfmx를 사용하도록 다시 작성합니다. 그런 다음 Quick Build에서 “LaTeX + dvipdfm + View Pdf”를 선택합니다. 이제 F1을 누르면 upLaTeX → dvipdfmx를 순서대로 처리하고 PDF가 열립니다.

TeX Wiki에서 제공하는 구체적인 Windows 설정은 다음과 같습니다. -kanji=utf8는 입력 인코딩을 UTF-8로 수정하고 -no-guess-input-enc는 인코딩 자동 감지를 끕니다. -synctex=1를 잊지 않는 것이 역검색 작업의 핵심입니다.

uplatex -no-guess-input-enc -kanji=utf8 -synctex=1 -interaction=nonstopmode %.tex

dvipdfmx %.dvi

다른 경로는 LuaLaTeX이며, 일본어로 새로 시작하는 경우 단계가 더 적습니다. Commands 아래의 LuaLaTeX 필드가 순서대로 되어 있는지 확인하고 Quick Build "User" 필드에 lualatex -synctex=1 -interaction=nonstopmode %.tex를 넣으면 DVI 없이 바로 PDF로 이동합니다(일본어는 luatexja 패키지 또는 ltjsarticle 클래스를 통해 처리됩니다). 구성을 한 곳에 유지하려는 경우 .latexmkrc에서 upLaTeX 또는 LuaLaTeX 흐름을 설명하고 Texmaker가 latexmk만 호출하도록 할 수도 있습니다.

빌드 실패 체크리스트

Texmaker의 단순성으로 인해 고장 진단도 간단해집니다. F1이 실패하면 Quick Build 체인을 다시 작성하기 전에 두 가지 질문으로 구분하세요. 로그에는 무엇을 말하고 외부 명령이 전혀 시작될 수 있습니까? 긴 논문과 짧은 보고서에 동일한 순서가 적용됩니다.

• 메시지/로그 파일 패널에서 시작합니다. 줄 번호를 클릭할 수 있는 경우 첫 번째 오류가 발생한 소스 위치로 이동합니다.
• Could not start the command의 경우 터미널에서 pdflatex --version 또는 uplatex --version를 실행하고 PATH를 먼저 수정하세요.
• PDF만 새로 고침에 실패하는 경우 내장 뷰어에 이전 파일이 보관되어 있는지, Quick Build에 View Pdf가 포함되어 있는지 확인하세요.
• 일본어만 실패하는 경우 LaTeX 및 Dvipdfm 필드가 일관된 upLaTeX + dvipdfmx 경로를 형성하는지 확인하세요.

완성 및 구조보기

Texmaker의 완성으로 키 입력이 줄어듭니다. \ 다음에 문자를 입력하면 후보 명령 목록이 팝업되고 문자를 추가하면 범위가 좁아집니다. 주요 LaTeX 명령은 이 방법으로 빠르게 삽입할 수 있으며 인수를 취하는 명령의 경우 입력 지점(자리 표시자)이 표시되므로 중괄호를 차례로 채울 수 있습니다.

상호 참조도 도움을 받습니다. \ref{...} 또는 \pageref{...}를 작성하면 문서에 있는 레이블이 제공되고, \cite{...}는 참고문헌 키를 삽입합니다. 이름을 반쯤 기억하려고 애쓰는 일이 덜 자주 발생합니다.

왼쪽의 구조 보기는 입력할 때 자동으로 업데이트되는 문서 지도입니다. 제목(\section 및 그 친구들), 레이블(\label) 및 \input/\include를 통해 가져온 파일을 계층 구조로 배치합니다. 항목을 클릭하면 해당 지점으로 이동합니다. 긴 원고나 여러 파일로 구성된 프로젝트에서도 전체 그림을 잃지 않고 이동할 수 있습니다.

SyncTeX(정방향 및 역방향 검색)

SyncTeX는 소스 라인을 PDF의 위치와 그 반대로 매핑합니다. Texmaker의 내장 PDF 뷰어는 이를 지원하여 정방향 검색(편집기의 행에서 PDF의 일치 위치로 점프) 및 역 검색(PDF의 한 지점에서 해당 소스 행으로 뒤로 점프)을 제공합니다. 교정하는 동안 "이 단락을 생성한 줄"에 대한 검색이 사라집니다.

이를 가능하게 하는 두 가지 조건이 있습니다. 먼저 -synctex=1를 컴파일 명령에 전달하여 동기화 파일(.synctex.gz)이 생성되도록 합니다. 위에 표시된 대로 명령을 작성하는 것으로 충분합니다. 둘째, 내장 뷰어에서 PDF를 엽니다(명령 섹션에서 PDF Viewer를 내장 뷰어로 설정하고 기본 창에 도킹하려면 "포함"을 활성화합니다). 외부 뷰어에서 열면 양방향 점프가 비활성화됩니다.

제스처는 간단합니다. 매뉴얼에 따르면, 컴파일 명령에 -synctex=1를 사용하면 내장 뷰어가 현재 줄에 해당하는 PDF의 위치로 자동으로 이동합니다 — 이것이 정방향 검색입니다. 역검색의 경우 내장 뷰어에서 단어를 마우스 오른쪽 버튼으로 클릭하고 상황에 맞는 메뉴에서 선택하면 편집기가 일치하는 줄로 이동합니다.