번역본 파일 포맷 도움말

직접 만든 성경 파일을 준비하는 방법입니다. 전체 도움말이나 JSON 예제를 복사하고, 마크다운 문서로 저장할 수 있어요.

1. 파일 가져오기

새 파일은 UTF-8로 저장한 .json을 권장합니다. 아래 예제의 본문을 원하는 내용으로 바꾸세요. 번역본 관리에서 파일을 고르고 설치 전 이름과 언어를 확인합니다. 마크다운 도움말 자체는 번역본 파일이 아닙니다.

2. 최소 JSON

Bible은 대문자로 적는 필수 키입니다. 각 행은 [책 번호, 장, 절, 본문 문자열]입니다. 장과 절은 양의 정수이며, 본문은 따옴표로 감싼 문자열입니다. 책 번호 대신 영어 책 이름(예: Genesis)도 가능합니다. 일부 책·장만 있어도 가져올 수 있습니다.

{
  "Bible": [
    [
      1,
      1,
      1,
      "Verse text 1"
    ],
    [
      1,
      1,
      2,
      "Verse text 2"
    ]
  ]
}

3. 선택 메타데이터

meta는 선택 사항이며 metadata도 같은 뜻으로 읽습니다. formatVersion은 현재 1입니다. id는 고유 식별자이며 이미 설치된 같은 ID는 교체됩니다. name은 표시 이름, lang은 언어 코드, direction은 ltr 또는 rtl입니다. 설치 전 확인 화면에서 정보를 수정할 수 있습니다. 설명은 description, 긴 소개는 intro, 역자·연도는 author·year, 출처·권리는 source·copyright에 적습니다. nameScheme은 protestant, catholic, kjv를 사용하며 정경·절 체계는 별도 canon으로 선언합니다. 판 정보는 version, 본문 기호의 의미는 markupPolicy, 책 이름은 bookNames로 지정할 수 있습니다.

{
  "meta": {
    "formatVersion": 1,
    "id": "MY-BIBLE",
    "name": "My Bible",
    "lang": "en",
    "direction": "ltr",
    "nameScheme": "protestant",
    "canon": {
      "canon": "protestant66",
      "versification": "kjv"
    }
  },
  "Bible": [
    [
      1,
      1,
      1,
      "Verse text 1"
    ]
  ]
}

4. 여러 절이 한 본문인 경우

본문은 첫 절에 한 번만 적고, sourceVerseGroups를 Bible과 같은 루트에 둡니다. 아래 예제에서 14절 본문을 다시 넣으면 안 됩니다. 범위는 같은 장의 연속된 절이어야 하며 겹칠 수 없습니다.

{
  "Bible": [
    [
      2,
      25,
      13,
      "Combined text of verses 13 and 14"
    ]
  ],
  "sourceVerseGroups": {
    "2:25:13": [
      13,
      14
    ]
  }
}

5. 책 번호

아래 번호는 파일의 고정 ID입니다. 가톨릭 책 순서에 맞춰 기존 번호를 다시 매기지 마세요. 추가 본문은 에스테르(17)와 다니엘(27)에 넣고, 추가 책은 67–73을 사용합니다. 이름 체계와 정경은 서로 별개입니다.

번호	책
1	창세기
2	출애굽기
3	레위기
4	민수기
5	신명기
6	여호수아
7	사사기
8	룻기
9	사무엘상
10	사무엘하
11	열왕기상
12	열왕기하
13	역대상
14	역대하
15	에스라
16	느헤미야
17	에스더
18	욥기
19	시편
20	잠언
21	전도서
22	아가
23	이사야
24	예레미야
25	예레미야 애가
26	에스겔
27	다니엘
28	호세아
29	요엘
30	아모스
31	오바댜
32	요나
33	미가
34	나훔
35	하박국
36	스바냐
37	학개
38	스가랴
39	말라기
40	마태복음
41	마가복음
42	누가복음
43	요한복음
44	사도행전
45	로마서
46	고린도전서
47	고린도후서
48	갈라디아서
49	에베소서
50	빌립보서
51	골로새서
52	데살로니가전서
53	데살로니가후서
54	디모데전서
55	디모데후서
56	디도서
57	빌레몬서
58	히브리서
59	야고보서
60	베드로전서
61	베드로후서
62	요한일서
63	요한이서
64	요한삼서
65	유다서
66	요한계시록
67	토빗기
68	유딧기
69	지혜서
70	집회서
71	바룩서
72	마카베오기 상권
73	마카베오기 하권

6. SDB 및 자주 생기는 오류

.sdb는 SQLite 파일이며 Bible 테이블의 book, chapter, verse(정수)와 btext(문자열) 열을 사용합니다. 임의의 SQLite·PDF·Word 파일은 이 형식과 다릅니다. JSON에는 주석과 마지막 쉼표를 넣지 마세요. Bible 키 누락, 본문이 배열이 아닌 경우, 장·절이 문자열인 경우, 잘못된 meta 또는 겹치는 묶음 절은 가져오기 오류의 원인이 됩니다. 저장한 예제를 .md가 아닌 .json 파일로 가져오세요.

예시 파일 보기