# 파일 트리 (/editor-functions/file-tree)





**이런 경우에 사용해보세요**

* 소설의 에피소드와 위키 문서를 한곳에서 탐색하고 싶었던 적이 있나요?
* 집필 상태와 분량을 목록에서 함께 보며 다음에 작업할 회차를 고르고 싶었던 적이 있나요?
* 위키 문서를 분류별로 모아 보고, 목록에서 바로 분류를 정리하고 싶나요?
* [Scrivener](https://www.literatureandlatte.com/scrivener/overview)나 [Obsidian](https://obsidian.md/)처럼 파일 트리를 중심으로 문서를 오가는 작업 방식에 익숙한가요?
* [워크스페이스](/workspace)에서 문서를 빠르게 탐색하고 필요한 문서를 분할 화면으로 열고 싶나요?

파일 트리는 [소설 프로젝트](/novel)에 속한 [에피소드](/episode)와 [위키 문서](/wiki)를 트리 형태로 보여줍니다. 현재 문서를 벗어나지 않고 다른 문서를 열거나 새 문서를 만들 수 있습니다.

## 기본 조작 [#기본-조작]

에피소드나 위키 문서를 누르면 문서가 열립니다. 여는 위치는 파일 트리를 사용한 화면에 따라 다릅니다.

* [워크스페이스](/workspace)에서 파일 트리 전용 탭을 열었거나 파일 트리 위젯을 위젯 보드에 추가한 경우, 문서를 누르면 워크스페이스 탭으로 열립니다. `Ctrl` 또는 `Command`를 누른 채 선택하면 분할 탭으로 엽니다.
* 에피소드나 위키 편집기의 [파일 트리 위젯](/widgets/file-tree)에서 누르면 현재 화면을 선택한 문서로 이동합니다.

항목을 마우스 오른쪽 버튼으로 누르면 이름 변경이나 삭제처럼 해당 문서에서 사용할 수 있는 메뉴가 열립니다.

## 에피소드 탐색 [#에피소드-탐색]

에피소드는 소설에 정해 둔 순서와 [에피소드 그룹](/episode/chapter)에 따라 표시됩니다. 그룹을 누르면 하위 에피소드를 접거나 펼칠 수 있습니다. 그룹에 마우스를 올리면 나타나는 <LuGitFork style="{ display: 'inline' }" /> `플롯 에디터 열기`를 누르면 해당 그룹의 플롯을 열 수 있습니다.

파일 트리의 **에피소드** 제목 오른쪽에서 <TbAdjustmentsHorizontal style="{ display: 'inline' }" /> `에피소드 목록 표시 설정`을 누르세요. 필요한 기준에 따라 [집필 상태](/episode/writing-status)나 [글자 수](/editor-functions/text-count)를 각 에피소드 옆에 표시할 수 있습니다.

에피소드 그룹에는 그룹에 속한 에피소드의 글자 수 합계가 표시됩니다. 여러 에피소드로 나눈 장이나 부의 전체 분량을 한눈에 확인할 때 사용할 수 있습니다.

## 위키 탐색과 분류 [#위키-탐색과-분류]

위키의 파일 트리는 컴퓨터 폴더나 실제 파일 경로를 그대로 보여주는 기능이 아닙니다. [위키의 분류 시스템](/wiki/category-system)을 익숙한 파일 트리 형태로 표현한 탐색 화면입니다. 따라서 문서가 여러 분류나 태그에 속하면 같은 위키 문서가 여러 그룹에 나타날 수 있으며, 트리에서 문서를 옮기면 실제 파일이 아니라 문서의 분류 속성이 바뀝니다.

위키 목록의 <TbAdjustmentsHorizontal style="{ display: 'inline' }" /> `위키 목록 표시 설정`에서는 다음과 같이 문서를 묶을 수 있습니다. 같은 그룹 안에서는 중요도나 이름순으로 정렬합니다.

| 그룹화 방식 | 트리에 표시되는 구조                  | 문서를 끌어 놓았을 때                         |
| ------ | ---------------------------- | ------------------------------------ |
| 없음     | 모든 위키 문서를 한 목록으로 표시          | 그룹이 없으므로 분류를 변경할 수 없음                |
| 대분류    | 인물·장소·사물 같은 대분류별로 표시         | 문서의 대분류를 대상 그룹으로 변경                  |
| 분류     | 사용자가 만든 분류 문서의 상하 관계에 따라 표시  | 기존 분류를 대상 분류로 변경. `Shift`를 누르면 분류 추가 |
| 대분류+분류 | 대분류 아래에 사용자가 만든 분류 구조를 함께 표시 | 대분류 또는 분류를 대상 그룹에 맞게 변경              |
| 태그     | 문서에 지정한 태그별로 표시              | 기존 태그를 대상 태그로 변경. `Shift`를 누르면 태그 추가 |

그룹화한 위키 목록에서는 문서를 다른 그룹으로 끌어 놓아 [분류 시스템](/wiki/category-system)의 값을 바꿀 수 있습니다. 분류나 태그로 묶었을 때는 문서를 끌어 놓으면 기존 값을 새 그룹으로 바꾸고, `Shift`를 누른 채 끌어 놓으면 기존 값을 유지하면서 새 분류나 태그를 추가합니다. 대분류 사이에서 옮기면 문서의 대분류가 바뀝니다.

## 목록 보조 정보 [#목록-보조-정보]

**목록 보조 정보**는 문서를 열지 않아도 상태를 파악할 수 있도록 각 항목 오른쪽에 붙는 짧은 표시입니다. 현재 표시할 수 있는 정보는 다음과 같습니다.

| 목록                          | 보조 정보                                | 표시 내용                   |
| --------------------------- | ------------------------------------ | ----------------------- |
| [에피소드](/episode)            | [집필 상태](/episode/writing-status)     | 예정·진행·퇴고·완료 상태          |
| 에피소드                        | [글자 수](/editor-functions/text-count) | 공백 제외 또는 공백 포함 글자 수     |
| [에피소드 그룹](/episode/chapter) | 합산 글자 수                              | 그룹에 속한 에피소드 전체의 글자 수 합계 |
| [위키 문서](/wiki)              | 중요도                                  | 문서 속성에 지정한 중요도          |

각 목록 제목 오른쪽의 <TbAdjustmentsHorizontal style="{ display: 'inline' }" /> 표시 설정에서 필요한 정보만 켜세요. 본문 영역을 넓게 쓰고 싶다면 모두 끌 수 있습니다.

> **제작자의 말**
>
> [#제작자의-말]
> 
> 뮤블의 에피소드는 웹소설의 회차에서 가져온 순차적인 구조이고, 위키는 대규모 [Wikipedia](https://www.wikipedia.org/)에서 사용하는 분류 체계에서 아이디어를 얻었습니다. 하나는 정해진 흐름을 따라 읽는 원고이고 다른 하나는 여러 분류와 관계로 탐색하는 설정 자료이므로, 둘 다 컴퓨터의 실제 파일과 폴더 구조에 완벽하게 대응하지는 않습니다.
> 
> 파일 트리는 이 서로 다른 구조를 작가에게 익숙한 형태로 보여주는 보기 방식입니다. 에피소드와 위키를 억지로 파일 구조에 맞추는 것이 아니라, 각 구조의 특성을 유지한 채 빠르게 탐색할 수 있도록 파일 트리의 외형과 조작법을 빌렸습니다. 뮤블에서 파일 트리는 작품 데이터의 원래 구조가 아니라 여러 탐색 방식 가운데 하나입니다.

## 관련 설정 [#관련-설정]

| 설정 및 위치 | 기본값 | 선택지·범위 | 동작 |
| --- | --- | --- | --- |
| 집필 상태 — 위치: 파일 트리 → 에피소드 목록 표시 설정 → 집필 상태 | 꺼짐 | — | 에피소드 목록에 집필 상태를 표시합니다. |
| 글자 수 (공백 제외) — 위치: 파일 트리 → 에피소드 목록 표시 설정 → 글자 수 (공백 제외) | 꺼짐 | — | 에피소드와 그룹에 공백을 제외한 글자 수를 표시합니다. |
| 글자 수 (공백 포함) — 위치: 파일 트리 → 에피소드 목록 표시 설정 → 글자 수 (공백 포함) | 꺼짐 | — | 에피소드와 그룹에 공백을 포함한 글자 수를 표시합니다. |
| 그룹화 — 위치: 파일 트리 → 위키 목록 표시 설정 → 그룹화 | 대분류+분류 | 없음, 대분류, 분류, 대분류+분류, 태그 | 위키 문서를 묶어 보여줄 기준을 선택합니다. |
| 정렬 — 위치: 파일 트리 → 위키 목록 표시 설정 → 정렬 | 중요도 | 중요도, 이름 | 같은 그룹 안에서 위키 문서를 정렬합니다. |
| 중요도 표시 — 위치: 파일 트리 → 위키 목록 표시 설정 → 중요도 표시 | 꺼짐 | — | 위키 문서 목록에 중요도를 함께 표시합니다. |

## 관련 기능 [#관련-기능]

- [워크스페이스](/workspace): 화면을 여러 영역으로 나누어 원고, 설정, 검색과 보조 도구를 한 프로젝트 안에서 함께 사용합니다.
- [파일 트리 위젯](/widgets/file-tree): 에디터의 파일 트리를 집필 중 편하게 사용할 수 있도록 위젯 영역으로 옮긴 기능입니다.
- [집필 상태](/episode/writing-status): 에피소드의 진행 단계를 구분하고 완성한 원고를 편집으로부터 보호합니다.
- [분류 시스템](/wiki/category-system): 위키 문서를 대분류와 사용자 정의 분류로 묶어 작품의 설정 구조를 계층적으로 관리합니다.

***

- **문서 최종 갱신 버전:** v2.11.5