Cloudwiki/기능/맵 및 그래프

Cloudwiki에서 `/` 문자를 이용해 하위 문서 구조를 만든 경우, 하위 문서 전체를 쉽게 탐색할 수 있는 map 보기를 사용할 수 있습니다. 또한 문서끼리 서로 가리키는 링크 관계를 시각적으로 살펴볼 수 있는 graph 보기도 제공합니다. 

# map: 문서

맵을 확인할 문서의 제목 앞에 `map:`을 붙이면 해당 문서의 맵을 열람할수 있습니다. 

해당 문서에 속한 하위 문서 전체 구조, 각 문서의 길이와 함께 각 문서의 목차를 한 페이지에서 열람할 수 있습니다. 

# 예시 

`map:Cloudwiki/기능` 열람 시 표시되는 내용입니다. 

[+ map:Cloudwiki/기능]

[[Cloudwiki/기능]] (문서 없음)
├── [[Cloudwiki/기능/ACL|ACL]] (72줄, 2334자)
│   ├── [[Cloudwiki/기능/ACL#1|#1. 개요]]
│   ├── [[Cloudwiki/기능/ACL#2|#2. 권한 관리 모달 열기]]
│   ├── [[Cloudwiki/기능/ACL#3|#3. 비공개 (열람 제한)]]
│   ├── [[Cloudwiki/기능/ACL#4|#4. 편집 ACL (편집 제한)]]
│   ├── [[Cloudwiki/기능/ACL#5|#5. 하위 문서 일괄 적용과 자동 규칙]]
│   ├── [[Cloudwiki/기능/ACL#6|#6. 카테고리 단위 ACL]]
│   └── [[Cloudwiki/기능/ACL#7|#7. 권한과 주의사항]]
├── [[Cloudwiki/기능/검색|검색]] (16줄, 412자)
│   ├── [[Cloudwiki/기능/검색#1|#1. 연관검색어]]
│   ├── [[Cloudwiki/기능/검색#2|#2. 문서 제목 및 FTS]]
│   └── [[Cloudwiki/기능/검색#3|#3. 이미지 및 카테고리 검색]]
├── [[Cloudwiki/기능/문서|문서]] (94줄, 2027자)
│   ├── [[Cloudwiki/기능/문서#1|#1. 문서]]
│   ├── [[Cloudwiki/기능/문서#1.1|#1.1. 제목]]
│   ├── [[Cloudwiki/기능/문서#1.1.1|#1.1.1. 금지 문자]]
│   ├── [[Cloudwiki/기능/문서#1.2|#1.2. 대체 제목]]
│   ├── [[Cloudwiki/기능/문서#1.2.1|#1.2.1. 특징]]
│   ├── [[Cloudwiki/기능/문서#1.2.2|#1.2.2. 주의 사항]]
│   ├── [[Cloudwiki/기능/문서#1.2.2.1|#1.2.2.1. 예시]]
│   ├── [[Cloudwiki/기능/문서#1.2.3|#1.2.3. 검색]]
│   ├── [[Cloudwiki/기능/문서#1.2.4|#1.2.4. 중복 규칙]]
│   ├── [[Cloudwiki/기능/문서#1.2.5|#1.2.5. 설정 방법]]
│   ├── [[Cloudwiki/기능/문서#1.3|#1.3. 하위문서 구조]]
│   ├── [[Cloudwiki/기능/문서#1.3.1|#1.3.1. 특징]]
│   └── [[Cloudwiki/기능/문서#1.4|#1.4. 특수 문서: 네임스페이스]]
├── [[Cloudwiki/기능/문서 주시|문서 주시]] (71줄, 1678자)
│   ├── [[Cloudwiki/기능/문서 주시#1|#1. 개요]]
│   ├── [[Cloudwiki/기능/문서 주시#2|#2. 주시 종류]]
│   ├── [[Cloudwiki/기능/문서 주시#3|#3. 문서 주시 사용법]]
│   ├── [[Cloudwiki/기능/문서 주시#3.1|#3.1. 주시 설정]]
│   ├── [[Cloudwiki/기능/문서 주시#3.2|#3.2. 주시 변경 / 해제]]
│   ├── [[Cloudwiki/기능/문서 주시#4|#4. 카테고리 주시 사용법]]
│   ├── [[Cloudwiki/기능/문서 주시#5|#5. 알림]]
│   ├── [[Cloudwiki/기능/문서 주시#6|#6. 권한 및 비공개 문서]]
│   ├── [[Cloudwiki/기능/문서 주시#7|#7. 동작 메커니즘]]
│   ├── [[Cloudwiki/기능/문서 주시#8|#8. 편집된 문서 자체의 직접 주시자 (`page_watches`)]]
│   ├── [[Cloudwiki/기능/문서 주시#9|#9. 편집된 문서가 하위 문서인 경우, 모든 상위 슬러그를 `하위 문서까지` 로 주시하는 유저]]
│   ├── [[Cloudwiki/기능/문서 주시#10|#10. 편집된 문서가 속한 카테고리를 주시하는 유저 (`category_watches`)]]
│   └── [[Cloudwiki/기능/문서 주시#11|#11. 관련 문서]]
├── [[Cloudwiki/기능/카테고리|카테고리]] (28줄, 840자)
│   ├── [[Cloudwiki/기능/카테고리#1|#1. 개요]]
│   ├── [[Cloudwiki/기능/카테고리#2|#2. 카테고리 입력]]
│   ├── [[Cloudwiki/기능/카테고리#3|#3. 카테고리로 문서 찾기]]
│   └── [[Cloudwiki/기능/카테고리#4|#4. 카테고리 기반 편집 권한]]
├── [[Cloudwiki/기능/템플릿|템플릿]] (21줄, 417자)
│   ├── [[Cloudwiki/기능/템플릿#1|#1. 개요]]
│   ├── [[Cloudwiki/기능/템플릿#2|#2. 기능]]
│   ├── [[Cloudwiki/기능/템플릿#2.1|#2.1. 템플릿 문서 생성]]
│   ├── [[Cloudwiki/기능/템플릿#2.2|#2.2. 템플릿 불러오기]]
│   └── [[Cloudwiki/기능/템플릿#3|#3. 기타]]
├── [[Cloudwiki/기능/토론|토론]] (20줄, 492자)
│   ├── [[Cloudwiki/기능/토론#1|#1. 개요]]
│   └── [[Cloudwiki/기능/토론#1.1|#1.1. 토론 페이지 접속]]
└── [[Cloudwiki/기능/틀|틀]] (37줄, 547자)
    ├── [[Cloudwiki/기능/틀#1|#1. 개요]]
    ├── [[Cloudwiki/기능/틀#2|#2. 틀 작성 방법]]
    ├── [[Cloudwiki/기능/틀#3|#3. 틀 삽입]]
    ├── [[Cloudwiki/기능/틀#4|#4. 틀 예시]]
    └── [[Cloudwiki/기능/틀#5|#5. 틀 수정]]
[-]

# 권한 표시

map 페이지 상단 메타 영역의 **권한 표시** 체크박스를 활성화하면 트리의 각 문서 옆에 권한 관련 태그가 함께 표시됩니다.

* 비공개 문서: [비공개]
* 편집 ACL이 걸린 문서: [플래그 라벨 목록] — 걸린 [[Cloudwiki/기능/ACL|ACL]] 플래그가 쉼표로 표시됩니다.

이 토글은 **관리자 전용**이며, 일반 사용자에게는 체크박스 자체가 노출되지 않습니다. 비공개 문서 자체도 일반 사용자의 map 트리에서 처음부터 제외됩니다.

체크 상태는 브라우저에 저장되어 다른 `map:` 문서로 이동해도 자동으로 유지됩니다. URL 쿼리스트링 `?perms=1` 을 직접 붙여도 동일하게 동작합니다.

# graph: 문서

문서 제목 앞에 `graph:` 를 붙이면, 그 문서를 중심으로 **직접 연결된 문서들의 관계망**(에고 그래프)을 시각적으로 볼 수 있습니다. 예: `graph:Cloudwiki/기능`.

`map:` 이 `/` 하위 문서의 **계층 트리**를 보여준다면, `graph:` 는 문서끼리 서로 가리키는 **링크 관계**를 그래프로 보여줍니다.

## 노드와 엣지

* **노드(원)** = 실제 존재하는 문서. 중심 문서는 [빨강] 으로 강조됩니다.
* **엣지(선)** = 문서 간 직접 참조입니다. 위키링크 `[[...]]` 와 틀 `{{...}}` 만 대상이며, 이미지·존재하지 않는 문서(레드링크)는 제외됩니다.
  * 실선 = 위키링크, 점선 = 틀, 굵은 선 = 서로 가리키는 상호 링크
* 노드 색은 문서의 **분류**를 나타내며(우상단 범례 제공), 점선 테두리는 비공개 문서입니다.
* 노드 크기는 그래프 안에서의 연결 수에 비례합니다.

## 탐색 범위

중심 문서에서 몇 단계(홉)까지 펼칠지 상단에서 고를 수 있습니다.

* **1홉**(기본): 중심 문서와 직접 연결된 문서까지
* **2홉**: 그 이웃의 이웃까지

부하 방지를 위해 노드·엣지 수에 상한이 있으며, 한 번에 표시하기에 너무 많으면 가까운 이웃 위주로 일부만 표시하고 안내가 함께 나타납니다.

## 조작

* 노드 **클릭** → 해당 문서로 이동
* 노드 **더블클릭** → 그 문서를 중심으로 그래프 다시 그리기(재중심화)
* 노드에 **마우스를 올리면** 제목·연결 수 툴팁 표시
* **노드 드래그**로 위치 이동, **마우스 휠**로 확대/축소, **빈 곳 드래그**로 화면 이동(팬)

## 여는 방법

* 문서 우상단 **더보기 메뉴 → 그래프 보기**
* 또는 주소·검색에서 문서 제목 앞에 `graph:` 를 붙여 이동

## 권한

비공개 문서는 열람 권한이 있는 사용자에게만 그래프에 표시됩니다. 캐시 정책은 `map:` 과 동일합니다.

# 주의사항

문서 제목 앞에는 `map:` / `graph:` 를 사용할 수 없습니다. 두 접두사는 가상 뷰 전용 네임스페이스이므로, 일반 문서의 생성·이동·복원 대상이 될 수 없습니다.

전체 위키를 한 번에 그리는 전역 그래프(`graph:` 만 입력)는 부하 문제로 제공하지 않습니다 — 항상 특정 문서를 중심으로 한 `graph:<문서명>` 에고 그래프만 지원합니다.