시맨틱 데이터 편찬 가이드라인
HeritageWiki
일반
- 띄어쓰기, 맨 끝 공백 등 주의.
- 링크 리스트의 source와 target에는 노드 리스트에서 정의한 id만을 사용할 수 있다. (공백, 띄어쓰기, 오타 등 주의)
클래스
class | 클래스 | Notes | GroupName |
---|---|---|---|
Actor | 인물 | 역사 인물. 집단적 행위 주체로서의 단체, 운영주체로서의 기관(관부) | 인물, 단체 |
Event | 사건 | 역사적 사건 또는 재현행사 | 사건, 행사 |
Place | 장소 | 역사적 사건 또는 인물과 관련이 있는 장소. 관련 유물의 소장처 등 | 장소, 소장처 |
Record | 문헌 | 역사적 사건 또는 인물과 관련이 있는 문헌자료. 역사적 조사/연구에 참조되는 기록물. | 문헌, 의궤, 보고서, 영상, 텍스트, 사진, 도면, 반차도 |
Concept | 개념 | 역사적 사건, 제도, 문화적, 종교적 배경을 설명하는 데 필요한 개념어 | 개념용어 |
Object | 물품 | 역사적 사건 또는 인물과 관련이 있는 물품, 인물의 유물과 작품 | 물품, 유물 |
WebResource | 웹자원 | 월드와이드웹상의 연계 자원 | 해설, 참고, 시각자료 |
Heritage | 문화유산 |
- 위의 표에 정의한 클래스 외에 다른 클래스가 필요한 경우 제안, 검토를 통해 추가할 수 있다.
- 반드시 첫 글자는 대문자로 쓴다.
노드
- id는 띄어쓰기가 없이 쓴다. 필요한 경우 언더바(_)로 구분한다.
- id 자체로 대상이 식별될 수 있도록 쓴다. (개념어 등 특별한 경우가 아니라면 일반명사는 가급적 id로 사용하지 않는다.)
- 예: 현판 → 임청각_현판
- 한자, ⦁(특수문자) 넣지 말 것.
- 특수문자는 _ / () 만 사용.
- 가문 띄어쓰기 없음. (예) 안동권씨
- 가문이 아닌 특정 누군가의 부인이나 딸인 여성은 () 안에 상세정보를 기입할 것. 해당 여성의 누군가의 처이며 딸인 경우는 “누군가의 처”를 우선으로 한다. (예) 경주이씨_(이증의_부인)
- 왕의 경우는 해당 왕조도 넣을 것. (예) 고려_태조왕건
- infoUrl
- 주소바에 있는 것을 복사하면 안되는 경우가 있음. → 해당 웹사이트에서 제공하는 URL 사용.
- iconUrl
- 기존 아이콘을 사용하는 경우, 그래프용 아이콘 페이지의 URL을 사용함.
- 새로운 이미지를 사용하는 경우,
인물
- id는 이름으로, label은 “이름(한자, 생년~몰년)”의 형태로 쓴다.
- 예: 이원, 이원(李原, 1368~1429)
- 생년과 몰년 모두 미상인 경우는 “이름(한자)”의 형태로 쓴다.
사건
- label은 “사건(발생연도)”의 형태로 쓴다.
- 예: 병자호란(1637)
문헌
- label은 “국문 명칭(한자 표기)”의 형태로 쓴다.
- 예: 역동문집(易東文集)
관계어
- 진주강씨(新) 진양강씨(舊)와 같이 신⦁구 성씨가 나올 경우의 relation 관계어를 다음과 같이 설정하며, 집안 인물들은 해설문에 기록된 해당 성씨의 member로 연결한다. 해설문의 기준도 현재 대표적으로 사용되는 해당 성씨의 인물로 기록하기 때문이다. (예) 진주강씨 진양강씨 sameAs/ 진주강씨 강희경 member
- ‘통일신라 9세기에 조성된 전형적인 조형의 석조비로자나불좌상’과 같은 불보살상이나 ‘통일신라 시대의 조성된 전형적인 삼층석탑’인 경우의 문화재에만 해당시대를 언급한다. 해당 문화재와 제작시대를 연결하는 연결어는 모든 데이터를 작성 한 후의 고민한다.
- 특정 신도비의 글씨체를 언급해야 하는 경우는 다음과 같이 한다.
화산_신도비(object) 화산_신도비_비문(record) 화산_신도비_비문 해서체 type 화산_신도비_비문 이현일 writer 화산_신도비_비문 이유 calligrapher
- 서적을 편찬하게 한 왕과 실제 참여한 신하들/ 특정 불상을 조성한 인물(조각가 아닌 시주자)간의 관계어 설정
동국여지승람 조선_선조 contributor 동국여지승람 노사신 writer 동국여지승람 강희맹 writer 감산사_석조미륵보살입상 김지성 contributor
링크
- 현재 Ontology:Relation 페이지에 정의된 관계어는 반드시 Relation 셀의 것을 사용한다. (특별한 경우가 아니라면 inverse relation 사용하지 않음.)
- 주어(source)와 목적어(target) 방향이 맞는지 반드시 확인한다.
- 관계어의 첫 글자는 반드시 소문자로 쓰고, 두번째 단어부터는 첫글자를 대문자로 쓴다.
- 현재 Ontology:Relation 페이지에 정의되지 않은 관계어는 Ontology:Relation 제안 페이지에 메모하고, 논의를 거쳐 확정한다.