# 프로젝트 노트와 공유 노트

노트를 프로젝트에 연결하고, 프로젝트의 notes 폴더에 노트를 보관하고, 공동 작업 서버로 다른 사람과 함께 노트를 씁니다.

노트는 실험 기능이며 켜기 전에는 꺼져 있습니다. [노트 켜기](/docs/notes/#turn-on-notes)를 참고하세요.

노트가 프로젝트와 함께 있는 방식은 두 가지입니다. 개인 노트는 노트에 있으며 프로젝트에 연결할 수 있고, 나만 볼 수 있습니다. 프로젝트 노트는 프로젝트의 `notes` 폴더에 있는 파일이므로 프로젝트와 함께 이동하며, 프로젝트를 공유한 모든 사람도 갖게 됩니다.

## 노트를 프로젝트에 연결하기

노트에 있는 노트의 헤더에는 노트의 위치가 표시됩니다. **노트 홈**을 나타내는 집 아이콘, 그다음 프로젝트, 그다음 제목입니다.

![Long-context LLMs: thesis hub 노트의 헤더에는 집 아이콘에서 LLaMA 프로젝트, 그리고 제목으로 이어지는 위치가 표시되고, 사이드바에서는 이 노트가 그 프로젝트 아래에 나열됩니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/notes-workspace-dark-window-v2.png#view=0,0,1060,930)

1. 노트에서 노트를 엽니다.
2. 헤더에서 프로젝트 이름을 선택합니다. 프로젝트가 없는 노트에는 그 자리에 **프로젝트 선택**이 표시됩니다.
3. 목록에서 프로젝트를 고릅니다. **프로젝트 없음**은 연결을 제거합니다.

노트의 **더 보기** 메뉴에서 **프로젝트에 연결**을 선택해도 같고, 노트 사이드바에서 노트를 마우스 오른쪽 버튼으로 클릭해 나오는 메뉴도 같습니다. 아직 없는 프로젝트에 노트를 연결하려면 노트 헤더에서 **새 프로젝트**를 선택하세요. 만든 프로젝트가 노트에 연결됩니다.

연결된 노트도 여전히 개인 노트입니다. 노트에 남아 있으며, 프로젝트를 공유한 사람 누구도 이 노트를 갖지 않습니다. 연결 정보는 이 컴퓨터에만 보관됩니다.

노트를 연결하면 다음과 같이 됩니다.

- 노트의 인용을 프로젝트의 참고문헌에서 가져올 수 있습니다.
- 노트의 어시스턴트는 프로젝트의 파일을 읽을 수 있고, 프로젝트의 어시스턴트는 노트의 제목과 짧은 요약을 받습니다. 자세한 내용은 [AI와 함께 쓰는 노트](/docs/notes/ai/)에 있습니다.

## 프로젝트의 노트 패널

프로젝트가 열려 있는 상태에서 프로젝트 레일의 **노트**를 선택하거나 명령 팔레트에서 **이 프로젝트의 노트 열기**를 실행하세요. 패널에는 목록이 두 개 있습니다.

- **프로젝트 노트**는 프로젝트의 `notes` 폴더에 있는 파일입니다. 프로젝트를 가진 모든 사람이 갖고 있습니다.
- **내 노트**는 이 프로젝트에 연결된 내 개인 노트입니다. 노트에 남아 있습니다.

![LLaMA 프로젝트의 노트 패널에는 비어 있는 프로젝트 노트 목록이 있고, 내 노트 아래에는 이 컴퓨터에서만 프로젝트에 연결된 개인 노트 네 개가 있습니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/notes-project-panel-dark-window-v2.png#view=0,0,700,580)

두 목록의 노트를 합쳐 여덟 개를 넘으면 목록 위에 검색 필드가 나타납니다.

### 프로젝트의 개인 노트

**내 노트** 옆의 **새 개인 노트**(**+**)를 선택하거나 **이 프로젝트의 새 개인 노트**를 실행하면 프로젝트에 연결된 개인 노트가 시작됩니다. 파일 옆의 탭에서 열립니다. 탭에는 **개인 노트**와 **나만 볼 수 있습니다**가 표시되며, 노트를 공유했다면 **노트에서 공유됨**이 표시됩니다. **노트에서 열기**는 같은 노트를 노트에서 엽니다.

**내 노트** 아래의 각 행에는 노트를 마지막으로 편집한 시점이 표시됩니다. 행 메뉴에는 **프로젝트로 이동**, **노트에서 열기**, **이름 바꾸기**, **이 프로젝트와 연결 해제**, **휴지통으로 이동**이 있습니다. 노트의 연결을 해제하면 메시지에 **실행 취소**가 나타납니다.

## 프로젝트 노트

프로젝트 노트는 프로젝트의 `notes/<Title>.md`에 있는 Markdown 파일입니다. 프런트 매터에 `kind: note`가 있으며, 이것이 Oleafly가 이 파일을 노트로 여는 이유입니다. `notes`에 있는 Markdown 파일에 이 줄이 없으면 **프로젝트 노트**에 나열되지 않으며 다른 Markdown 파일처럼 열립니다.

### 프로젝트 노트 만들기

1. 프로젝트 레일의 **노트**를 선택합니다.
2. **프로젝트 노트** 옆의 **새 프로젝트 노트**(**+**)를 선택합니다. Oleafly가 `notes/Untitled.md`를 만들고 엽니다.
3. 목록에 나타난 필드에 제목을 입력하고 Enter를 누릅니다. Oleafly가 파일 이름을 `notes/<Title>.md`로 바꿉니다.

제목을 입력하지 않고 필드를 벗어나면 노트는 제목 없음으로 남습니다. 명령 팔레트의 **새 프로젝트 노트**도 제목 없는 노트를 시작합니다. 노트 맨 위에 제목을 입력하세요.

파일 이름은 제목을 따릅니다.

- `/`, `\`, `:`, `*`, `?`, `"`, `<`, `>`, `|`처럼 일부 시스템이 파일 이름에 허용하지 않는 문자는 공백이 됩니다.
- 이름은 80자에서 끊깁니다.
- `CON`이나 `AUX`처럼 Windows가 예약해 둔 이름에는 `notes/CON note.md`처럼 "note"가 붙습니다.
- 이름이 이미 쓰이고 있으면 Oleafly가 `notes/Methods-2.md`처럼 번호를 붙입니다.

### 열기와 편집

**프로젝트 노트** 아래에서 노트를 선택하거나, 파일 트리의 `notes` 폴더에서 파일을 여세요. **프로젝트 노트**와 **이 프로젝트의 파일과 함께 저장됩니다**가 표시된 탭에서 열립니다.

- **Markdown으로 편집**은 파일의 소스를 보여 줍니다. "이 노트를 Markdown으로 편집하고 있습니다." 배너에서 **노트로 편집**을 선택하면 되돌아갑니다. 탭을 마우스 오른쪽 버튼으로 클릭해도 같은 전환이 있습니다.
- **내 노트로 복사**는 그 노트에서 프로젝트에 연결된 개인 노트를, 노트가 쓰는 이미지와 파일과 함께 만듭니다. 사본은 별개의 노트입니다.

목록은 디스크의 폴더를 따르므로 다른 프로그램이 노트 파일을 추가, 변경, 제거하면 **프로젝트 노트**가 갱신됩니다. 폴더에서 Markdown 파일을 최대 200개까지 읽으며, 나열하지 못한 파일이 몇 개인지 알려 줍니다.

노트를 끄면 파일은 프로젝트에 남아 일반 Markdown으로 열립니다.

### 이름 바꾸기

행 메뉴에서 **이름 바꾸기**를 선택하거나 노트 맨 위의 제목을 바꾸세요. Oleafly가 프런트 매터의 제목을 갱신하고 파일 이름도 맞춰 바꾸므로, Draft를 Results로 바꾸면 `notes/Draft.md`가 `notes/Results.md`가 됩니다. 다른 파일이 이미 그 이름이면 새 이름에 번호가 붙습니다.

Oleafly는 먼저 열려 있는 노트를 저장합니다. 그중 하나라도 저장하지 못하면 아무것도 이름이 바뀌지 않으며 "저장하지 않은 변경 사항이 있는 노트가 있어 노트 이름을 바꾸지 않았습니다. 저장한 뒤 다시 시도하세요."라는 메시지가 나타납니다.

### 삭제

노트의 행 메뉴 마지막 항목이 노트를 제거합니다. 항목의 이름과 동작은 프로젝트가 있는 위치에 따라 다릅니다.

- 라이브러리의 프로젝트에서는 **삭제**가 파일을 제거합니다. 되돌릴 수 없습니다.
- [그 자리에서 연 폴더](/docs/library/#folders-opened-in-place)에서는 macOS와 Linux의 **휴지통으로 이동**, 또는 Windows의 **휴지통으로 이동**이 파일을 휴지통으로 옮기며, 거기서 복원할 수 있습니다.

### 개인 노트를 프로젝트로 옮기기

1. 프로젝트에서 개인 노트를 열고 **프로젝트로 이동**을 선택합니다. **내 노트** 아래의 노트 행 메뉴와 탭의 오른쪽 클릭 메뉴에도 있습니다.
2. 대화 상자가 프로젝트의 모든 사람이 노트를 보고 편집할 수 있게 된다고 경고합니다. **프로젝트로 이동**을 선택합니다.

Oleafly는 노트를 `notes/<Title>.md`에 쓰고, 노트가 쓰는 이미지와 파일을 `notes/assets`로 복사한 뒤 엽니다. 내 개인 사본은 **설정 → 데이터 저장**의 [휴지통](/docs/settings/storage/#recycle-bin)으로 갑니다. `notes/assets`에 이름이 같은 다른 파일이 이미 있으면 사본에 번호가 붙고 노트의 링크가 그것을 가리킵니다.

## 공유 프로젝트의 프로젝트 노트

[프로젝트를 공유](/docs/collaboration/sharing/)하면 `notes` 폴더도 다른 폴더처럼 함께 가고, 개인 노트는 내게 남습니다. 노트가 켜져 있으면 **공유** 대화 상자가 이를 알려 줍니다. "프로젝트의 노트는 이 프로젝트에 참여한 모든 사람과 공유됩니다. 개인 노트는 비공개로 유지됩니다." 폴더에 노트가 없을 때는 "개인 노트는 비공개로 유지됩니다. 프로젝트의 노트 폴더에 있는 노트만 공유됩니다."라고 표시됩니다.

공유 프로젝트에서는 다음과 같이 됩니다.

- **노트** 패널에 "프로젝트 노트는 이 프로젝트에 참여한 모든 사람과 공유됩니다. 개인 노트는 비공개로 유지됩니다."라고 표시됩니다.
- 프로젝트 노트의 탭에 **이 프로젝트의 모든 사람이 보고 편집할 수 있습니다**라고 표시됩니다.
- 프로젝트 노트는 입력하는 대로 함께 씁니다. 노트에 각 사람의 커서와 이름이 표시됩니다.
- 프로젝트 노트는 소유자와 편집자만 바꿀 수 있습니다. 다른 사람은 읽을 수만 있으며, 노트에 "이 노트를 읽을 수는 있지만 편집할 수는 없습니다."라고 표시됩니다.

## 다른 사람과 함께 노트 쓰기

프로젝트 없이도 공동 작업 서버를 통해 개인 노트 하나만 따로 공유할 수 있습니다. 서버에 계정이 있어야 합니다. 서버를 추가하고 로그인하는 방법은 [실시간 공동 작업 시작하기](/docs/collaboration/get-started/)에 나와 있습니다.

### 노트 공유하기

1. 노트에서 노트를 열고 헤더의 **공유**를 선택합니다. **공유**는 노트 사이드바의 노트 메뉴에도 있습니다.
2. **참여자** 탭에서 **서버**를 고릅니다.
3. 요약을 확인합니다. 노트의 **파일**과 **크기**가 표시되고, 그것을 읽을 수 있는 서버의 이름이 나옵니다.
4. **공유**를 선택합니다.

노트의 이미지와 다른 파일은 함께 공유됩니다. Oleafly 설정과 Git 기록은 공유되지 않습니다. 이어서 같은 탭에 **접근 권한이 있는 사람**이 표시됩니다. 프로젝트와 같은 방식으로 사람을 추가하고 역할을 고르세요. [사람 추가하기](/docs/collaboration/sharing/#add-people)를 참고하세요. 공유된 노트에는 사이드바와 노트 홈에 **공유됨** 표시가 붙습니다.

공유 프로젝트의 프로젝트 노트와 마찬가지로 소유자와 편집자만 노트에 쓸 수 있습니다. 검토자, 댓글 작성자, 뷰어는 노트를 읽을 수 있으며 어시스턴트도 이들을 대신해 노트를 바꿀 수 없습니다.

공유를 끝내려면 소유자가 같은 탭에서 **공유 중지**를 선택하고, 다른 사람은 **프로젝트 나가기**를 선택합니다. 소유자가 공유를 중지하면 모두 노트의 사본을 그대로 갖지만 더 이상 동기화되지 않습니다. 내가 나가면 내 사본은 이 컴퓨터에 남고 동기화가 멈춥니다. [공유 중지](/docs/collaboration/sharing/#stop-sharing)와 [프로젝트에서 나가기](/docs/collaboration/sharing/#leave-a-project)를 참고하세요.

### 공동 작업자에게 필요한 것

- 같은 서버의 계정, 그리고 Oleafly에 로그인한 상태.
- 노트가 켜져 있을 것.

노트는 공유 프로젝트처럼 공동 작업자의 라이브러리에서 **나와 공유된 프로젝트** 아래에 나타납니다. **열기**를 선택하면 노트를 다운로드해 노트에서 엽니다. 목록과 링크는 [나와 공유된 프로젝트 열기](/docs/collaboration/get-started/#open-a-project-shared-with-you)에서 설명합니다.

### 함께 편집하기

다른 사람이 나와 함께 노트에 있는 동안에는 다음과 같이 됩니다.

- 노트 헤더에 그들의 아바타가 놓입니다. 아바타 위에 포인터를 올리면 그 사람의 이름, 역할, **편집**과 노트의 제목 같은 하고 있는 일이 표시됩니다. 아바타를 선택하면 그 사람이 있는 블록으로 스크롤합니다.
- 각 사람의 커서가 그 사람의 색과 이름으로 표시됩니다. 누군가 있는 블록은 왼쪽 여백의 색 막대로 표시됩니다. 막대 위에 포인터를 올리면 누구인지 나옵니다.
- 아바타 옆의 동기화 상태는 내 변경 사항이 모두에게 전달되었는지를 **최신 상태**나 **동기화 중**처럼 알려 줍니다. 모든 상태는 [동기화 상태](/docs/collaboration/working-together/#the-sync-status)에 나열되어 있습니다.

실시간으로 편집되는 공유 노트는 한 번에 하나입니다. 첫 번째 노트가 화면에 열려 있는 동안 다른 공유 노트로 이동하면, 두 번째 노트에 "다른 노트에서 실시간 편집이 켜져 있습니다"라고 표시됩니다. **여기서 실시간 편집**을 선택하면 실시간 편집이 그 노트로 옮겨 갑니다.

### 변경 사항이 전송되지 않을 때

Oleafly가 마지막 변경 사항을 보내지 못하면 노트 위의 알림이 알려 줍니다.

- "지금은 이 노트를 보기만 할 수 있어서 마지막 변경 사항을 보내지 않았습니다."
- "Oleafly가 이 노트의 마지막 변경 사항을 보내지 못해 해당 변경 사항이 삭제되었습니다."

알림을 닫으려면 **×**를 선택하세요.

### 연결이 없을 때

연결이 끊어져도 계속 쓰세요. 노트는 내 컴퓨터에 저장되며, Oleafly가 저절로 다시 연결해 변경 사항을 보냅니다. 변경 사항이 대기하는 동안 동기화 상태에 **오프라인. 대기 중인 변경 사항:**과 숫자가 표시됩니다. 다시 연결하고 병합하는 방식은 [오프라인과 다시 연결](/docs/collaboration/offline/)에서 설명합니다.

## 읽기 전용 사본 게시하기

같은 대화 상자의 **게시** 탭은 노트의 읽기 전용 사본을 공개 링크에 올립니다. 링크가 있는 사람은 누구나 로그인하지 않고 읽을 수 있습니다. 먼저 노트를 누구와 공유할 필요는 없습니다.

1. 노트에서 노트를 열고 **공유**를 선택한 다음 **게시**를 선택합니다.
2. **서버**를 고릅니다.
3. **게시**를 선택합니다. 탭에 **링크 복사**와 **열기**가 있는 **공개 링크**가 표시됩니다.

페이지에는 이미지, 차트, 다이어그램, 수식, Typst, 분자가 포함됩니다. HTML, React, CSV, 서열, 노트북 블록은 빠집니다.

페이지는 노트를 따라가지 않습니다. 노트를 바꾼 뒤에는 탭에 "마지막으로 게시한 뒤 이 노트를 바꿨습니다. 페이지를 업데이트하려면 다시 게시하세요."라고 표시됩니다. 갱신하려면 **다시 게시**를 선택하세요. **게시 취소**는 링크를 즉시 중단하지만, 페이지 사본을 저장한 사람은 그대로 갖고 있습니다. **설정 → 공동 작업**의 각 서버 카드에 있는 **게시된 노트**에는 그 서버에 게시한 노트가 나열됩니다.

몇 가지 제한이 있습니다.

- 노트의 소유자만 게시할 수 있습니다.
- 서버의 관리자가 관리 콘솔 설정에서 **노트 공개 링크 허용**을 켜야 합니다. 기본으로는 꺼져 있습니다.
- 관리자가 게시된 페이지를 내릴 수 있습니다. 다시 올려 주기 전까지는 독자가 열 수 없고 나도 다시 게시할 수 없습니다. 게시 취소는 계속 할 수 있습니다.
