콘텐츠로 이동

0014 공개 이름표와 관계망 규칙표

결정
0014
상태
결정 (노드원 대표 결정, hgp 이슈 #1)
날짜
2026-10-12

노드원 대표 결정: 「hgp 칸의 뜻을 적은 공개 주소를 내자」, 「06 규칙표도 같은 주소에」.

0009의 임시 이름 urn:x-hgp:fixity를 대신한다. 0009의 나머지(권 지문은 metadata와 seeAlso로)는 그대로다.

  1. 주소: 설명 https://hgp.hahoe.io/ns/, 이름표 https://hgp.hahoe.io/ns/v1.jsonld(JSON-LD 1.1), 칸 바탕 https://hgp.hahoe.io/ns#, 규칙표 https://hgp.hahoe.io/ns/relations-v1.json, 지문 묶음 프로필 https://hgp.hahoe.io/ns/#fixity-v1. 새 문서 08-이름표.
  2. 판: 판 번호가 주소에 든다. 한 번 낸 판은 고치지 않는다. v1에는 지문 칸과 관계망 장부 칸만. 03-manifest 칸은 03 승인 뒤 v2.
  3. IIIF: 캔버스에 hgp:sha256을 붙여도 된다(@context에 hgp 주소를 IIIF 앞에). 매니페스트에 hgp:root는 붙이지 않는다.
  4. 규칙표: arkive 요청안을 바탕으로 정본을 낸다. 어김은 error(장부에 들어가면 안 됨)와 review(사람이 볼 것) 둘. 기계가 낸 주장은 처음부터 confirmed일 수 없다(error).
  5. 사건 속 자리는 정해 둔 영어 값: visitor, host, sender, recipient, companion. 한국어 옛 값은 옮길 때까지 읽는다(review). 「준 이」는 sender, 「받은 이(물건)」는 recipient로 합친다(사건 갈래가 이미 가른다).
  6. 친척 관계는 원문 호칭 그대로(족질, 족숙, 외숙). 목록으로 닫지 않는다.
  7. 모양은 JSON. SHACL로는 지금 내지 않는다.

반영한 문서: 08-이름표(새로), 02-지문 9절 (v0.3), 06-관계망 4.1·5절·14절 (v0.3), 03-manifest 12절, 05-용어.

  • arkive가 IIIF 공식 검사기로 시험해 보니 context 주소가 있으면 캔버스의 hgp:sha256은 통과하고 매니페스트의 hgp:root는 막혔다 (이슈 #1). 그 결과에 맞춘다.
  • 다른 기관의 프로그램이 칸의 뜻을 찾아갈 주소가 있어야 「밖은 표준」(결정 0002)이 된다. hgp.hahoe.io는 로그인 없이 열려 있다.
  • 칸 이름은 짧은 영어, 값은 표준 어휘라는 hgp 규칙. 영어판 사이트와 바깥 기관도 같은 값을 읽는다.
  • 한국 친족 호칭은 수십 가지이고 뜻이 섬세하다. 목록으로 닫으면 원문을 잃는다.
선택지 안 고른 이유
판 번호 없는 주소 하나를 계속 고침 이미 이 주소를 읽는 프로그램의 뜻이 몰래 바뀐다
03 칸까지 v1에 03은 아직 초안이다. 한 번 낸 판은 못 고친다
자리 이름을 한국어 그대로 값은 표준 어휘라는 규칙과 어긋나고, 영어판·바깥 기관이 읽기 어렵다
SHACL로 바로 arkive 검사기가 JSON으로 돌고 있다. 옮길 수는 있게 짰다
이름표에 @base: urn:uuid: 처리기로 시험하니 urn: 주소에는 상대 주소 풀기가 맞지 않았다. 내보낼 때 urn:uuid:를 붙이게 했다
  • arkive: 설정 hgp_context에 주소를 넣고 검사기를 다시 돌린다. 지문 묶음 profile을 새 이름으로. 규칙표 요청안을 정본 사본으로. 고문서 장부의 자리 이름 29줄을 영어 값으로 옮긴다 (arkive 할 일).
  • secretary: 지금 할 일 없다. 녹음을 IIIF로 낼 때 같은 주소를 쓴다.
  • server: 할 일 없다. hgp.hahoe.io는 로그인 없이 열려 있고, 머리말(application/ld+json, Access-Control-Allow-Origin: *)은 hgp 사이트 안 설정으로 낸다.

0원.