콘텐츠로 이동

0021 이름표 v2: 장부 칸을 공개 주소에, 칸과 값의 정의 파일, GEDCOM 프로필

결정
0021
상태
결정 (노드원 대표 승인, 한 번 낸 판은 고치지 않는다)
날짜
2026-10-20

08-이름표 v2의 결정 장이다. 03-manifest가 승인되어(2026-10-20) 「03 승인 뒤 v2」 약속을 지킨다. 결정 0020(온톨로지) 2·3번의 「정의 쪽과 남의 표준 대응」도 여기서 낸다.

  1. https://hgp.hahoe.io/ns/v2.jsonld (JSON-LD 1.1 context). v1의 칸을 모두 같은 이름표로 담고, 장부(03), 기탁 약정 줄(07), 제품 이력(0016, 0017), 관계망 새 낱말(06 v0.7)의 칸을 담아 모두 77개다.
  2. https://hgp.hahoe.io/ns/terms-v2.jsonld. 칸과 값 153개의 정의(칸은 한국어와 영어 이름, 값 가운데 일부는 한국어 이름만)와 남의 표준 대응(Wikidata, CIDOC-CRM, PROV-O, FOAF, schema.org, Dublin Core, ODRL, IPTC). 대응은 SKOS로 적는다: exactMatch는 같음, closeMatch는 비슷함.
  3. 바뀌는 것: prop과 scope 값이 이름표로 풀린다. 같은 낱말이 칸마다 뜻이 다르면 칸별 context로 따로 푼다 (level의 confirmed와 주장의 confirmed). source_type은 IPTC 공식 주소로. profile은 dct:conformsTo로.
  4. 넣지 않는 칸: title, people, voices, place, sent_to, 앱 처리 상태. 밖으로 내지 않는 칸이라 이름표에 없다. 처리기가 버리므로 실수로 섞여도 나가지 않는다.
  5. v1은 그대로 남는다. 한 번 낸 판은 고치지 않는다.
  6. 족보 낱말 넷 (jokbo의 족보 샘플 변환에서 나옴, 06-관계망 v0.7): buried_at 묘소, age_at_death 향년과 reckoning(세는나이, 만 나이), 값의 문자를 가르는 lang(한자 원문, 한글 독음, 로마자), 원본 위의 후대 표시 mark.
  7. 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원.