온톨로지 설계 스크립트 사용법 편집하기 (부분)

== '''섹션별 작성 방법''' ==
=== #Project ===
* <code>#Project</code>에는 '''네트워크 그래프의 제목이나 주제'''를 입력합니다.
* 하나의 스크립트가 어떠한 대상이나 주제를 다루는지 식별할 수 있는 이름을 사용합니다.
* 프로젝트 이름은 전체를 큰따옴표(<code>" "</code>)로 감쌉니다.

<pre>
#Project
"삼보사찰 네트워크"
</pre>

=== #Class ===
* <code>#Class</code>에는 네트워크 그래프로 표현하고자 하는 대상 세계의 '''범주(Class)'''를 정의합니다.
* <code>#Nodes</code>에서 사용하는 클래스는 <code>#Class</code>에 먼저 정의되어 있어야 합니다.

<pre>
#Class
Temple
Concept
Object
</pre>

=== #Relation ===
* <code>#Relation</code>에는 노드와 노드 사이에 사용할 '''관계(Relation)'''를 정의합니다.
* <code>#Links</code>에서 사용하는 관계는 <code>#Relation</code>에 먼저 정의되어 있어야 합니다.

<pre>
#Relation
knownAs
includes
visited
</pre>

=== #Nodes ===
* <code>#Nodes</code>에는 네트워크에서 '''하나의 개체로 식별하고자 하는 대상'''을 정의합니다.
* 하나의 노드는 최대 6개의 필드로 구성할 수 있습니다.
** 필수 필드: <code>id</code>, <code>class</code>, <code>label</code>
** 선택 필드: <code>infoUrl</code>, <code>iconUrl</code>, <code>remark</code>
* 각 필드는 정해진 순서에 따라 입력합니다.

{| class="wikitable" style="background-color:white; width:100%"
! 순서 !! 필드 !! style="width:80px;" | 구분 !! 내용
|-
| style="text-align:center;" | 1 || style="text-align:center;" | '''id''' || style="text-align:center; background:#e8f1fb;" | '''필수''' || 
* 노드를 고유하게 식별하기 위한 이름입니다.
* '''[참고] ID 부여시 유의사항'''
** ID는 유일해야 하며 중복해서 사용할 수 없습니다.
** ID에는 공백(white space)을 사용하지 않습니다. 필요한 경우 공백 문자 대신 언더바(<code>_</code>)를 사용합니다.
*** 예: <code>순천_송광사</code>, <code>송광사의_3대명물</code>
|-
| style="text-align:center;" | 2 || style="text-align:center;" | '''class''' || style="text-align:center; background:#e8f1fb;" | '''필수''' || 
* 노드가 속하는 범주입니다. 
* 반드시 <code>#Class</code>에 정의된 값을 사용합니다.
|-
| style="text-align:center;" | 3 || style="text-align:center;" | '''label''' || style="text-align:center; background:#e8f1fb;" | '''필수''' || 
* 네트워크 그래프에서 노드의 이름으로 표시되는 값입니다.
|-
| style="text-align:center;" | 4 || style="text-align:center;" | infoUrl || style="text-align:center; background:#f2f2f2;" | 선택 || 
* 노드에 관한 정보를 제공하는 웹 문서의 주소입니다. 
* 노드를 선택했을 때 웹 문서로 연결됩니다.
|-
| style="text-align:center;" | 5 || style="text-align:center;" | iconUrl || style="text-align:center; background:#f2f2f2;" | 선택 || 
* 네트워크 그래프에서 노드를 표시할 때 사용할 아이콘 이미지의 주소입니다.
* <code>iconUrl</code>이 지정된 노드는 해당 클래스에 색상과 모양이 지정되어 있더라도 아이콘 이미지로 표시됩니다.
* 아이콘 이미지 참조 '''☞ [[Icons]]'''
|-
| style="text-align:center;" | 6 || style="text-align:center;" | remark || style="text-align:center; background:#f2f2f2;" | 선택 || 
* 노드에 관한 부가설명입니다.
|}

* (예시1) 기본적인 노드 입력
<pre>
순천_송광사, Temple, 송광사
</pre>

* (예시2) <code>infoUrl</code>을 추가한 경우
<pre>
순천_송광사, Temple, 송광사, https://example.org/songgwangsa
</pre>

* (예시3) <code>infoUrl</code>을 사용하지 않고, <code>iconUrl</code>을 추가한 경우
<pre>
순천_송광사, Temple, 송광사, Null, https://example.org/songgwangsa.jpg
</pre>

* (예시4) <code>infoUrl</code>과 <code>iconUrl</code>을 사용하지 않고, <code>remark</code>를 추가한 경우
<pre>
삼보사찰, Concept, 삼보사찰, Null, Null, "삼보사찰은 불교의 신행과 귀의의 대상인 불(佛), 법(法), 승(僧)을 각각 상징하는 통도사, 해인사, 송광사를 함께 이르는 말이다."
</pre>

=== #Links ===
* <code>#Links</code>에는 '''노드와 노드 사이의 관계'''를 입력합니다.
* 하나의 링크는 최대 5개의 필드로 구성할 수 있습니다.
** 필수 필드: <code>source</code>, <code>target</code>, <code>relation</code>
** 선택 필드: <code>attribute</code>, <code>remark</code>
* 각 필드는 정해진 순서에 따라 입력합니다.

{| class="wikitable" style="background-color:white; width:100%"
! 순서 !! 필드 !! style="width:80px;" | 구분 !! 내용
|-
| style="text-align:center;" | 1 || style="text-align:center;" | '''source''' || style="text-align:center; background:#e8f1fb;" | '''필수''' || 
* 관계가 출발하는 노드의 id입니다.
|-
| style="text-align:center;" | 2 || style="text-align:center;" | '''target''' || style="text-align:center; background:#e8f1fb;" | '''필수''' || 
* 관계가 향하는 노드의 id입니다.
|-
| style="text-align:center;" | 3 || style="text-align:center;" | '''relation''' || style="text-align:center; background:#e8f1fb;" | '''필수''' || 
* 두 노드 사이의 관계입니다. 
* 반드시 <code>#Relation</code>에 정의된 값을 사용합니다.
|-
| style="text-align:center;" | 4 || style="text-align:center;" | attribute || style="text-align:center; background:#f2f2f2;" | 선택 || 
* 관계에 덧붙이는 속성 정보입니다.
* 관계가 성립한 시기나 관계의 성격 등 링크 자체에 관한 정보를 attribute로 표현할 수 있습니다.
|-
| style="text-align:center;" | 5 || style="text-align:center;" | remark || style="text-align:center; background:#f2f2f2;" | 선택 || 
* 관계에 관한 부가설명입니다.
|}

* (예시1) 기본적인 링크 입력
<pre>
순천_송광사, 승보사찰, knownAs
</pre>

* (예시2) <code>attribute</code>를 입력한 경우
<pre>
서소리, 순천_송광사, visited, 2025년 8월

☞ 2025년 8월은 노드(서소리)와 노드(순천_송광사) 사이의 관계(visited)에 부가된 속성 정보입니다. 
</pre>

* (예시3) <code>remark</code>만 입력한 경우
<pre>
승보사찰, 순천_송광사, knownAs, Null, "송광사는 삼보사찰 가운데 승보사찰로 알려져 있다."
</pre>

<div style="margin:12px 0 18px 0; padding:10px 14px; background:#f2f7fb; border-left:4px solid #5b83a3; border-radius:4px;">
🕸️ '''그래프 예시 보기''' &nbsp; 여러 유형의 노드·링크를 포함하는 스크립트 ☞ [[그래프예시-002.lst|<span style="color:#336b91;">그래프예시-002.lst</span>]]

<pre>
&lt;pre&gt;
#Project
"삼보사찰과 나의 방문 기록"

#Class
Place
Concept
Person

#Relation
includes
knownAs
visited

#Nodes
삼보사찰, Concept, 삼보사찰(三寶寺刹), https://buddhaland.dongguk.edu/bulVoca/view?dataId=KBDI0001418, https://kstoryhub.visualasia.com/classics/wiki/images/2/22/Sambosachal.png, 삼보사찰은 불교의 삼보인 불(佛)·법(法)·승(僧)을 각각 상징하는 통도사·해인사·송광사를 함께 이르는 말이다.
승보사찰, Concept, 승보사찰(僧寶寺刹), Null, https://kstoryhub.visualasia.com/classics/wiki/images/2/27/Seungbosachal.png, "승보사찰은 불교의 삼보 가운데 승(僧)을 상징하는 사찰로, 많은 고승을 배출한 송광사를 이르는 말이다."
법보사찰, Concept, 법보사찰(法寶寺刹), Null, https://kstoryhub.visualasia.com/classics/wiki/images/2/20/Beopbosachal.png, "법보사찰은 불교의 삼보 가운데 법(法)을 상징하는 사찰로, 팔만대장경을 봉안한 해인사를 이르는 말이다."
불보사찰, Concept, 불보사찰(佛寶寺刹), Null, https://kstoryhub.visualasia.com/classics/wiki/images/3/3d/Bulbosachal.png, "불보사찰은 불교의 삼보 가운데 불(佛)을 상징하는 사찰로, 석가모니의 진신사리를 봉안한 통도사를 이르는 말이다."
순천_송광사, Place, 송광사, Null, Null, Null
양산_통도사, Place, 통도사, Null, Null, Null
합천_해인사, Place, 해인사, Null, Null, Null
김정만, Person, 김정만, Null, https://kstoryhub.visualasia.com/classics/wiki/images/4/4e/S2602105_프로필.jpg, Null

#Links
삼보사찰, 승보사찰, includes, Null, Null
삼보사찰, 법보사찰, includes, Null, Null
삼보사찰, 불보사찰, includes, Null, Null
순천_송광사, 승보사찰, knownAs, Null, Null
합천_해인사, 법보사찰, knownAs, Null, Null
양산_통도사, 불보사찰, knownAs, Null, Null
김정만, 순천_송광사, visited, 2025년 8월, Null
김정만, 합천_해인사, visited, 2016년 4월, Null
김정만, 양산_통도사, visited, 2026년 8월, Null

#Translation

#End
&lt;/pre&gt;

== Visualize ==
{{ NetworkGraph | title={{PAGENAME}} }}
</pre>

</div>

=== #Translation ===
*<code>#Translation</code>에는 <code>#Nodes</code>에 정의한 노드의 '''다른 언어 번역 또는 표기 정보'''를 입력합니다.
*<code>#Translation</code>에 입력한 번역 정보는 '''네트워크 그래프에 별도로 표시되지 않습니다.''' 네트워크 그래프의 시각적 표현을 위한 정보가 아니라, 시맨틱 데이터를 AI와 함께 활용할 때 각 노드의 정확한 다국어 명칭을 제공하기 위한 정보입니다.
*예를 들어 시맨틱 데이터를 바탕으로 AI를 활용하여 스토리텔링 콘텐츠를 생성하거나 다국어 콘텐츠를 작성할 때, <code>#Translation</code>에 입력된 정보를 활용하여 노드의 명칭을 정확하게 번역·표기할 수 있습니다.
*<code>#Translation</code>은 선택 영역이므로 다국어 정보가 필요하지 않은 경우에는 작성하지 않아도 됩니다.
*하나의 번역 정보는 3개의 필드로 구성하며, 세 필드는 모두 필수입니다.
** 필수 필드: <code>id</code>, <code>translation</code>, <code>relation</code>
*하나의 노드에 여러 언어의 번역 정보를 각각 연결할 수 있습니다.
*각 필드는 정해진 순서에 따라 입력합니다.

{| class="wikitable" style="background-color:white; width:100%"
! 순서 !! 필드 !! style="width:80px;" | 구분 !! 내용
|-
| style="text-align:center;" | 1 || style="text-align:center;" | '''id''' || style="text-align:center; background:#e8f1fb;" | '''필수''' || 
* 번역 정보를 부여할 노드의 id입니다. 
* 반드시 <code>#Nodes</code>에 정의된 id를 사용합니다.
|-
| style="text-align:center;" | 2 || style="text-align:center;" | '''translation''' || style="text-align:center; background:#e8f1fb;" | '''필수''' || 
* 해당 노드의 다른 언어 번역어 또는 표기입니다.
* 번역어에 쉼표가 포함된 경우에는 <code>translation</code> 전체를 큰따옴표(<code>" "</code>)로 감쌉니다.
|-
| style="text-align:center;" | 3 || style="text-align:center;" | '''relation''' || style="text-align:center; background:#e8f1fb;" | '''필수''' || 
* 번역어의 언어를 식별하는 번역 관계입니다.
* 번역 언어에 따라 다음과 같은 값을 사용할 수 있습니다.
** <code>has'''English'''Translation</code>: 영어 번역
** <code>has'''Chinese'''Translation</code>: 중국어 번역
** <code>has'''Japanese'''Translation</code>: 일본어 번역
** <code>has'''German'''Translation</code>: 독일어 번역
|}

* (예시1) 영어 번역 정보
<pre>
#Translation
순천_송광사, "Songgwangsa, Suncheon", hasEnglishTranslation
</pre>

* (예시2) 하나의 노드에 여러 언어의 번역 정보를 입력한 경우
<pre>
#Translation
순천_송광사, Songgwangsa, hasEnglishTranslation
순천_송광사, 松廣寺, hasChineseTranslation
순천_송광사, 松広寺, hasJapaneseTranslation
</pre>

=== #End ===
* <code>#End</code>는 '''온톨로지 설계 스크립트의 끝'''을 나타내는 표시자입니다.
* 모든 클래스, 관계, 노드, 링크의 기술이 끝난 뒤 마지막에 입력합니다.

<pre>
#End
</pre>