수정할 값 지정하기

대상: 사이트 운영자 · 소요 시간: 약 5분

이 가이드를 마치면 사이트에서 "수정해도 되는 것"만 골라 편집 화면에 올릴 수 있습니다. 고르지 않은 것은 누구도 건드릴 수 없습니다 — 이것이 깃지기의 디자인 보호 방식입니다.

💡 사전 조건: 사이트 연결하기를 마친 상태여야 합니다.

필드 매핑이란

사이트의 콘텐츠 파일에는 제목, 소개글, 버튼 문구, 이미지 주소 같은 값이 들어 있습니다. 이 중에서 편집을 허용할 항목만 골라 이름표를 붙이는 작업이 필드 매핑입니다.

• 고른 항목 → 편집 화면에 입력칸으로 나타남

• 고르지 않은 항목 → 편집 화면에 아예 나타나지 않음 (수정 불가)

필드 고르기

1. 사이트 목록에서 해당 카드의 오른쪽 위 설정(⚙) 버튼을 누릅니다. (카드 자체를 누르면 편집 화면으로 바로 이동합니다.)

2. 수정 가능한 필드 관리에서 파일 탭을 선택하면 그 안의 값들이 표로 나타납니다. 탭을 오가며 여러 파일에 걸쳐 골라도 선택이 유지됩니다.

3. 편집을 허용할 항목의 왼쪽 체크박스를 켭니다.

[스크린샷: 필드 매핑 표 — 체크·라벨·타입·잠금]

라벨과 타입 정하기

라벨은 편집 화면에서 그 입력칸의 이름이 됩니다. 고객이 보는 이름이니 코드식 이름 대신 알기 쉬운 한글로 바꿔 주세요.

타입은 값의 성격에 맞게 자동 추천됩니다 — 짧은 글은 텍스트, 긴 글은 긴 텍스트, 주소는 링크, 이미지는 이미지, 켜기/끄기는 토글. 대부분 그대로 두면 됩니다.

잠금을 켜면 목록에는 있지만 편집 화면에 노출되지 않습니다. "지금은 못 바꾸게 하고 싶은" 항목에 쓰세요.

저장하기

매핑 저장을 누르면 화면에서 고른 모든 파일의 선택이 한 번에 저장됩니다. 나중에 언제든 다시 들어와 항목을 추가·제외하거나 라벨을 바꿀 수 있습니다.

💡 사이트가 여러 페이지라면 파일 탭의 페이지 경로 칸을 확인해 주세요. 깃지기가 파일 이름으로 경로를 추측해 두는데(예: about.json → /about), 다르면 직접 적으면 됩니다. 편집 화면에서 페이지를 이동할 때 미리보기가 이 경로를 따라갑니다.

잘 안 될 때

• 파일 목록이 비어 있어요 — 콘텐츠가 아직 분리되지 않은 사이트입니다. 사이트 확인 화면이 자동으로 안내하는 변환 프롬프트를 실행하면 해결됩니다. (사이트 연결하기의 "사이트 확인" 참고)

• "JSON 형식이 올바르지 않습니다"가 떠요 — 해당 파일에 문법 오류(쉼표 누락 등)가 있습니다. 코드 편집기에서 파일을 열어 확인해 주세요.

• 숫자 값이 목록에 안 보여요 — 현재 버전은 텍스트·긴 텍스트·이미지·링크·토글만 지원합니다.

다음 단계

→ 고객 초대하기 — 고객에게 편집 화면을 열어 줍니다. 내 사이트를 직접 운영한다면 이 단계는 건너뛰고 바로 편집을 시작해도 됩니다.