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

GitHub로 협업하기

프로젝트 소유자: 만들기와 초대

  1. 자신의 GitHub 계정으로 로그인하고 브라우저에서 VNLE를 승인하세요. 모든 팀원이 한 번씩 해야 합니다.
  2. GitHub에서 README, 라이선스, .gitignore 없이 빈 저장소를 만드세요. 돌아와 VNLE 접근을 허용한 뒤 목록을 새로 고치세요. 공유 저장소는 프로젝트 소유자만 만들면 됩니다.
  3. 로컬 이야기를 열고 팀 창을 여세요. 자신의 GitHub 계정으로 로그인합니다. 새 팀 프로젝트 만들기를 선택하고 브라우저에서 빈 저장소를 만드세요. VNLE 앱의 접근을 허용한 뒤 VNLE로 돌아와 목록을 새로 고치고 저장소를 선택합니다. 3단계에서 이름과 이메일을 입력해 이야기를 연결하세요. 팀과 비교한 뒤 GitHub로 보내면 다른 팀원이 다운로드할 수 있습니다.
  4. 팀원 초대는 GitHub에서 별도로 진행합니다. 저장소 → Settings → Collaborators → Add people을 여세요. 상대의 GitHub 사용자 이름이나 이메일을 검색해 초대합니다. 상대는 자신의 계정으로 초대를 수락해야 합니다. 조직 저장소는 관리자가 Collaborators and teams에서 접근 권한을 관리하며, 변경 사항을 보내려면 쓰기 권한이 필요합니다.

팀원: 초대 수락과 다운로드

먼저 GitHub 초대를 수락하세요. VNLE 시작 화면이나 프로젝트 메뉴에서 팀 프로젝트 다운로드를 엽니다. 자신의 GitHub 계정으로 로그인하고 VNLE를 승인하세요. 2단계에서 공유 저장소를 선택하고, 3단계에서 로컬 폴더 이름을 정해 이야기를 다운로드합니다. 다른 저장소를 만들 필요는 없습니다. 목록에 없다면 새로 고침하고 소유자에게 해당 저장소에 대한 VNLE 앱 접근 권한을 확인해 달라고 요청하세요.

소유자가 VNLE 앱의 저장소 접근을 허용해야 합니다. 초대받은 팀원은 GitHub 초대도 수락해야 합니다. 앱 접근 허용은 팀원 초대나 저장소 공개가 아닙니다. 이후 목록을 새로 고치세요.

GitHub: 프로젝트 소유자: 만들기와 초대 · GitHub: 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. 소유자가 VNLE 앱의 저장소 접근을 허용해야 합니다. 초대받은 팀원은 GitHub 초대도 수락해야 합니다. 앱 접근 허용은 팀원 초대나 저장소 공개가 아닙니다. 이후 목록을 새로 고치세요.

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 앱이 해당 저장소에 접근할 수 있는지, 계정에 쓰기 권한이 있는지 확인하세요. 검토하는 동안 팀 버전이 바뀌었다면 다시 받아 동기화하세요. 문제를 해결하는 동안 프로젝트 폴더는 보존하세요.