Cloudwiki

Cloudwiki/기능/프레젠테이션

정보:
일반 위키 문서를 슬라이드 덱처럼 페이지 단위로 분할해 표시하는 **프레젠테이션 모드** 를 설명합니다. 문서별 설정이며 기본 레이아웃 안에서 인라인으로 표시되고, 별도 버튼으로 전체화면 발표 모드에 진입할 수 있습니다.


# 개요

문서의 `layout_mode` 를 **프레젠테이션** 으로 설정하면 본문이 `---` 수평선을 경계로 슬라이드 단위로 분할되어 표시됩니다. 슬라이드 본문은 일반 위키 본문과 완전히 동일한 문법으로 작성하며, 트랜스클루전·팔레트·각주 등 모든 위키 기능이 그대로 동작합니다.

이 설정은 문서를 편집할 수 있는 **모든 사용자** 가 변경할 수 있으며, 문서 에디터의 **프레젠테이션 모드** 체크박스로 켜고 끕니다. 즉시 적용되지 않고 문서를 저장하는 순간 본문과 함께 하나의 리비전으로 기록되어 반영되며, 새 문서를 만들 때도 설정할 수 있습니다.

---

# 설정 방법

문서 에디터의 카테고리·넘겨주기 설정 아래에 ** 프레젠테이션 모드** 체크박스가 있습니다. 체크하면 프레젠테이션 모드가 켜지고, 해제하면 `자동(전역 설정 따름)` 으로 되돌아갑니다.

체크 상태는 **즉시 적용되지 않습니다**. 문서를 저장하는 순간 본문 변경과 함께 하나의 리비전으로 기록되어 반영되며, 본문을 건드리지 않고 프레젠테이션 모드만 바꿔도 저장이 가능합니다. 이때 자동 편집 요약에는 `프레젠테이션 모드 설정` / `프레젠테이션 모드 해제` 가 표시됩니다.

새 문서를 만들 때도 같은 체크박스로 처음부터 프레젠테이션 모드로 생성할 수 있습니다. 다만 섹션 편집 모드에서는 체크박스가 숨겨지며, 문서 전체 편집 화면에서만 변경할 수 있습니다.

---

# 슬라이드 분할 규칙

본문을 줄 단위로 스캔하며 다음 조건을 모두 만족하는 라인을 슬라이드 경계로 인식합니다.

* 라인 전체가 정확히 `---` 일 것 (앞뒤 공백만 허용)
* 코드 펜스(```` ``` ```` 또는 `~~~`) **외부** 일 것
* 컨테이너 블록(`:::card`, `:::info` 등) **외부** 일 것

`***` / `___` 등 다른 수평선 문법은 슬라이드 분할에 사용되지 **않습니다**. 코드 블록 안의 `---` 나 `:::card` 내부의 `---` 는 단순 텍스트/구분선으로만 취급되어 슬라이드를 나누지 않습니다.

---

## 작성 예시

```
첫 번째 슬라이드 제목

본문 내용...

---

두 번째 슬라이드 제목

여기에 표·이미지·트랜스클루전 등 일반 위키 문법을 그대로 사용.

---

마지막 슬라이드
```

---

# 표시 모드

프레젠테이션 문서는 상황에 따라 세 가지 모드로 표시됩니다.

## 인라인 (기본)

문서를 열면 헤더·사이드바·푸터가 모두 유지된 상태에서 본문 영역에 **슬라이드 덱 카드** 가 표시됩니다. 좌우 화살표 버튼·진행 바·페이지 인디케이터(`3 / 12`) 가 카드 하단에 노출되며, 슬라이드는 카드 안에서 페이드인 전환됩니다.

인라인 모드에서는 페이지 스크롤·단축키와의 충돌을 막기 위해 슬라이드 이동 단축키가 비활성화되어 있고, 카드 안의 컨트롤 버튼으로만 이동합니다.

## 전체화면

슬라이드 덱 컨트롤 바의  **전체 화면** 버튼을 누르거나 `F` 키를 누르면 발표용 풀스크린 모드로 전환됩니다. 위키의 헤더·사이드바·푸터·하단 내비 등이 모두 숨겨지고 슬라이드가 뷰포트를 가득 채웁니다. 본문 폰트도 발표 가독성에 맞춰 자동으로 확대됩니다.

전체화면에서는 다음 단축키가 활성화됩니다.

| 키 | 동작 |
| --- | --- |
| → / Space / PageDown | 다음 슬라이드 |
| ← / PageUp | 이전 슬라이드 |
| Home | 첫 슬라이드 |
| End | 마지막 슬라이드 |
| F | 전체화면 토글 |
| Esc | 전체화면 종료 |

화면 좌측 25% / 우측 25% 영역을 클릭해도 이전/다음 슬라이드로 이동합니다(컨트롤 바와 본문 내 링크·버튼 클릭은 보호됩니다).

## 읽기 모드

문서 도구 드롭다운의  **읽기 모드** 를 켜면 슬라이드 분할이 일시적으로 해제되고, 모든 슬라이드 내용이 합쳐진 **일반 문서** 와 같은 형태로 표시됩니다. 발표용이 아닌 통독·검색·인용에 유용합니다. 읽기 모드를 끄면 다시 슬라이드 덱으로 복원됩니다.

---

# 슬라이드 위치 공유

현재 슬라이드 번호는 URL 해시(`#/3`) 로 자동 동기화됩니다. 이 URL 을 그대로 공유하면 상대방도 같은 슬라이드부터 볼 수 있고, 새로고침해도 위치가 유지됩니다.

---

# 주의 사항

* 프레젠테이션 모드는 **문서 내부 렌더 모드** 이며, 전역 레이아웃 설정(`LAYOUT_MODE`) 을 바꾸지 않습니다. 사이드바·헤더 구성은 평소와 동일합니다.
* 슬라이드 안에서 일반 헤딩(`##`, `###`) 을 사용해도 좋지만, 본문 전체 목차(TOC) 와 섹션 편집은 슬라이드 모드에서는 제공되지 않습니다.
* 편집 화면의 실시간 미리보기는 항상 **일반 렌더** 로 표시됩니다. 슬라이드 형태로 확인하려면 저장 후 정식 문서 페이지에서 봐야 합니다.
* 본문에 `---` 가 한 번도 없으면 전체 본문이 단일 슬라이드로 표시됩니다.