# 실시간 공동 작업 시작하기

그룹의 공동 작업 서버를 추가하고, 로그인하고, 다른 사람이 공유한 프로젝트를 열고, 서버와 기기를 관리합니다.

:::note[실시간 공동 작업은 베타입니다]
Oleafly 0.4.7-rc가 필요합니다. 다운로드 페이지는 아직 0.4.6을 제공하므로 [릴리스 페이지](https://github.com/Oleafly/Oleafly/releases/tag/v0.4.7-rc)에서 내려받으세요.
:::

공유 프로젝트에 참여하려면 그룹 서버를 운영하는 사람에게서 두 가지를 받아야 합니다. 서버 주소와 들어갈 방법입니다. 운영자는 이메일 주소, 로그인 이름 또는 기관 도메인으로 나를 추가합니다. 프로젝트 소유자가 나를 게스트로 초대할 수도 있습니다. 공동 저자들이 Oleafly 서버인 `collab.oleafly.com`을 쓴다면 **서버 추가**에 이 서버를 위한 버튼이 있습니다.

서버에서 이메일을 받았다면 그 안에 **Oleafly에 추가** 링크가 있습니다. 링크를 선택하면 Oleafly가 서버를 대신 추가합니다. 그렇지 않으면 직접 추가하세요.

## 서버 추가하기

1. **설정 → 공동 작업**을 열고 **서버 추가**를 선택합니다.
2. 받은 **서버 주소**(예: `collab.example.edu`)를 입력하고 **계속**을 선택합니다. Oleafly는 로그인하기 전에 서버를 확인합니다. 공동 작업 서버의 주소는 https를 사용해야 합니다.
3. 로그인 방법을 고릅니다. 선택지는 서버 관리자가 설정한 내용에 따라 다릅니다.

Oleafly 서버를 추가하려면 대화 상자 맨 위, 주소 입력란 위에 있는 **Oleafly**를 선택하세요. Oleafly가 `https://collab.oleafly.com`을 채우고 서버를 확인한 다음 로그인으로 넘어갑니다. 이 서버가 목록에 들어가면 버튼이 사라지고, 서버를 제거하면 다시 나타납니다.

**공유** 대화 상자에도 같은 바로 가기가 있습니다. 아직 서버를 하나도 추가하지 않았다면 **Oleafly 서버 추가**가 표시됩니다.

## 로그인하기

### 기관 계정이나 GitHub로

**계속하기** 뒤에 원하는 방법이 붙은 버튼을 선택하세요. 예를 들어 **GitHub로 계속하기**나 대학 로그인입니다. 브라우저가 열립니다. 그곳에서 로그인한 뒤 Oleafly로 돌아오세요. Oleafly는 내 비밀번호를 절대 보지 않습니다.

### 이메일 링크로

서버가 제공한다면 **이메일로 계속하기**를 선택하세요. 브라우저에 서버의 페이지가 열립니다.

1. 이메일 주소를 입력하고 **링크를 이메일로 받기**를 선택합니다.
2. 같은 컴퓨터에서 이메일을 열고 **로그인** 버튼을 선택합니다.
3. 열린 페이지에서 **로그인**을 선택합니다. Oleafly가 알아서 이어서 진행합니다.

링크는 15분 동안 한 번만 쓸 수 있습니다. 같은 인증된 주소로 이 서버에 다른 방법으로 이미 로그인했다면, 이 링크는 그 같은 계정으로 로그인시킵니다.

### 코드로

잠겨 있는 연구실 컴퓨터처럼 로그인한 뒤 브라우저가 Oleafly로 돌아오지 못하는 컴퓨터가 있습니다. 그런 곳에서는 **코드로 로그인**을 쓰세요. 브라우저 로그인이 20초 넘게 걸릴 때도 Oleafly가 이 방법을 제안합니다.

1. Oleafly가 서버의 주소 하나와 여덟 글자 코드를 보여 줍니다.
2. 아무 휴대폰이나 컴퓨터에서 그 주소를 열고 코드를 입력한 뒤 **계속**을 선택합니다.
3. 페이지에 요청한 컴퓨터의 이름이 나옵니다. 이름을 확인한 뒤 서버가 제공하는 방법 중 하나로 로그인하세요. 로그인은 Oleafly가 알아서 마칩니다.

코드는 한 번만 쓸 수 있고 10분이 지나면 더 이상 동작하지 않습니다. 내가 시작한 로그인이 아니라면 **중지, 내가 한 것이 아닙니다**를 선택하세요.

### 다 끝나면

Oleafly에 **연결됨** 뒤에 서버 이름이 표시됩니다. **완료**를 선택하세요. 이제 서버가 **설정 → 공동 작업**에 **로그인됨**으로 나타납니다.

서버가 "아직 이 서버의 목록에 없습니다"라고 답하면 관리자에게 추가해 달라고 요청하세요. 다른 로그인 메시지는 [문제 해결](/docs/collaboration/troubleshooting/#sign-in-problems)에서 다룹니다.

## 나와 공유된 프로젝트 열기

나와 공유된 프로젝트는 라이브러리의 내 프로젝트 위쪽 **나와 공유된 프로젝트** 아래에 나타납니다. 각 줄에는 소유자, 서버, 내 역할이 나옵니다. **열기**를 선택하세요. Oleafly가 프로젝트를 내 라이브러리에 복사하고 엽니다.

그다음부터 이 프로젝트는 다른 프로젝트처럼 라이브러리에 있으며 **공유됨** 표시가 붙습니다. 파일은 내 프로젝트 폴더에 있는 실제 파일입니다. 주 문서와 엔진은 프로젝트 전체에 설정되므로 모두에게 같습니다.

### 링크로 프로젝트 열기

다른 사람이 프로젝트 링크를 보내 줄 수도 있습니다.

- **이메일에서** 열면 링크가 Oleafly를 바로 엽니다.
- **다른 곳에서** 받았다면 라이브러리에서 **가져오기**를 열고 **공유 프로젝트 링크 열기…** 를 고른 뒤 링크를 붙여 넣고 **열기**를 선택하세요.

참여하기 전에 Oleafly가 "이 공유 프로젝트에 참여할까요?"라고 묻고 프로젝트, 소유자, 서버, 내 역할을 보여 줍니다. 참여하면 프로젝트 파일이 이 컴퓨터에 복사됩니다. 링크를 누가 보냈는지 알 때만 **참여**를 선택하세요.

링크가 아직 추가하지 않은 서버의 것이라면 먼저 서버를 추가한 다음 링크를 다시 여세요.

## 편집 시작하기

다른 프로젝트에서처럼 입력하세요. 내 변경 사항은 입력하는 대로 다른 사람들에게 전달되고, 그들의 변경 사항도 나에게 전달됩니다. 화면에 보이는 것은 [함께 작업하기](/docs/collaboration/working-together/)에서 설명합니다.

검토자라면 입력한 내용이 제안이 됩니다. 댓글 작성자라면 편집기는 읽기 전용이지만 텍스트를 선택해 댓글을 달 수 있습니다. 뷰어라면 편집기는 읽기 전용이지만 읽기, 컴파일, 내보내기는 할 수 있습니다. 역할별로 할 수 있는 일은 [역할](/docs/collaboration/sharing/#roles)에 나와 있습니다.

서버에 브라우저 접근이 켜져 있다면 Oleafly 없이 웹 브라우저에서 프로젝트를 열 수도 있습니다. [브라우저에서 작업하기](/docs/collaboration/browser/)를 읽어 보세요.

## 다른 사람에게 보이는 정보 고르기

**설정 → 공동 작업**의 **다른 사람에게 보이는 정보**에서 하나를 고르세요.

- **내 커서 표시**: 다른 사람에게 내 커서, 선택 영역, 내가 있는 파일이 보입니다.
- **내가 있는 파일만 표시**: 다른 사람에게 파일은 보이지만 파일 안의 위치는 보이지 않습니다.
- **나를 숨기기**: 다른 사람에게 내 커서도, 내가 있는 파일도 보이지 않습니다.

컴퓨터마다 따로 설정합니다.

## 서버가 둘 이상일 때

예를 들어 연구실용 서버 하나와 다른 대학과 함께하는 프로젝트용 서버 하나처럼 여러 서버를 추가할 수 있습니다. 각 공유 프로젝트는 서버 하나에 있습니다. **나와 공유된 프로젝트**에는 로그인한 모든 서버의 프로젝트가 나열됩니다.

## 내 기기

사용하는 컴퓨터마다 로그인하세요. **설정 → 공동 작업**의 서버 카드에 **내 기기**가 나열되며, 각 기기가 추가된 날짜와 마지막으로 접속한 날짜가 표시됩니다. 더 이상 쓰지 않는 컴퓨터 옆의 **로그아웃**을 선택하세요. 그 컴퓨터는 누군가 다시 로그인할 때까지 동기화를 멈춥니다.

서버에 로그인한 각 웹 브라우저도 이 목록에 있습니다. 브라우저 옆의 **로그아웃**을 선택하면 그 브라우저의 세션이 끝납니다.

서버가 이메일을 보낸다면, 내 계정이 새 컴퓨터에서 로그인할 때 기기 이름, 시스템, 시간을 이메일로 알려 줍니다. 내가 한 로그인이 아니라면 그 기기를 로그아웃하세요.

공용 컴퓨터에서는 사람마다 자기 사용자 계정이 있어야 합니다. 같은 사용자 계정에서 다른 사람이 이미 서버에 로그인했다면 Oleafly는 두 번째 사람을 로그인시키지 않습니다.

## 서버에서 오는 이메일

누군가 나를 프로젝트에 추가하면 서버가 프로젝트 제목, 공유한 사람, 내 역할, 프로젝트를 여는 링크를 이메일로 보낼 수 있습니다. 이 이메일을 받지 않으려면 서버 카드에서 **누군가 프로젝트를 공유하면 이메일 받기**를 끄세요. 나와 공유된 프로젝트는 그래도 **나와 공유된 프로젝트**에 나타납니다.

누군가 댓글에서 나를 언급하면 서버가 이메일로 알려 줍니다. [다른 사람 언급하기](/docs/collaboration/comments/#mention-someone)를 읽어 보세요.

서버가 이메일을 보내지 않으면 이런 메시지는 받지 않습니다. 나머지는 모두 똑같이 동작합니다.

## 로그아웃하기

서버 카드에서 **로그아웃**을 선택하세요. Oleafly는 먼저 몇 초 동안 서버에 아직 없는 변경 사항을 보내려고 시도합니다.

아직 보내지 못한 변경 사항이 남아 있으면 Oleafly가 어떻게 할지 묻습니다.

- **로컬 사본 유지**는 그런 프로젝트를 각각 내 변경 사항이 담긴 "*프로젝트* (로컬 사본)"이라는 이름의 공유되지 않은 일반 프로젝트로 이 컴퓨터에 남깁니다. 그다음 로그아웃합니다.
- **로그인 유지**는 로그인 상태를 유지하므로, 다시 온라인이 되면 다시 시도할 수 있습니다.

서버 카드의 **제거**는 로그아웃한 뒤 서버를 잊습니다. 보내지 못한 변경 사항에 대해서도 같은 질문을 합니다. 이미 이 컴퓨터에 있는 프로젝트는 그대로 남습니다.
