도움말 센터
LaTeX와 Typst 프로젝트를 작성하고 컴파일하며 공유하기 위한 실용적인 안내입니다.
Typst 온라인 편집기로 함께 쓰기
온라인 Typst 편집기. 공동 저자와 실시간으로 함께 쓰고, 입력하는 대로 브라우저에서 PDF가 컴파일되며, 패키지·인용·AI 도움을 지원합니다.
Typst 프로젝트 시작하기
JointTex는 LaTeX뿐 아니라 Typst를 위한 온라인 편집기이기도 합니다. Typst 프로젝트는 아무것도 설치하지 않고 브라우저에서 쓰고, 컴파일하고, 공유합니다.
방법
- ‘프로젝트’를 열고 ‘새 프로젝트’를 선택한 뒤 빈 프로젝트 카드에서 Typst를 고르세요. 프로젝트는 main.typ와 references.bib 파일로 시작하며, main.typ는 이미 #bibliography로 그 파일을 지정하고 있습니다.
- Typst 템플릿에서 시작할 수도 있습니다. 템플릿이 LaTeX인지 Typst인지는 루트 파일이 정하고, 그 템플릿으로 만든 프로젝트도 같은 방식으로 컴파일됩니다.
- Word나 Markdown 초안을 Typst로 가져오기: ‘새 프로젝트’에서 ‘파일에서 가져오기’를 고르고 .docx 또는 .md 파일을 선택한 뒤, 변환할 형식으로 Typst를 고르세요.
- 한 프로젝트에 두 언어를 함께 둘 수 있습니다. 어느 쪽으로 컴파일할지는 루트 파일이 정합니다. 루트가 .typ 파일이면 Typst로 컴파일되며, 루트 파일은 프로젝트 설정에서 바꿉니다.
입력하면서 PDF 보기
Typst는 편집기 페이지 안에서 실행되므로, 입력을 멈추고 잠시 뒤면 PDF가 따라옵니다. 따로 누를 컴파일 버튼이 없습니다.
방법
- Typst 프로젝트에서는 ‘자동 컴파일’이 처음부터 켜져 있습니다. 공동 작업자의 편집도 내 미리보기를 다시 컴파일합니다.
- 오류와 경고는 소스에 밑줄로 표시되고 문제 탭에 나열되며, 오류를 고칠 때까지 마지막으로 컴파일된 PDF가 화면에 남아 있습니다.
- PDF의 아무 곳이나 더블 클릭하거나 Cmd/Ctrl을 누른 채 클릭하면 그 부분을 만든 소스로 이동하고, {mod+j}를 누르면 커서에서 PDF로 이동합니다. 위치는 Typst 컴파일러가 직접 알려 줍니다.
- 커서 아래의 수식은 쓰는 대로 조판되어 보이고, 개요에는 열려 있는 파일의 제목이 나열됩니다.
- 브라우저에서는 다운로드와 인쇄가 같은 Typst 버전으로 서버에서 다시 컴파일하므로, 공유하는 파일은 프로젝트 자체의 PDF입니다.
Typst Universe 패키지 쓰기
Typst 레지스트리에 게시된 패키지는 다른 곳에서와 똑같이 동작합니다.
방법
- #import "@preview/name:version"으로 패키지를 가져오세요. 컴파일에 처음 필요할 때 받아 옵니다.
- 서버의 컴파일은 네트워크 없이 실행되지만, @preview로 게시된 패키지는 무엇이든 쓸 수 있습니다.
- @local 네임스페이스의 패키지는 한 사람의 컴퓨터에만 있으므로 쓸 수 없습니다. 패키지 파일을 프로젝트에 넣고 경로로 가져오세요.
.bib 파일에서 인용하기
Typst는 LaTeX와 같은 .bib 파일을 읽습니다. 문서는 #bibliography로 파일을 지정하고 @key로 항목을 인용합니다.
방법
- {mod+alt+c}를 누르거나 도구 모음의 ‘인용 삽입’(@)을 고르면 이 프로젝트, 개인 라이브러리, Crossref 등 온라인 자료, Zotero, 지원 요금제의 이전 프로젝트를 검색해, 항목을 .bib 파일에 적고 @key를 삽입합니다.
- @key나 .bib·.yml 파일의 키 위에서 F2를 누르면 이름을 바꿀 수 있습니다. 항목과 모든 인용이 함께 바뀝니다.
- 인용한 항목을 Crossref와 arXiv로 검증하려면 ‘프로젝트 검사’를 열고 ‘참고 문헌’을 고르세요.
함께 쓰기
공동 저자는 LaTeX 프로젝트처럼 Typst 프로젝트도 동시에 편집하며, 모든 변경에 작성자가 남습니다.
방법
- ‘공유’ 대화상자에서 공동 저자를 초대하세요. 모두가 서로의 커서와 편집을 실시간으로 봅니다.
- 구절을 선택해 댓글을 달고, ‘검토’에서 ‘내 편집 추적’을 켜 내 변경이 제안으로 들어가게 하고, ‘기록’에서 이전 어느 버전으로든 돌아갈 수 있습니다.
- 두 버전을 변경 표시 PDF로 비교하세요. typdiff는 바뀐 모든 .typ 파일에서 추가된 내용에 밑줄을, 삭제된 내용에 취소선을 긋습니다.
AI 어시스턴트에게 묻기
어시스턴트는 프로젝트가 Typst로 쓰였는지 알고 Typst로 작성합니다.
방법
- AI 패널을 열고 표, 그림, show 규칙, 또는 컴파일 오류 수정을 요청하세요.
- ‘변경 추적’이 켜져 있으면(기본값입니다) 어시스턴트가 한 편집은 모두 표시되며, 하나씩 또는 한꺼번에 유지하거나 버릴 수 있습니다.
- 문제 탭에서 오류 하나 또는 전부의 설명이나 수정을 요청하세요. 어시스턴트는 소스를 고친 뒤 다시 컴파일해 수정을 확인합니다.
데스크톱 앱과 오프라인에서 작업하기
Typst 프로젝트는 브라우저에서도 데스크톱 앱에서도 TeX 설치가 필요 없습니다.
방법
- 데스크톱 앱에서는 Typst 프로젝트가 입력하는 동안 앱 창에서 컴파일되고, 저장하거나 인쇄하는 PDF도 바로 그 PDF이며 연결이 필요 없습니다.
- 브라우저에서는 열어 본 프로젝트가 오프라인용으로 보관되므로 연결이 끊겨도 계속 쓸 수 있습니다.
지금은 LaTeX 파일에서만 되는 것
몇몇 도구는 LaTeX 소스를 읽거나 쓰기 때문에 아직 .typ 파일에서는 동작하지 않습니다.
방법
- ‘문서 서식 지정’과 Copy As는 .tex 파일용입니다.
- ‘수학 기호’ 섹션은 LaTeX 명령을 삽입하며, .typ 파일이 열려 있는 동안에는 스크린샷에서 수식을 인식하는 기능이 비활성화됩니다.
- .typ 파일에 붙여 넣은 표나 이미지는 변환되지 않습니다. 표는 일반 텍스트로 들어오고 이미지는 저장되지 않습니다.