빠른 시작 — 기획자

엑셀만 쓰시면 됩니다. 알아야 하는 특수문자는 두 개입니다.

문서 목록으로 · 개발자용 빠른 시작

---

규칙은 하나입니다

: 가 붙은 셀은 데이터가 아니라 표의 뼈대이고, # 가 붙은 것은 변환에서 빠집니다.

• :table 을 적은 셀이 표의 시작입니다. 시트 어디에 놓아도 됩니다.
• 그 셀이 있는 세로줄이 마커 열입니다. 거기에 :field · :type 을 적습니다.
• 마커 열이 빈 행이 데이터입니다.
• 첫 필드 컬럼이 그 표의 번호(인덱스) 입니다.

이게 전부입니다. 나머지는 필요할 때 하나씩 보면 됩니다.

표 하나 만들어 보기

	A	B	C	D
1	:table Item	아이템
2	:field	Id	Name	Price
3	:type	int	string	int
4		1	나무 검	100
5		2	철 검	350

:desc 행을 더하면 컬럼마다 설명을 적을 수 있고, 그 설명은 개발자가 보는 코드와 문서에 그대로 실립니다.

자주 쓰는 것

하고 싶은 것	이렇게 적습니다
값을 비워도 되게	타입 끝에 ? — int?
없음을 뜻하게	칸에 -
값을 여러 개	Tag[0] · Tag[1] 처럼 칸을 나누거나, 한 칸에 ; 로 이어서
범위를 정해두기	int (min=1, max=99)
다른 표의 행을 가리키기	foreign Item
번역할 문자열	text
아이콘 같은 파일 경로	asset(icon)
이 행은 잠깐 빼기	마커 열에 #
메모 컬럼	마커 열의 :field 자리에 #

세 가지만 조심하면 됩니다

앞뒤 공백은 지워집니다. 공백으로 줄을 맞춘 텍스트는 그대로 나오지 않습니다. 필요하면 다른 글자를 적고 개발자에게 바꿔 달라고 하십시오.

셀 병합은 읽히지 않습니다. 병합하면 왼쪽 위 칸만 값을 갖고 나머지는 빈 칸이 됩니다. 헤더를 병합하면 그 컬럼이 이름 없는 컬럼이 됩니다.

표 아래에 메모를 적으려면 한 줄 띄우십시오. 완전히 빈 행이 표의 끝이기 때문입니다. 데이터 중간에 여백이 필요하면 그 행의 마커 열에 # 를 적으면 됩니다.

뭔가 잘못됐을 때

변환이 실패하면 어느 파일 어느 시트 어느 칸인지 나옵니다.

아이템.xlsx : Item : AF12

그 칸을 열어 보면 대개 바로 보입니다. 메시지가 무슨 뜻인지 모르겠으면 트러블슈팅에서 그 문장을 찾으십시오.

변환 결과를 브라우저로 확인할 수 있습니다. 개발자가 html 타깃을 켜 두었다면 표와 값이 그대로 페이지로 나오고, 깨진 참조도 거기 표시됩니다.

더 알고 싶으면

무엇	어디
시트 작성 전체	시트 작성
적을 수 있는 타입 전부	적을 수 있는 타입
칸을 비워도 되는 자리	빈 칸의 뜻
헷갈리는 자리 모음	헷갈리는 자리