0021 이름표 v2: 장부 칸을 공개 주소에, 칸과 값의 정의 파일, GEDCOM 프로필
08-이름표 v2의 결정 장이다. 03-manifest가 승인되어(2026-10-20) 「03 승인 뒤 v2」 약속을 지킨다. 결정 0020(온톨로지) 2·3번의 「정의 쪽과 남의 표준 대응」도 여기서 낸다.
무엇을
섹션 제목: “무엇을”https://hgp.hahoe.io/ns/v2.jsonld(JSON-LD 1.1 context). v1의 칸을 모두 같은 이름표로 담고, 장부(03), 기탁 약정 줄(07), 제품 이력(0016, 0017), 관계망 새 낱말(06 v0.7)의 칸을 담아 모두 77개다.https://hgp.hahoe.io/ns/terms-v2.jsonld. 칸과 값 153개의 정의(칸은 한국어와 영어 이름, 값 가운데 일부는 한국어 이름만)와 남의 표준 대응(Wikidata, CIDOC-CRM, PROV-O, FOAF, schema.org, Dublin Core, ODRL, IPTC). 대응은 SKOS로 적는다:exactMatch는 같음,closeMatch는 비슷함.- 바뀌는 것:
prop과scope값이 이름표로 풀린다. 같은 낱말이 칸마다 뜻이 다르면 칸별 context로 따로 푼다 (level의confirmed와 주장의confirmed).source_type은 IPTC 공식 주소로.profile은dct:conformsTo로. - 넣지 않는 칸:
title,people,voices,place,sent_to, 앱 처리 상태. 밖으로 내지 않는 칸이라 이름표에 없다. 처리기가 버리므로 실수로 섞여도 나가지 않는다. - v1은 그대로 남는다. 한 번 낸 판은 고치지 않는다.
- 족보 낱말 넷 (jokbo의 족보 샘플 변환에서 나옴, 06-관계망 v0.7):
buried_at묘소,age_at_death향년과reckoning(세는나이, 만 나이), 값의 문자를 가르는lang(한자 원문, 한글 독음, 로마자), 원본 위의 후대 표시mark. - HGP GEDCOM 프로필 gedcom-v1 (08-이름표 7절): 확장 칸
_KLUNAR(한국 음력 달력),_KAGE(세는나이),_HGPSRC(읽기를 누가 냈나),_HGPSTAT(확인 상태),_SHA256(원본 지문),_HGPKEY(근거 자리)의 공개 주소. jokbo가 쓰던 임시 이름과 비공개 저장소 주소를 대신한다.
반영한 문서: 08-이름표 v2 (1·2·4·6·7절), 06-관계망 v0.7, 05-용어. 생성기는 사이트 도구 폴더(공개 방에 보내지 않음).
- 다른 기관의 프로그램이 우리 장부를 읽으려면 칸 이름의 공개 뜻이 있어야 한다. v1에는 지문과 관계망만 있었다.
- 국내 기관은 우리 모양을 그대로 받지 못한다(온톨로지 조사). 그래서 칸마다 그들이 아는 표준과 무엇이 같은지를 정의 파일에 적어, 바꿔 내는 일을 기계가 할 수 있게 한다.
- 이름표에서 빼는 것도 지키는 일이다. 사람 이름이 든 칸은 이름표에 없으면 JSON-LD로 나가지 않는다.
시험 (2026-10-20, jsonld.js 8.3.3, 안전 모드)
섹션 제목: “시험 (2026-10-20, jsonld.js 8.3.3, 안전 모드)”주장 줄, 점 줄, 바깥 이름표 주장, 장부 줄, 약정 줄, 제품 이력 줄, 공개 줄, 지문 묶음을 펼치고 RDF로 바꿈. 모두 통과. v1과 v2가 같은 칸에 같은 이름표를 줌. IIIF context와 함께 쓸 때 캔버스의 hgp:sha256이 살고, 매니페스트 seeAlso의 profile은 IIIF 뜻을 유지함. terms-v2.jsonld도 안전 모드 통과 (RDF 701줄). lang이 든 주장도 통과. IIIF 공식 검사기 시험은 arkive가 v2로 바꿀 때 다시 한다.
다른 선택지
섹션 제목: “다른 선택지”| 선택지 | 안 고른 이유 |
|---|---|
| OWL 온톨로지로 정의 | 자동 추론은 사람 확인 원칙과 맞지 않고, 읽어 줄 국내 기관이 없다 (결정 0020). SKOS 대응이면 충분하다 |
prop 값을 글자로 둠 (v1처럼) |
「자」가 Wikidata P1782라는 것을 기계가 알 수 없다 |
| 모든 칸을 넣음 | 사람 이름 칸이 JSON-LD로 나갈 길이 열린다 |
전역 @vocab |
모르는 칸이 모두 hgp 이름표가 되어 IIIF와 섞일 때 어지럽다. 칸별 context로 필요한 곳만 |
어디에 영향이 가나
섹션 제목: “어디에 영향이 가나”- arkive:
hgp_context를 v2로 바꿀 수 있다 (지금 v1). IIIF 검사기를 다시 돌린다. 관계망 내보내기에terms-v2대응을 써서 국내 기관용 평평한 판을 만든다. - secretary, provenance: 장부를 JSON-LD로 낼 때 v2. 값이 객체인 칸은
@json으로 싼다. - jokbo: GEDCOM 머리의
SCHMA주소를 7절 주소로 바꾼다. 음력은_KLUNAR달력 +PHRASE+SDATE. - 규칙표:
relations-v1.json은 그대로. 새 낱말을 검사하는 규칙표 v2는 따로 낸다.
0원.