홈 › 기계 판독 › 어휘표
어휘표 czns
이것은 네임스페이스에 있는 자체 정의한 클래스와 속성의 기계 판독 정의: 네 개의 클래스와 일곱 개의 속성을 Turtle과 JSON-LD로 각각 한 번씩 작성했습니다. 이것이 있으면,czns:IntangibleHeritage 더 이상 페이지 앵커를 가리키는 이름만이 아니라, 정의와 값 범위를 가진 용어가 됩니다.

1. 이 어휘표에는 무엇이 포함되는가
네 개의 클래스:IntangibleHeritage(무형문화유산 항목),Guide(일정 편성),FoodItem(음식 품류),Fact(사실 항목). 일곱 개의 속성:pageType, subjectType, cluster, charCount, hasSourceSection, claim, verifiedOn. 각각에 rdfs:label, rdfs:comment 와 rdfs:range를 주고, 클래스에는 rdfs:subClassOf.
왜 rdfs:comment 를 쓰는가: 이름만 나열하지 않는 이유는 몇몇 용어의 경계가 바로 오용되어 온 지점이기 때문입니다. 예를 들어 FoodItem 의 주석에 “schema:FoodEstablishment는 사용하지 않는다——그것은 식당, 음식점 등 영업 장소를 가리킨다”라고 명시했고,verifiedOn 의 주석에 “schema:dateModified와는 다른 것으로, 합치지 않는다”라고 명시했습니다. 이러한 설명을 어휘표에 적어 두면 한 편의 글에 적는 것보다 우회되기 어렵습니다.
2. Turtle
@prefix czns: <https://chaoshanwiki.com/ns/#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
@prefix schema: <https://schema.org/> .
<https://chaoshanwiki.com/ns/#> a owl:Ontology ;
rdfs:label "차오산위키어휘표 czns"@zh ;
rdfs:comment "定义本站自有的类与属性。前缀 czns: 展开为 https://chaoshanwiki.com/ns/# ."@zh ;
owl:versionInfo "2026-10-19" .
czns:IntangibleHeritage a owl:Class ;
rdfs:label "非遗项目"@zh ;
rdfs:comment "对应国家级非物质文化遗产代表性项目名录中的项目或子项。页内须标编号、序号、批次与申报地区;项目名用名录原名,不做简写。"@zh ;
rdfs:subClassOf schema:Thing .
czns:Guide a owl:Class ;
rdfs:label "여행编排"@zh ;
rdfs:comment "按城市与天数编排的路线页。区别于 schema:TouristTrip——后者的여행项是结构化的 itinerary,本类不承诺该结构。"@zh ;
rdfs:subClassOf schema:Thing .
czns:FoodItem a owl:Class ;
rdfs:label "饮食品类"@zh ;
rdfs:comment "菜、粿、茶这一类文化品类。不使用 schema:FoodEstablishment——那指餐厅、饮食店等经营场所。"@zh ;
rdfs:subClassOf schema:Thing .
czns:Fact a owl:Class ;
rdfs:label "事实条目"@zh ;
rdfs:comment "单一可核查主张的记录。一条只表达一件事;复合说法须拆分。"@zh ;
rdfs:subClassOf schema:Thing .
czns:pageType a owl:DatatypeProperty ;
rdfs:label "页面类型"@zh ;
rdfs:comment "页面本身是什么。取值: Article, CollectionPage, WebPage, Dataset, FAQPage, DefinedTermSet."@zh ;
rdfs:range xsd:string .
czns:subjectType a owl:DatatypeProperty ;
rdfs:label "主体类型"@zh ;
rdfs:comment "页面主要描述的对象是什么。取值: Person, Place, TouristAttraction, Event, czns:IntangibleHeritage, czns:Guide, czns:FoodItem, DefinedTermSet, Thing."@zh ;
rdfs:range xsd:string .
czns:cluster a owl:DatatypeProperty ;
rdfs:label "跨语言簇"@zh ;
rdfs:comment "同一内容各语言版本共用的值,取母本 slug,用于把五种语言的分支认作同一对象。"@zh ;
rdfs:range xsd:string .
czns:charCount a owl:DatatypeProperty ;
rdfs:label "正文用字数"@zh ;
rdfs:comment "去标签、去空白后的字符数,含标点与拉丁字符;不含 script, style 标签内的嵌入数据(如사실 목록的 JSON)."@zh ;
rdfs:range xsd:integer .
czns:hasSourceSection a owl:DatatypeProperty ;
rdfs:label "设有来源节"@zh ;
rdfs:comment "该页是否设「来源」一节。"@zh ;
rdfs:range xsd:boolean .
czns:claim a owl:DatatypeProperty ;
rdfs:label "事实断言"@zh ;
rdfs:comment "一条可独立核查的陈述。不使用 schema:text——那表示某作品的正文。"@zh ;
rdfs:range xsd:string .
czns:verifiedOn a owl:DatatypeProperty ;
rdfs:label "核查日期"@zh ;
rdfs:comment "该条事实最后核对通过的日期。与 schema:dateModified(页面修改日期)不是一回事,不合并。"@zh ;
rdfs:range xsd:date .
3. JSON-LD
같은 내용을 JSON-LD로 바꾼 것입니다. 이 그래프는 따로 전체가 script#cz-vocab-json 안에 삽입되고, 유형은 application/ld+json——스크립트를 실행하지 않아도 얻을 수 있고, 크롤러와 파서가 그대로 읽을 수 있습니다.
{
"@context": {
"@vocab": "https://chaoshanwiki.com/ns/#",
"czns": "https://chaoshanwiki.com/ns/#",
"rdfs": "http://www.w3.org/2000/01/rdf-schema#",
"owl": "http://www.w3.org/2002/07/owl#",
"xsd": "http://www.w3.org/2001/XMLSchema#",
"schema": "https://schema.org/",
"@language": "zh",
"label": {
"@id": "rdfs:label"
},
"comment": {
"@id": "rdfs:comment"
},
"subClassOf": {
"@id": "rdfs:subClassOf",
"@type": "@id"
},
"range": {
"@id": "rdfs:range",
"@type": "@id"
}
},
"@graph": [
{
"@id": "https://chaoshanwiki.com/ns/#",
"@type": "owl:Ontology",
"label": "차오산위키어휘표 czns",
"comment": "定义本站自有的类与属性。前缀 czns: 展开为 https://chaoshanwiki.com/ns/# .",
"owl:versionInfo": {
"@value": "2026-10-19",
"@language": null
}
},
{
"@id": "czns:IntangibleHeritage",
"@type": "owl:Class",
"label": "非遗项目",
"comment": "对应国家级非物质文化遗产代表性项目名录中的项目或子项。页内须标编号、序号、批次与申报地区;项目名用名录原名,不做简写。",
"subClassOf": "schema:Thing"
},
{
"@id": "czns:Guide",
"@type": "owl:Class",
"label": "여행编排",
"comment": "按城市与天数编排的路线页。区别于 schema:TouristTrip——后者的여행项是结构化的 itinerary,本类不承诺该结构。",
"subClassOf": "schema:Thing"
},
{
"@id": "czns:FoodItem",
"@type": "owl:Class",
"label": "饮食品类",
"comment": "菜、粿、茶这一类文化品类。不使用 schema:FoodEstablishment——那指餐厅、饮食店等经营场所。",
"subClassOf": "schema:Thing"
},
{
"@id": "czns:Fact",
"@type": "owl:Class",
"label": "事实条目",
"comment": "单一可核查主张的记录。一条只表达一件事;复合说法须拆分。",
"subClassOf": "schema:Thing"
},
{
"@id": "czns:pageType",
"@type": "owl:DatatypeProperty",
"label": "页面类型",
"comment": "页面本身是什么。取值: Article, CollectionPage, WebPage, Dataset, FAQPage, DefinedTermSet.",
"range": "xsd:string"
},
{
"@id": "czns:subjectType",
"@type": "owl:DatatypeProperty",
"label": "主体类型",
"comment": "页面主要描述的对象是什么。取值: Person, Place, TouristAttraction, Event, czns:IntangibleHeritage, czns:Guide, czns:FoodItem, DefinedTermSet, Thing.",
"range": "xsd:string"
},
{
"@id": "czns:cluster",
"@type": "owl:DatatypeProperty",
"label": "跨语言簇",
"comment": "同一内容各语言版本共用的值,取母本 slug,用于把五种语言的分支认作同一对象。",
"range": "xsd:string"
},
{
"@id": "czns:charCount",
"@type": "owl:DatatypeProperty",
"label": "正文用字数",
"comment": "去标签、去空白后的字符数,含标点与拉丁字符;不含 script, style 标签内的嵌入数据(如사실 목록的 JSON).",
"range": "xsd:integer"
},
{
"@id": "czns:hasSourceSection",
"@type": "owl:DatatypeProperty",
"label": "设有来源节",
"comment": "该页是否设「来源」一节。",
"range": "xsd:boolean"
},
{
"@id": "czns:claim",
"@type": "owl:DatatypeProperty",
"label": "事实断言",
"comment": "一条可独立核查的陈述。不使用 schema:text——那表示某作品的正文。",
"range": "xsd:string"
},
{
"@id": "czns:verifiedOn",
"@type": "owl:DatatypeProperty",
"label": "核查日期",
"comment": "该条事实最后核对通过的日期。与 schema:dateModified(页面修改日期)不是一回事,不合并。",
"range": "xsd:date"
}
]
}
4. 이 어휘표가 하지 않는 일
세 가지를 먼저 분명히 말합니다. 실제보다 더 강한 것으로 여겨지지 않도록 하기 위해서입니다. 첫째는 추론 약속 없음: subClassOf 이라고 쓰여 있지만 schema:Thing, 선언적 성격이며, 이 사이트는 reasoner를 제공하지 않고 기계 추론 결론을 보장하지 않습니다. 둘째는 독립 파일 엔드포인트 없음: 플랫폼이 .ttl 와 .json를 받지 않으므로, czns.ttl 같은 주소는 존재하지 않습니다. 얻을 수 있는 것은 페이지 자체와 페이지 안의 script입니다. 셋째는 전체를 포하지 않음: 어휘표는 이 사이트 자체 정의 부분만 다루고, 나머지는 모두 schema.org를 재사용하며 동의어를 새로 만들지 않습니다.
넷째는 값 검증 없음: pageType, subjectType 의 허용값은 rdfs:comment 에 적혀 있고, rdfs:range 은 xsd:string로만 선언되어 있습니다. 즉, 어휘표가 허용값을 설명해도 기계가 다른 값을 막는 것은 아닙니다. 강한 제약이 필요하면 SHACL 같은 것을 따로 추가해야 하며, 이 사이트는 하지 않았습니다.
한 가지 제한도 밝히겠습니다: czns: 아래의 용어 URI는 /ns/# 에 앵커를 붙인 것으로, 해시 네임스페이스에 해당합니다. 하나의 HTML 페이지로 모든 용어를 담을 수 있고, 용어마다 주소를 열 필요가 없습니다. 이는 “콘텐츠 협상을 할 수 없다”는 같은 약점의 양면이며, 있는 그대로 적어 둡니다.
그렇다면 지금은 무엇으로 관리할까요? 두 가지이며, 2026년 10월 24일에 다시 실행했습니다. 하나는 전체 272개 페이지의 내장 JSON-LD를 페이지마다 JSON.parse하고, 결과는 모두 구문 분석할 수 있었습니다. 둘은 그 272개 페이지의 pageType, subjectType 값을 위의 두 허용값 목록과 하나씩 대조하여 범위를 벗어난 값이 없었습니다. 이 두 가지 외에 자동 관문 없음, 항목 내용과 사실 항목은 사람의 확인에 의존합니다.
5. 사용법
데이터에 "subjectType": "czns:IntangibleHeritage"라고 쓰고, 동시에 @context 안에서 "czns": {"@id": "https://chaoshanwiki.com/ns/#", "@prefix": true}을 선언하면 전개하여 용어 URI를 얻습니다. 완전한 내장 컨텍스트 객체는 네임스페이스 제6절에 있으며 그대로 복사할 수 있습니다.
한 가지 주의할 점: subjectType 의 값은 압축 IRI(예: czns:IntangibleHeritage)로 쓰여 있지만 range는 xsd:string이므로 JSON-LD 프로세서는 전개하지 않아 용어 URI로 전개되지 않고, 그대로의 문자열로 추출됩니다. 같은 접두사 표로 문자열을 한 번 바꾸면 https://chaoshanwiki.com/ns/#IntangibleHeritage. @type: @id 로 선언하지 않는 이유는, @type: @id 값 안에 Person, Place, Thing 같은 schema.org의 벌거벗은 클래스명이 있기 때문입니다. 한 번 @id 으로 처리하면 그것들은 @vocab 에 의해 ns/#Person 같은 존재하지 않는 용어로 이어집니다.
클래스와 속성의 사람이 읽는 정의, 값 설명, 두 층 유형의 구분은 모두 네임스페이스에 있으며, 실제로 이 필드를 사용하는 데이터는 데이터셋와 사실 목록.
최종 수정일: 2026년 11월 20일