1단계
폴더 등록
VS Code에서는 폴더 단위로 작업을 합니다. 프로젝트는 .tex 파일 하나가 아니라, 그림·코드 등 관련 파일을 포함한 하나의 폴더입니다.
완료할 작업
원고 프로젝트 전체가 하나의 신뢰할 수 있는 VS Code workspace로 열립니다.
시작 전 확인
- main
.tex파일과 관련 파일이 들어 있는 압축 해제된 프로젝트 폴더가 필요합니다. - LaTeX Workshop이 정상적으로 설치되어 있어야 합니다.
검증 상태
- 상태
- 재검증 필요
- 환경
- Windows는 상세 screenshot 경로이며 macOS와 Linux도 같은 Open Folder 흐름을 사용합니다.
- 검증 대상
- VS Code Open Folder, Workspace Trust, Explorer, LaTeX Workshop build.
- 마지막 검증
- 현재 제품 기준 walkthrough 대기 중.
- 운영체제 지원
- Windows 상세 지원, macOS와 Linux는 대응하는 VS Code control로 지원.
폴더 열기
왼쪽 사이드바에서 Open Folder를 클릭합니다.
원고와 관련 파일이 함께 들어 있는 폴더를 선택합니다.
이렇게 연 폴더를 workspace라고 합니다. 위 그림에서는 Seed document 폴더가 작업 공간입니다. trust prompt가 나오면 본인 폴더일 때만 허용합니다.
폴더를 무사히 열었다면 다음과 같은 화면을 확인할 수 있습니다.
자주 생기는 실수
Downloads 폴더, ZIP 임시 미리보기, 또는 실제 폴더보다 더 안쪽 하위 폴더에서 바로 작업을 시작하지 않습니다.
LaTeX Workshop이 main file을 찾지 못한다면, 확장 문제보다 잘못 열린 폴더가 원인인 경우가 많습니다.
첫 빌드 실행
- 터미널 명령 대신 LaTeX Workshop으로 빌드를 실행합니다.
- PDF 미리보기를 열고 문서가 오류 없이 컴파일되는지 확인합니다.
- template이 오류 없이 빌드되면 배포판, 에디터, 확장이 모두 함께 작동하는 것입니다.
다른 폴더 열기
다른 등록된 폴더를 열고 싶다면, Ctrl + R (macOS: Cmd + R)을 입력하여 다른 폴더를 선택하면 됩니다.
Explorer에 폴더 전체가 보이고, main 파일이 그 안에 있으며, 첫 빌드가 오류 없이 완료되면 다음으로 넘어갑니다.
자주 발생하는 문제
- 파일 하나나 하위 폴더만 열면 실제 프로젝트 root가 보이지 않을 수 있습니다.
- Workspace Trust는 자신이 알고 관리하는 폴더에서만 허용해야 합니다.
완료 확인
Explorer에 프로젝트 tree가 보이고 그 안에 main .tex 파일이 있으며 PDF build가 성공합니다.