도움말 센터
LaTeX와 Typst 프로젝트를 작성하고 컴파일하며 공유하기 위한 실용적인 안내입니다.
Git·GitHub·WebDAV 연동
Git으로 프로젝트 파일을 주고받거나 GitHub 및 외부 저장소와 동기화합니다.
알맞은 연결 방식 고르기
연구팀의 작업 방식에 맞춰 Git, GitHub 동기화, WebDAV를 선택하세요. 교육, Plus, Pro 요금제에서 사용할 수 있습니다.
방법
- 익숙한 명령줄 흐름으로 내 컴퓨터에서 작업하고 싶다면 Git을 쓰세요.
- 팀이 이미 리뷰하고 배포하는 저장소가 기준이라면 GitHub 동기화를 쓰세요.
- 코드 호스팅이 아니라 기관이나 개인 저장소에 놓여야 한다면 WebDAV를 쓰세요.
- 함께 써도 되지만, 두 번째를 연결하기 전에 어느 쪽을 기준으로 삼을지 정하세요.
- 누구의 요금제를 따르는지는 서로 다릅니다. Git 접근은 내 요금제를, GitHub와 WebDAV 동기화는 프로젝트 소유자의 요금제를 따릅니다.
- 이미 다른 곳에 있는 파일로 시작하려면 대시보드에서 ‘GitHub 또는 WebDAV에서 가져오기’를 고르세요. 저장소 브랜치나 WebDAV 폴더에서 프로젝트를 만들고 연결된 상태로 유지합니다.
연결 설정하기
연결 방식에 맞는 인증 정보를 준비한 뒤 동기화할 프로젝트에서 연결을 설정하세요.
방법
- 명령줄 Git: 계정 설정의 액세스 토큰에서 Git 토큰을 만드세요. 프로젝트에서 Git을 펼쳐 저장소 URL이나 clone 명령을 복사하고, 토큰을 HTTP Basic 비밀번호로 씁니다. 뷰어는 clone과 pull이 가능하고, 소유자와 편집자는 main으로 푸시도 할 수 있습니다.
- 프로젝트보다 뒤처진 푸시는 나와 공동 작업자가 서로 다른 파일을 바꿨다면 자동으로 병합됩니다. 양쪽이 같은 파일을 바꿨다면 푸시가 거부되고 해당 경로를 알려 줍니다. git pull을 실행해 해결한 뒤 다시 푸시하세요.
- GitHub 동기화: 계정 설정의 외부 연결에서 GitHub를 연결하고, 원하는 저장소에 JointTex GitHub App을 설치하세요. 그다음 프로젝트의 외부 연결 뷰에서 GitHub를 열어 기존 저장소와 브랜치를 고르고, 전체 변경 미리보기를 확인한 뒤 수동 동기화를 확정합니다.
- JointTex는 .github/workflows를 제외한 저장소 루트 전체를 동기화합니다. 서브모듈이 포함된 저장소는 동기화할 수 없습니다. 동기화는 항상 수동입니다. GitHub에서 바뀐 내용은 ‘검토 및 동기화’를 고르기 전까지 프로젝트에 표시만 됩니다.
- 새 저장소를 쓰려면 ‘GitHub에서 저장소 만들기’를 고르고, 필요하면 GitHub App에 그 저장소의 접근 권한을 준 다음 ‘저장소 새로 고침’을 고르세요. 빈 저장소라면 JointTex가 첫 동기화 때 브랜치를 만듭니다.
- WebDAV: 계정 설정 › 외부 연결에서 루트 폴더 URL, 사용자 이름, 앱 비밀번호로 재사용 가능한 프로필을 저장하거나, 한 프로젝트에만 쓸 자격 증명을 입력하세요. 프로젝트 폴더를 고르고 연결을 시험한 뒤, 첫 동기화 내용을 확인하고 연결합니다.
WebDAV 동기화 유지하기
WebDAV 폴더에는 이유가 있을 때만 접속하므로, 원격에만 있는 변경은 다음 동기화를 기다립니다.
방법
- 원격에만 있는 WebDAV 변경을 가져와야 할 때는 지금 동기화를 쓰세요. 선택 사항인 WebDAV 자동 동기화는 JointTex 프로젝트가 바뀐 뒤에만 실행되며, 세 번 연속 실패하면 수동 동기화가 성공할 때까지 멈춥니다.
- 첫 미리보기에 충돌이 보이면 연결해도 어떤 파일도 바뀌지 않습니다. 연결이 만들어진 뒤에 충돌을 검토하세요.
- 한 프로젝트에만 입력한 자격 증명은 나중에 ‘계정 프로필로 저장’으로 다른 프로젝트에서도 쓸 수 있게 남길 수 있습니다.
충돌 해결과 접근 관리
동기화 충돌이 발생하면 차이를 확인하고 유지할 버전을 선택하세요. 연결 권한은 프로젝트 역할에 따릅니다.
방법
- GitHub나 WebDAV가 충돌을 알리면 그 동기화에서는 어떤 파일도 바뀌지 않습니다.
- 충돌 검토를 열어 두 버전을 비교하고, 어느 쪽을 남길지(제시되면 양쪽 모두) 골라 모든 결정을 제출하세요. JointTex는 쓰기 전에 양쪽을 다시 확인합니다.
- ‘호환되는 모든 파일에 적용’을 쓰면 여러 파일에 한 번에 같은 선택을 할 수 있습니다. 텍스트 차이로 보여 줄 수 없는 파일은 결정하기 전에 두 버전을 모두 내려받을 수 있습니다.
- GitHub와 WebDAV의 설정·해제는 소유자가 하고, 동기화와 충돌 해결은 소유자와 편집자가, 상태 확인은 뷰어도 할 수 있습니다.
- 해결되지 않은 충돌이 있는 채로 연결을 끊으면 두 버전은 ‘최근 충돌 보관함’에서 30일 동안 내려받을 수 있지만, 더 이상 자동으로 적용할 수는 없습니다.
- GitHub 계정이나 WebDAV 프로필을 지우기 전에, 쓰지 않는 프로젝트의 연결을 먼저 끊으세요.