简体 | 繁體 | 日本語 | 한국어

홈 › 기계 판독 › 네임스페이스

네임스페이스

네임스페이스는 두 가지를 정한다. 항목이 어디에 있는가(내용 식별자)와, 그것이 무엇인가(형과 필드)다. 이유는 간단하다. 기계가 항목을 인용하려면 바뀌지 않는 주소가 필요하고, 주소가 바뀌면 인용이 끊긴다.

차오저우 타이핑루의 기루 거리, 밤에 불이 켜져 있다
차오저우 타이핑루, 기루 아래 불빛이 거리 끝까지 이어진다.

1. 두 접두사

접두사 전개 용도
cz: https://chaoshanwiki.com/ 내용 항목 식별자
czns: https://chaoshanwiki.com/ns/# 이 사이트 자체의 형과 속성

두 개로 나누는 이유는 이 두 일이 본래 다르기 때문이다:cz:는 “이 물건이 어디에 있는가”에 답하고,czns:는 “이 부류의 물건은 무슨 뜻인가”에 답한다. 예전에는 둘을 한 접두사 아래 섞었는데,cz:IntangibleHeritage 그러면 규칙상 사이트 루트로 전개되어 페이지 앵커가 되지 않았다. 잘못이었고 고쳤다.

식별자에는 끝 슬래시가 붙는다.쓰는 방식은 cz:chaozhou-opera/이고, 끝 슬래시는 식별자의 일부이지 장식이 아니다. 이유는 JSON-LD 접두사 전개가 접두사와 접미사를 그저 이어 붙일 뿐 슬래시를 채워 넣지 않기 때문이다. 슬래시가 하나 빠지면 전개 결과는 https://chaoshanwiki.com/chaozhou-opera이 되어, 페이지의 표준 주소 https://chaoshanwiki.com/chaoju/ 와 한 글자 다르다. 엄밀히 말하면 같은 자원이 아니다. 규칙에서 전개 결과와 표준 주소가 글자 그대로 같아야 하므로 슬래시를 식별자에 쓴다.

홈이 유일한 예외로, cz:(접미사가 빈 상태)로 쓰고 전개하면 https://chaoshanwiki.com/가 바로 사이트 루트 주소다. 언어 분기가 붙은 항목은 경로를 그대로 써서, 이를테면 cz:en/travel-chaozhou/으로 쓰면 해당 영어 페이지로 전개된다.

식별자를 URL 경로에서 바로 가져오고 따로 번호를 만들지 않는 이유는 읽기 쉽고, 찾기 쉽고, 오류를 추적하기 쉽도록 하기 위해서다. 이를테면 cz:chaozhou-opera/ 을 보면 어느 페이지에서 확인해야 하는지 알 수 있다.

2. 두 겹의 형

여기서는 두 겹으로 나누고, 한 줄에 섞지 않는다:페이지 자체가 무엇인가와페이지가 기술하는 대상이 무엇인가. 한 페이지가 Article이면서 그 기술 대상은 어떤 무형문화유산 항목일 수 있다. 예전에는 Article과 Person, Place를 한 표에 실어 두 겹을 한 겹으로 눌렀는데, 분리했다.

첫째 겹, 페이지 형(pageType):

형 中文 적용 범위
Article 항목 페이지 독립된 주제를 가진 서술형 항목으로, 전체 사이트의 다수를 차지한다
CollectionPage 색인 페이지 한 주제로 여러 항목을 모은 페이지. 무형문화유산 목록, 지역 색인 등
WebPage 설명 페이지 이 사이트에 대하여, 참여, 라이선스 따위와 각 언어 분기 페이지
Dataset 데이터셋 /dataset/ 과 /fact-sheet/
FAQPage 질문 페이지 /faq/. 질문·답pair에는 별도로 FAQPage를 붙인다
DefinedTermSet 어휘표 페이지 /ns/ 과 /vocab/

둘째 겹, 대상 형(subjectType):

형 中文 어휘 적용 범위
Person 인물 schema.org 생애를 중심으로 한 역사 인물
Place 지리와 행정구역 schema.org 부(府) 지역, 현, 취락, 항구, 사묘가 있는 곳
TouristAttraction 명소 schema.org 문화재 보호 단위, 고건축, 유적, 산과 강
Event 절속과 의례 schema.org 때에 따라 일어나는 세시절속과 인생예속
czns:IntangibleHeritage 무형문화유산 항목 이 사이트 국가급 무형문화유산 목록의 항목에 대응하며, 페이지에 번호와 회차를 적는다
czns:Guide 일정 편성 이 사이트 도시와 날짜로 짠 코스 페이지
czns:FoodItem 음식 품류 이 사이트 채, 궈, 차 같은 문화 품류이며, 영업 장소가 아니다
czns:Fact 사실 항목 이 사이트 /fact-sheet/ 참조. 한 줄에 하나의 주장, 출처와 확인 날짜를 붙인다
DefinedTermSet 어휘표와 대조표 schema.org 용어표, czns 어휘표, 네임스페이스, 방언어 대조 같은 “정의된 낱말의 묶음”
Thing 미분류 schema.org 위 어느 것에도 맞지 않으면 있는 그대로 Thing이라 적고 억지로 끼워 넣지 않는다

맞지 않는 것은 Thing로 적는다. 형은 기계에 이 자원이 무엇인지 알려 주는 것이지, 항목을 전문적으로 보이게 하려는 것이 아니다. 맞지 않으면 붙이지 않는다.

3. 자체 어휘표 czns

네 클래스 모두 여기서 정의하며 외부 어휘표를 가리키지 않는다. 각각 schema.org를 그대로 쓸 수 없는 이유가 있다:

용어 中文 왜 자체적으로 두었나
czns:IntangibleHeritage 무형문화유산 항목 schema.org에는 대응 클래스가 없다. Article에 자유 텍스트를 더해도 회차·번호·신고 지역이라는 핵심 필드를 표시할 수 없다.
czns:Guide 일정 편성 schema.org의 TouristTrip은 itinerary 항목을 하나씩 열거해야 한다. 이 사이트는 도시별로 짠 서술형 코스 페이지라 구조가 맞지 않는다.
czns:FoodItem 음식 품류 채, 궈, 차는 문화 품류이지 영업 장소가 아니다. schema.org의 FoodEstablishment는 식당, 음식점 같은 실체를 가리키므로 한 요리에 쓸 수 없다.
czns:Fact 사실 항목 단일 주장을 독립적으로 인용하려면 가리킬 수 있는 기록 형이 필요한데, schema.org에 그러한 것이 없다.

그 밖에 자체 속성 일곱 개가 있어 데이터셋과 사실 목록에 쓰인다:

속성 의미
czns:pageType 페이지 자체가 무엇인가
czns:subjectType 페이지가 주로 기술하는 대상이 무엇인가
czns:cluster 언어 간 대응 관계. 같은 묶음의 각 페이지가 모본 slug를 공유한다
czns:charCount 본문 글자 수: 태그와 공백을 제거하고 세며, <script>, <style> 안의 삽입 데이터(사실 목록의 JSON 등)는 포함하지 않는다
czns:hasSourceSection “출처” 절이 있는가
czns:claim 한 줄의 사실 주장
czns:verifiedOn 그 사실이 마지막으로 확인을 통과한 날짜

그중 두 곳은 의도적으로 schema.org와 구분했다:czns:verifiedOn 는 사실이 마지막으로 확인을 통과한 날짜를 적고,schema:dateModified 는 페이지가 마지막으로 수정된 날짜를 적는다. 이 두 일은 종종 다르다. 어떤 사실은 10월 1일에 확인했고 10월 10일에는 링크만 덧붙였을 수 있다. 둘을 한 속성에 넣으면 기계는 “내용이 바뀌었다”와 “형식만 움직였다”를 구분할 수 없다.czns:claim 마찬가지로,schema:text 는 어떤 저작의 본문을 뜻하며, 일반적인 사실 주장 필드가 아니다.

4. 안정성 약속

세 가지. 여기에 적는 것 자체가 약속이다:

  • 식별자는 한 번 공개하면 바꾸거나 회수하지 않는다.항목을 합칠 경우, 합쳐진 쪽의 czid는 다른 항목에 배정하지 않는다.
  • 보통 식별자와 표준 주소는 글자 그대로 같다.즉 cz:<路径>/ 가 페이지 URL과 같다.
  • 페이지 이전이 이 규칙의 유일한 예외다.부득이 주소를 바꿀 때 옛 주소는 남겨 새 주소로 301하고, 데이터셋에는 이전 후의 표준 주소를 적는다. 옛 식별자는 데이터셋에 나오지 않으며, 주소 변경 경위는 사이트 기록에 남긴다.

안정성과 관련된 일이 하나 더 있다. 같은 내용의 다언어 판은 각각 독립 식별자를 가지며, 데이터셋의 cluster 필드로 같은 묶음임을 표시한다. 다섯 언어가 모본 slug를 공유한다. 이렇게 하지 않으면 같은 문화 대상의 다섯 언어 판을 기계가 서로 무관한 다섯 실체로 오해한다.

네 번째는 약속이라기보다 현재 상태다. 플랫폼은 WordPress.com으로 내용 협상(Accept 헤더 분기)을 할 수 없다. 그러므로 cz:chaozhou-opera/ 이 해결하는 것은 사람이 읽는 HTML 페이지이지 RDF 문서가 아니다. 기계가 구조화 데이터를 얻으려면 데이터셋 와 사실 목록 의 JSON을 쓴다. 이 점은 나중에 어긋나지 않도록 미리 있는 그대로 적는다.

5. 형과 항목의 대응

전체 272개 항목(그중 99페이지는 다른 언어의 판으로 175 묶음에 해당)의 형, 분야, 글자 수, 그림 수, “출처” 절 유무는 모두 데이터셋에 실려 있다. 여기서는 분포만 보인다:

분야 항목 수
일정 100
명소 39
기타 39
무형문화유산 13
풍속·예속 12
언어 분기 12
풍속·세시 10
이 사이트에 대하여와 참여 9
역사와 지리 7
인물 6
기계 판독 6
음식 6
문헌과 색인 5
방언 3
풍속·신앙 3
특집 2
페이지 형 항목 수
Article 205
CollectionPage 43
WebPage 20
Dataset 2
FAQPage 1
DefinedTermSet 1

6. 사용법

먼저 각 낱말이 무엇을 가리키고 왜 그렇게 정했는지 말한다. 파서가 직접 읽을 수 있는 정식 정의는 따로어휘표 czns에 있어 rdfs:label, rdfs:comment, rdfs:range, rdfs:subClassOf를 주고, Turtle 전문과 JSON-LD 두 형식을 덧붙인다.

아래 구절을 어떤 데이터의 @context에 넣으면 필드명이 이 규칙으로 전개된다:

{
  "@context": { … 下节的映射对象,整段复制 … },
  "czid": "cz:chaozhou-opera/",
  "cztype": "schema:Article",
  "title": "차오저우 극",
  "subjectType": "czns:IntangibleHeritage"
}

페이지 안 데이터에서cztype 의 값을 schema:Article 처럼 접두사가 붙은 형태로 쓰고, 벌거벗은 이름 Article.@type 의 값을 접두사로 전개한다. context에 schema 항목이 없으면 벌거벗은 이름은 상대 주소로 취급되어 페이지 기본 주소에 붙어 존재하지 않는 클래스가 된다. 이 사이트는 본래 131개 페이지 모두 벌거벗은 이름으로 썼는데, 2026-10-19에 접두사 붙인 형태로 고치고 context에도 schema 접두사를 보충했다. 고친 뒤 JSON-LD 프로세서로 페이지 주소에 따라 전개해 확인하니 131개 페이지의 @type 가 모두 https://schema.org/ 아래에 들어갔다.

플랫폼은 WordPress.com이라 업로드 허용 목록에 .json(.txt 가 없고 도 받지 않으므로, 원격으로 참조할 수 있는 context 주소가 없다. 일찍이 /wp-content/uploads/…/context.jsonld 라는 표기법을 준 적이 있으나 그 주소에서 실제로 문서를 얻을 수 없어 틀렸기에 거뒀다. 가능한 방법은 내장뿐이다. 다음 절의 매핑 객체를 데이터의 에 직접 넣는다. @context.

한 가지 헷갈리기 쉬운 점. 여기서의 매핑 객체는안쪽이며, 바깥쪽 {"@context": …} 까지 함께 한 겹 더 감싸지 않는다.

그대로 내장할 수 있는 매핑 객체:

{
 "cz": {
  "@id": "https://chaoshanwiki.com/",
  "@prefix": true
 },
 "czns": {
  "@id": "https://chaoshanwiki.com/ns/#",
  "@prefix": true
 },
 "schema": {
  "@id": "https://schema.org/",
  "@prefix": true
 },
 "czid": "@id",
 "cztype": "@type",
 "title": "https://schema.org/name",
 "url": {
  "@id": "https://schema.org/url",
  "@type": "@id"
 },
 "section": "https://schema.org/articleSection",
 "pageType": "czns:pageType",
 "subjectType": "czns:subjectType",
 "cluster": "czns:cluster",
 "chars": {
  "@id": "czns:charCount",
  "@type": "http://www.w3.org/2001/XMLSchema#integer"
 },
 "images": "https://schema.org/image",
 "has_sources": "czns:hasSourceSection",
 "modified": {
  "@id": "https://schema.org/dateModified",
  "@type": "http://www.w3.org/2001/XMLSchema#date"
 },
 "claim": "czns:claim",
 "verified": {
  "@id": "czns:verifiedOn",
  "@type": "http://www.w3.org/2001/XMLSchema#date"
 },
 "sourcePage": {
  "@id": "https://schema.org/citation",
  "@type": "@id"
 },
 "license": {
  "@id": "https://schema.org/license",
  "@type": "@id"
 },
 "Article": "https://schema.org/Article",
 "CollectionPage": "https://schema.org/CollectionPage",
 "WebPage": "https://schema.org/WebPage",
 "Dataset": "https://schema.org/Dataset",
 "FAQPage": "https://schema.org/FAQPage",
 "DefinedTermSet": "https://schema.org/DefinedTermSet",
 "TouristAttraction": "https://schema.org/TouristAttraction",
 "Place": "https://schema.org/Place",
 "Person": "https://schema.org/Person",
 "Event": "https://schema.org/Event",
 "Thing": "https://schema.org/Thing"
}

7. 이 어휘표의 적용 범위

세 가지를 분명히 한다. 첫째,두 겹을 나눠 보기: 다. 사람이 읽는의 정의와 이유에 대해 기계가 해석할 수 있는 쪽은 따로어휘표 czns에 있어 Turtle과 JSON-LD로 한 통씩 쓰고 rdfs:label, rdfs:comment, rdfs:range, rdfs:subClassOf를 준다. 다만 플랫폼은 .ttl 와 .json를 받지 않으므로 해석 가능한 독립 파일 끝점이 없다.subClassOf 도 공리가 아니라 선언이며 추론이 없다. 둘째,형 배정은 편집 판단이다. 특히 subjectType, 한 절 한 페이지씩 보며 정하고, 맞지 않으면 Thing로 적으며, 가지런히 하려고 억지로 끼워 넣지 않는다. 셋째,내용 협상이 없다. 같은 주소가 Accept 헤더에 따라 다른 형식을 반환하지 않는다. 이 세 가지가 쓰임에 영향을 준다면 참여 페이지의 안내에 따라 편지를 보내면 된다.

8. 다른 페이지와의 관계

네임스페이스는 “어떻게 가리키는가”만 다루고 “무엇을 말했는가”는 다루지 않는다. 내용 주장은 사실 목록에, 전체 사이트 목록은 데이터셋에, 각 말의 출처 규칙은 사료 문헌.

최종 수정일: 2026년 11월 20일