GitHub에서 컬렉션 가져오기

공개 GitHub 저장소에 컬렉션 파일을 두면 주소로 가져올 수 있습니다. Git 저장소 전체를 복제하는 방식은 아닙니다.

가장 간단한 저장소 구성

기본 브랜치의 루트에 collection.json을 둡니다.

my-collection/
  collection.json
  assets/
    <이미지 SHA-256>/
      diagram.png

이미지가 없다면 collection.json 하나면 됩니다. 예제 파일을 내려받아 저장소 루트에 올린 뒤 시작할 수 있습니다.

앱에서 추가하기

공개 저장소 주소를 복사합니다.
내 컬렉션 → 가져오기 → 링크를 엽니다.
주소를 붙여 넣고 가져오기를 누릅니다.

다음 세 형식을 지원합니다. 아래 OWNER와 REPOSITORY 등은 본인의 값으로 바꿔 주세요.

https://github.com/OWNER/REPOSITORY
https://github.com/OWNER/REPOSITORY/blob/main/collection.json
https://raw.githubusercontent.com/OWNER/REPOSITORY/main/collection.json

저장소 주소만 넣으면 기본 브랜치의 /collection.json을 읽습니다. 다른 이름이나 폴더의 JSON은 해당 파일의 blob 주소나 raw 주소를 사용하세요. HTTPS 공개 주소를 사용하고 query·fragment가 붙은 링크는 피하세요. 비공개 저장소 인증과 GitLab 등의 다른 Git 서비스는 현재 이 가져오기 경로에서 지원하지 않습니다.

이미지 경로

JSON의 assets에 선언한 상대 경로를 JSON 파일 위치를 기준으로 찾습니다. 파일은 JSON과 같은 디렉터리 또는 그 아래에 있어야 합니다. 이미지의 실제 SHA-256, 경로, 참조가 일치해야 합니다.

이미지 자산 규칙

저장소를 바꾸면 앱도 바뀌나요?

GitHub에 변경을 올린 뒤 같은 파일 주소로 다시 가져오면 앱이 원본을 확인합니다. 원본의 카드 추가·수정·삭제를 반영하며, 공통 기준을 확인할 수 있으면 서로 겹치지 않는 기기 편집도 함께 유지합니다.

원본과 기기에서 같은 내용을 다르게 수정했거나 기존 사본의 기준을 확인할 수 없으면 내 컬렉션 → … → 원본 변경 검토에서 차이를 확인하세요. 적용 전까지 현재 컬렉션은 그대로 유지됩니다. 편집 중인 초안이 있다면 먼저 마무리한 뒤 원본을 적용할 수 있습니다.