VNLEWIKI이야기를 만들고, 세계를 연결하세요.
한국어
VNLE 사용 설명서

GitHub로 협업하기

변경 설명은 선택 사항입니다. 비워 두면 VNLE가 변경을 보낼 때 Update를 사용합니다.

작업은 자신의 컴퓨터에서 하고 공유 버전은 GitHub에 저장합니다. Save는 로컬 저장입니다. Compare with team은 팀 변경을 확인하고 반영합니다. Send to GitHub는 준비한 버전을 공유합니다. 오프라인으로 작성하고 나중에 공유해도 됩니다.

시작하기 전에

  1. github.com에서 무료 계정을 만드세요. 팀원은 각자의 계정을 사용합니다.
  2. Windows 버전에는 Git가 포함되어 있습니다. Git 또는 GitHub Desktop을 별도로 설치하지 않아도 됩니다.
  3. 비공개 이야기는 비공개 저장소에 넣으세요. 이 저장소에는 이야기를 보관하고, 공개 Wiki는 별도 저장소에 두세요.

1 · VNLE에서 GitHub에 로그인

  1. 왼쪽 위 프로젝트 이름을 누르고 Set up team 또는 현재 팀 상태를 선택하세요. Sign in with GitHub를 누르세요.
  2. VNLE가 짧은 코드를 표시하고 브라우저에서 GitHub를 엽니다. 로그인하고 코드를 입력한 뒤 연결을 승인하세요.
  3. VNLE로 돌아오세요. 확인이 끝나면 계정 이름이 표시됩니다. VNLE에 비밀번호를 입력하지 않습니다.
  4. 저장소 접근 링크를 여세요. Only select repositories를 선택하고 자신의 이야기 저장소를 고르세요. Install 또는 Save로 확인한 뒤 VNLE에서 저장소 목록을 새로 고치세요.

2 · 새 팀 프로젝트를 게시

  1. GitHub 오른쪽 위에서 + → New repository를 선택하세요. harbour-story 같은 이름을 쓰고 Private를 고르세요. 새 저장소의 README, .gitignore, License는 비워 두고 Create repository를 누르세요.
  2. VNLE 목록에서 저장소를 고르거나 GitHub Repository에 주소를 붙여 넣으세요.
  3. 버전에 기록할 이름과 이메일을 입력하세요. GitHub → Settings → Emails의 noreply 주소를 사용해도 됩니다. Connect locally를 누르세요.
  4. 변경 내용을 간단히 적고 Compare with team을 선택하세요. VNLE가 저장하고 로컬 버전을 만든 뒤 팀 버전을 확인합니다. 이후 Send to GitHub로 작업을 공유하세요.
  5. 브라우저에서 저장소를 열고 project.vnle.json과 프로젝트 폴더가 있는지 확인하세요. Settings → Collaborators에서 팀원을 초대하세요.

3 · 기존 프로젝트에 참여

  1. GitHub 초대를 수락하세요. VNLE 시작 화면에서 Download team project를 선택하고 GitHub에 로그인하세요.
  2. 팀 저장소와 로컬 작업 복사본을 둘 위치를 선택하세요. 프로젝트를 다운로드하고 VNLE에서 여세요.
  3. Open project로 해당 폴더를 여세요. 프로젝트 메뉴의 팀 항목에서 GitHub에 로그인하고 저장소 접근 권한을 확인하세요.
  4. 편집 전에 동기화하세요. 장면 작업을 마친 뒤 다시 비교하고 Send to GitHub를 선택하세요.

상태 표시 이해하기

Set up team은 설정이 미완료라는 뜻입니다. Not sent yet은 보낼 로컬 작업이 있다는 뜻입니다. Team updates available은 팀원이 변경을 올렸다는 뜻입니다. Up to date는 마지막 확인 때 모두 일치했다는 뜻입니다. Status not checked는 오프라인 등의 이유로 GitHub를 확인하지 못했다는 뜻입니다. VNLE는 설정된 프로젝트를 약 2분마다 확인합니다.

둘 다 동일한 내용을 변경할 때

  1. Compare with team을 선택하세요. 서로 독립적인 변경은 합쳐집니다. 같은 내용을 다르게 수정했다면 VNLE가 검토 화면을 표시합니다.
  2. Your version과 Team version을 비교하고 영향을 받는 항목마다 유지할 버전을 고르세요.
  3. Validate choices and sync를 누르세요. VNLE가 합쳐진 프로젝트를 검사한 뒤 작업 버전을 교체합니다. 이후 Compare with team을 다시 선택하고 Send to GitHub로 보내세요.
  4. 확실하지 않다면 Decide later를 선택하고 팀원과 내용을 상의하세요. 저장한 작업은 유지됩니다.

가능하면 각 장면을 누가 편집할지 정하세요. 공유 캐릭터, 변수, 번역의 변경도 조율하세요. 새 팀 버전을 적용하면 프로젝트를 다시 불러오며 현재 미리보기와 실행 취소 세션이 끝납니다.

동기화가 실패한 경우

먼저 인터넷 연결을 확인하세요. 인증이 만료됐다면 다시 로그인하세요. VNLE 앱이 해당 저장소에 접근할 수 있는지, 계정에 쓰기 권한이 있는지 확인하세요. 검토하는 동안 팀 버전이 바뀌었다면 다시 받아 동기화하세요. 문제를 해결하는 동안 프로젝트 폴더는 보존하세요.