Cloudwiki/설정/레이아웃 모드

# 개요

Cloudwiki에서 문서 조회 페이지의 레이아웃 모드를 변경하는 방법에 대해 다룹니다.
레이아웃 모드는 문서를 읽을 때 좌·우 사이드바에 무엇을 표시할지를 결정하며, `default`, `left-toc`, `right-toc`, `docs` 네 가지를 지원합니다.
이 설정은 `wrangler.toml` 의 `LAYOUT_MODE` 환경변수로 제어합니다.

# 레이아웃 모드 종류

| 모드 | 좌측 사이드바 | 우측 사이드바 |
| --- | --- | --- |
| `default` | 없음 | 트렌딩 / 최근 변경 |
| `left-toc` | 현재 문서 목차 | 숨김 |
| `right-toc` | 없음 | 현재 문서 목차 |
| `docs` | 슬래시 그룹 문서 트리 | 현재 문서 목차 |

정보:
`default`, `left-toc`, `right-toc`, `docs` 외의 값을 입력하거나 값을 비워두면 `default` 로 처리됩니다.

## default

기본값입니다. 별도로 설정하지 않으면 이 모드로 동작합니다.
우측 사이드바에 트렌딩(인기 문서)과 최근 변경 내역을 표시하며, 일반적인 위키 형태의 레이아웃입니다.

## left-toc

좌측 사이드바에 **현재 보고 있는 문서의 목차(TOC)** 를 표시하고, 우측 사이드바는 숨깁니다.
목차가 항상 화면 좌측에 고정되므로 문단이 많은 긴 문서를 탐색하기에 적합합니다.
목차가 없는(헤딩이 없는) 문서에서는 좌측 사이드바가 자동으로 숨겨집니다.

## right-toc

`left-toc` 와 동일하지만 **현재 문서의 목차(TOC)** 를 좌측이 아닌 **우측 사이드바** 에 표시합니다. 좌측 사이드바는 사용하지 않습니다.
목차를 화면 우측에 고정해 읽고 싶을 때 적합하며, `left-toc` 와 마찬가지로 목차가 없는(헤딩이 없는) 문서에서는 우측 사이드바가 자동으로 숨겨집니다.
트렌딩·최근 변경 카드는 본문 카드 하단으로 옮겨 표시됩니다.

## docs

좌측 사이드바에 **같은 그룹의 하위 문서 트리**, 우측 사이드바에 **현재 문서의 목차** 를 표시하는 기술 문서 스타일 레이아웃입니다.
좌측 트리의 그룹 기준은 슬러그의 첫 세그먼트(예: `Cloudwiki/설정/레이아웃 모드` 의 경우 `Cloudwiki`)이며, 슬래시(`/`)로 구분된 하위 문서들이 계층 구조로 묶여 표시됩니다.
매뉴얼·핸드북처럼 문서들이 슬래시 계층으로 잘 정리된 위키에 적합합니다.

정보:
`map:` 가상 문서나 이미지 문서에서는 좌측 그룹 트리가 표시되지 않습니다.


# 방법

## wrangler.toml 설정

Github 또는 로컬 저장소에서 `wrangler.toml` 파일을 열고
```
LAYOUT_MODE = "default" 
```

부분을 찾습니다.

`LAYOUT_MODE` 의 값을 원하는 모드로 변경하세요.
- 우측에 트렌딩/최근 변경을 표시하려면 `"default"`
- 좌측에 현재 문서 목차를 표시하려면 `"left-toc"`
- 우측에 현재 문서 목차를 표시하려면 `"right-toc"`
- 좌측에 그룹 문서 트리, 우측에 목차를 표시하려면 `"docs"`

## 저장후 배포
Github와 Cloudflare Workers가 연동된 경우, 파일이 저장되었을때 자동으로 배포됩니다. 
로컬에서 작업한 경우, 프로젝트 폴더의 루트 경로에서 터미널을 열고 `npx wrangler deploy` 를 입력해 배포합니다.

배포는 보통 1~2분 이내에 완료됩니다.

## 확인하기
배포가 완료되면 위키에 직접 접속해 정상적으로 적용되었는지 확인하세요.


배포가 완료되면 설정한 레이아웃 모드에 따라 문서 조회 페이지의 좌·우 사이드바 구성이 변경됩니다.