설치하고 로그인하기

데스크톱 앱은 웹과 같은 프로젝트, 공저자, 기록을 별도의 창에서 보여 줍니다.

방법

1. 프로젝트 페이지에서 계정 메뉴를 열어 ‘데스크톱 앱 다운로드’를 고르거나, 사이트 바닥글에서 ‘다운로드’ 페이지를 여세요.
2. 내 컴퓨터에 맞는 파일을 고르세요. macOS는 Apple 실리콘 또는 Intel, Windows는 설치 프로그램, Linux는 AppImage, .deb 또는 .rpm입니다.
3. 앱을 열고 ‘브라우저로 로그인’을 고르면 브라우저가 열려 로그인 코드를 보여 주고, 앱에도 같은 코드가 표시됩니다.
4. 브라우저의 코드가 앱에 표시된 것과 같은지 확인한 뒤 ‘계속’을 고르세요. 앱이 로그인된 상태로 열립니다.
5. 브라우저를 거치고 싶지 않다면 ‘이 창에서 로그인’을 고르세요.

이 컴퓨터에서 컴파일하기

데스크톱 앱에서는 프로젝트를 JointTex 서버가 아니라 이미 설치해 둔 TeX로, 또는 컨테이너 안의 TeX Live로 빌드할 수 있습니다.

방법

1. 프로젝트에서 ‘설정’을 열고 ‘컴파일’로 가서 ‘컴파일 위치’를 찾으세요.
2. ‘이 컴퓨터’를 고르면 여기에 설치된 TeX Live, MacTeX 또는 MiKTeX를 쓰고, ‘이 컴퓨터 (Docker)’나 ‘이 컴퓨터 (Podman)’를 고르면 내 파일과 격리된 컨테이너에서 빌드합니다. ‘JointTex 서버’도 고를 수 있습니다.
3. 설정 아래의 줄을 읽으세요. 찾아낸 로컬 TeX의 이름을 알려 주거나 무엇이 빠졌는지 알려 줍니다.
4. 처음에는 앱이 Compile on this computer?라고 묻습니다. 함께 쓰는 사람들을 신뢰한다면 Allow를 고르세요. 답은 나중에 메뉴 항목 Compiling on This Computer…에서 바꿀 수 있습니다.
5. 평소처럼 컴파일하세요. PDF, 문제 탭, PDF와 소스 사이의 이동이 똑같이 동작합니다.

창과 업데이트

앱은 여러 프로젝트를 나란히 열어 둘 수 있고, 새 버전이 나오면 알려 줍니다.

방법

1. File → New Window를 고르면 프로젝트 목록이 있는 창이 하나 더 열립니다.
2. 프로젝트 페이지에서 프로젝트 메뉴의 ‘새 창에서 열기’를 고르면 그 프로젝트가 별도의 창에서 열립니다.
3. macOS에서는 앱 메뉴에서, Windows와 Linux에서는 File 메뉴에서 Check for Updates…를 고르세요.
4. 업데이트가 있으면 Download를 고른 뒤, 내려받은 설치 프로그램을 열어 지금 쓰는 버전을 교체하세요.

Ctrl+N으로 새 창을 엽니다. Ctrl+W로 현재 탭을 닫는데, 브라우저에서는 허용되지 않는 키입니다.

로컬 컴파일이 실패할 때

이 컴퓨터에서의 컴파일은 여기에 무엇이 설치되어 있는지에 달려 있으므로, 대부분의 실패는 문서 밖에서 해결됩니다.

방법

1. TeX 설치를 찾을 수 없음: TeX Live나 MiKTeX를 설치하거나 ‘컴파일 위치’를 ‘JointTex 서버’로 설정하세요.
2. latexmk를 찾을 수 없음: BasicTeX 같은 최소 설치에는 들어 있지 않습니다. 터미널에서 tlmgr install latexmk(macOS에서는 sudo tlmgr install latexmk)를 실행하거나 MiKTeX Console에서 latexmk 패키지를 설치하세요.
3. Docker나 Podman이 설치되어 있지만 실행 중이 아님: 실행하거나 다른 컴파일 위치를 고르세요.
4. 이 컴퓨터의 TeX로 컴파일하는 것이 허용되지 않음: 몇 초 뒤 다시 컴파일하면 다시 묻습니다. 메뉴의 Compiling on This Computer…에서 바꿀 수도 있습니다.
5. 이 프로젝트의 파일 이름을 이 컴퓨터에 쓸 수 없음: 파일 이름을 바꾸거나 JointTex 서버에서 컴파일하세요.
6. 소스와 PDF의 위치를 연결할 수 없음: TeX 배포판의 synctex 프로그램을 설치하거나 JointTex 서버에서 컴파일하세요.