> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Zotero 통합

> Zotero 계정을 연결하고, 라이브러리를 .bib 파일로 가져와 인용하고, 새로 고치고, 연결을 해제합니다.

Zotero 라이브러리를 `.bib` 파일로 프로젝트에 가져온 다음 평소처럼 인용합니다. 이 파일은 사본입니다. **Refresh**를 클릭할 때만 바뀝니다.

> [!NOTE]
>
> **Account settings**에 Zotero 옵션이 보이지 않으면 관리자에게 [Zotero 통합](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/overleaf-toolkit/integrations/zotero-integration.md)을 켜 달라고 요청하세요.

## Zotero 계정 연결

이 작업은 한 번만 합니다.

**1. 계정 설정 열기**

**Account**를 클릭한 다음 **Account settings**를 클릭합니다. **Reference managers**에서 **Zotero**를 찾아 **Link to Zotero**를 클릭합니다.

![Link to Zotero 버튼이 있는 계정 설정의 Zotero 섹션](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-link.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=bd8103eadfb8c79e5d2f58a83a5ac33e)

계정 설정의 Zotero

편집기의 **Integrations** 패널에 있는 **Zotero** 카드도 같은 탭에서 같은 곳으로 이동합니다.

![Zotero 카드가 있는 Integrations 패널](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-integrations.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=ee6c0da4ffd26db23956a92eebf60765)

Integrations 패널

**2. Zotero에서 승인**

Zotero가 열립니다. 요청되면 로그인한 다음 애플리케이션을 승인합니다. 라이브러리와 그룹 읽기 권한만 요청하므로 Zotero에서 아무것도 변경할 수 없습니다.

**3. 연결 확인**

계정 설정으로 돌아옵니다. 녹색 메시지에 **Reference manager linked**가 표시되고 버튼이 **Unlink**로 바뀝니다.

![녹색 메시지와 Unlink 버튼이 있는 계정 설정의 Zotero 섹션](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-linked.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=185a0e5c172d3a5f6a9e50a325f32cf3)

Zotero 계정이 연결됨

Zotero에서 액세스를 허용하지 않으면 같은 섹션에 **Sorry, something went wrong**이 표시됩니다. **Link to Zotero**를 클릭해 다시 시도하세요.

## 라이브러리에서 파일 만들기

**1. Add files 대화 상자 열기**

프로젝트를 엽니다. 파일 트리에서 **New file**을 클릭한 다음 **From Zotero**를 클릭합니다. 이 항목은 계정이 연결된 후에만 나타납니다.

**2. 파일 이름과 라이브러리 선택**

**File Name**의 기본값은 `zotero.bib`입니다. `.bib` 확장자를 유지하세요. 확장자가 없으면 미리 보기가 표시되지 않고 `\cite`와 `\bibliography` 모두 항목을 찾지 못합니다.

**Library**의 기본값은 **My Library**이며 그룹 라이브러리도 함께 나열됩니다. 파일 하나에 라이브러리 하나가 들어갑니다.

![zotero.bib와 My Library가 지정된 Add files 대화 상자의 From Zotero 탭](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-new-file.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=707728eb955b49101ab3977d1b19baa6)

개인 라이브러리에서 만든 파일

**3. Create 클릭**

대화 상자가 닫히고 파일이 파일 트리에 나타납니다. 파일을 클릭하면 가져온 시각과 항목이 표시됩니다. 편집기에서 수정할 수는 없습니다.

![Refresh 버튼과 함께 편집기에 열린 가져온 zotero.bib](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-file.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=b2d3560f942619fcc479ea875e7f7957)

가져온 파일

**Create**를 눌러도 아무 일도 일어나지 않는 것 같다면 같은 이름의 파일이 이미 있는 것입니다. 다른 이름을 선택하세요.

### 그룹 라이브러리 가져오기

별도의 파일 이름으로 같은 작업을 반복하고 **Library**에서 그룹을 선택합니다. 한 프로젝트에 이런 파일을 여러 개 둘 수 있습니다.

![파일 이름 reading-group.bib와 라이브러리 Reading group이 지정된 From Zotero 탭](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-group.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=a5cb43fdf5d97546eb1609160147aeee)

그룹 라이브러리에서 만든 파일

## 파일에서 인용하기

**1. 인용 시작**

`.tex` 파일에서 `\cite{`를 입력합니다. 목록에 프로젝트의 모든 `.bib` 파일 항목이 표시됩니다. 하나를 클릭하면 삽입됩니다.

![인용 아래에 인용 키를 나열하는 편집기](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-cite.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=394bda9a2a326e5d878fc16932ec0322)

가져온 파일의 항목

**2. 또는 제목이나 저자로 검색**

목록 아래의 **Search**를 클릭하거나 중괄호 안에서 Ctrl+Space를 누릅니다. 입력해서 필터링하고 하나 이상의 항목을 클릭한 다음 **Insert**를 클릭합니다.

![항목 하나가 선택된 Search the .bib files in this project 대화 상자](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-search.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=027a2212a2b3cb83b7017014fe40ce22)

참고문헌 검색

**3. 참고문헌 목록 추가**

`\end{document}` 앞에 다음 줄을 추가합니다. 파일 이름은 `.bib`를 빼고 쉼표로 구분합니다.

```latex theme={null}
\bibliographystyle{plain}
\bibliography{reading-group,zotero}
```

**Recompile**을 클릭합니다. 참고문헌이 PDF에 나타납니다.

![인용과 참고문헌 목록이 있는 편집기, 그리고 참고문헌이 있는 컴파일된 PDF](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-compiled.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=9c593d72f5d12495dc4ec2863dd0546d)

컴파일된 참고문헌

가져온 파일은 **Settings**의 **References**, **Main bibliography file for this project**에 표시되지 않습니다. 따라서 프로젝트에 다른 `.bib` 파일이 없으면 이 목록은 비어 있습니다. 그래도 가져온 파일에서 인용할 수 있습니다.

![비어 있고 비활성화된 목록이 있는 프로젝트 설정의 References 탭](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-settings-references.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=48dad4818c2dac63afc46decea21790f)

목록이 비어 있는 것이 정상입니다

## 파일 새로 고침

Zotero 라이브러리의 변경 사항은 프로젝트에 자동으로 반영되지 않으며, 컴파일해도 가져오지 않습니다.

**1. 파일 열기**

파일 트리에서 가져온 파일을 클릭합니다.

**2. Refresh 클릭**

만들 때 선택한 라이브러리에서 파일 전체를 다시 가져옵니다. 새 항목이 나타나고 삭제된 항목은 사라집니다. 위쪽의 시각이 바뀝니다.

![새 항목과 새 가져오기 시각이 있는 새로 고친 zotero.bib](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-refresh.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=aa095ac91264ef0e4517a860fb94b5c9)

새로 고친 파일

**3. 다시 컴파일**

새 항목은 바로 `\cite{` 목록에 나타납니다. **Recompile**을 클릭해 PDF를 업데이트합니다.

각 파일은 따로 새로 고쳐집니다. 그룹 파일은 별도로 새로 고치세요. 공유 프로젝트에서 누가 파일을 새로 고칠 수 있는지는 [관리자를 위한 참고 사항](https://ayakaleaf-pro.mintlify.site/on-premises/configuration/overleaf-toolkit/integrations/zotero-integration.md#notes)을 참고하세요.

## Zotero 계정 연결 해제

**Account settings**의 **Zotero**에서 **Unlink**를 클릭하고, 대화 상자에서 다시 **Unlink**를 클릭합니다. 버튼이 다시 **Link to Zotero**로 바뀝니다.

![Unlink Zotero Account 대화 상자](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-unlink.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=3783d8622dee66277c2420154294220e)

계정 연결 해제

가져온 파일은 프로젝트에 남아 있고 계속 컴파일됩니다. **Add files** 대화 상자에서 **From Zotero**가 사라지고, 계정을 다시 연결할 때까지 **Refresh**는 오류를 표시합니다.

![Could not load references from Zotero, please re-link your account and try again 오류가 표시된 가져온 파일](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-relink-error.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=d0c678b299fa6604d857398aad9bca18)

연결된 계정 없이 새로 고침

다시 연결하면 같은 파일에서 **Refresh**가 작동합니다.

## 문제가 생기면

**Add files** 대화 상자에 **Could not load references from Zotero, please re-link your account and try again** 또는 **There was an error accessing your Zotero data**가 표시되는 경우: 예를 들어 Zotero에서 액세스 권한을 제거해서 Overleaf가 더 이상 라이브러리를 읽을 수 없는 상태입니다. **Account settings**에서 **Unlink**를 클릭한 다음 **Link to Zotero**를 클릭하세요. 그때까지는 **Create**도 실패하며, 자신의 프로젝트에서도 **The project that contains this file is not shared with you** 메시지가 표시됩니다.

![두 오류 메시지가 모두 표시된 From Zotero 탭](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-access-error.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=65bee2963ce16aec585fb55945e6554d)

Overleaf가 더 이상 라이브러리를 읽을 수 없음

**Refresh**를 클릭했을 때 **The remote service produced an error**가 표시되는 경우: Zotero에 대한 요청이 실패했습니다. 파일 내용은 그대로 유지됩니다. 나중에 다시 **Refresh**를 클릭하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.