위키 사용 안내

위키 사용 안내는 UTOP 지식위키의 문서 작성, 용어 연결, 검증상태와 공개범위 원칙을 정리한 운영문서다.

1. 책자와 위키의 역할

• 책자: 비전통오일에서 UTOP까지 이어지는 공식 독해 순서와 인과적 서사
• 위키: 개념·기술·기관·사건을 개별 페이지로 분리한 탐색체계
• 공통 근거: 원문자료, 공식 통계, 출처대장과 검증된 사업단 기록

책 문장을 페이지별로 복사하지 않는다. 같은 사실을 책에서는 서사로, 위키에서는 정의·관계·근거 중심으로 재구성한다.

2. 새 용어를 만났을 때

1. 검색으로 기존 페이지의 제목과 별칭을 확인한다.
2. 여러 문서에서 다시 설명할 가치가 있는 어려운 용어라면 씨앗 페이지를 만든다. 일반 단어와 단순 번역어는 별도 페이지로 만들지 않는다.
3. 페이지 제목과 본문은 한글을 우선하고 영문명·약어는 aliases에 등록한다.
4. 첫 등장에는 공식 한글명이 있으면 한글명(약어, 영문 전체명), 없으면 한글명 또는 통용명(영문명)으로 병기한다. 이후에는 한글명이나 약어를 사용한다.
5. 보편적인 정의·원리·역할은 일반 지식에 작성한다. UTOP·Sawn Lake의 계획·협의·적용 내용은 사업 기록에 작성하고 일반 설명에서는 해당 기록으로 연결한다. 기록을 옮길 때 원문 근거와 미확인 상태를 함께 보존한다.
6. 관련 항목은 본문에서 처음 의미 있게 등장하는 위치에 [[위키링크]]로 연결하고, 확인한 원문과 공식 자료를 근거자료에 기록한다.
7. 새 문서 작성이나 기존 문서 보강 뒤 npm run wiki:audit-links -- content/경로/문서.md를 실행해, 기존 제목·별칭이 평문으로 남았는지 확인한다. 자기링크·일반단어·의미충돌 별칭은 연결하지 않는다.

3. 상태값

상태값은 내용의 완성도를 나타내며 출판 승인이나 전문 기술검토 완료를 뜻하지 않는다.

상태	의미
씨앗	정의와 질문만 우선 기록
정리 중	설명·관계·출처를 보강 중
부분 검증	핵심 주장 일부를 원출처와 대조
검증됨	현재 용도의 핵심 설명과 근거 확인
확인 필요	출처 또는 사건 관계가 불명확
보류	현재 범위에서는 사용하지 않음

4. 공개범위

값	의미
local	현재 개인용 로컬 위키
internal	향후 내부 공개 후보
restricted	별도 제한이 필요한 내용
exclude	공개 빌드에서 제외할 내용

visibility는 분류표다. 파일을 실제로 보호하지 않는다. 내부 공개를 시작하기 전에는 restricted와 exclude 문서를 빌드 산출물에서 제거하고, 웹 접근 앞에 조직 인증을 둬야 한다.

5. 문서 유형

• 개념·물성
• 자원·지질
• 기술·공정
• 설비·계통
• 기관·제도
• 사건·사업·광구
• 자료·통계

각 페이지는 한 대상을 중심으로 작성한다. 한글명·영문명·약어가 같은 대상을 뜻하면 aliases로 묶는다.