> ## 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.

# Tích hợp Zotero

> Cho phép người dùng nhập một tệp .bib từ thư viện Zotero của họ vào một dự án.

> [!NOTE]
>
> Tính năng này ban đầu được phát triển bởi [davrot](https://github.com/davrot) và [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), sau đó được [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) chỉnh sửa để hỗ trợ OAuth. Tính năng được giới thiệu từ v6.2.0 trở đi và vẫn đang ở trạng thái beta. Chúng tôi rất cần phản hồi của bạn nếu gặp bất kỳ vấn đề nào.

![](https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/img-b751b9f6.png?fit=max\&auto=format\&n=x9kfDjtWlyyhG_mR\&q=85\&s=80eb902caf484c8cfc1c776017ac2c66)

![](https://mintcdn.com/ayakaleaf-pro/UZ_4Jfz7cU6MnXtE/images/on-premises/image-41.png?fit=max\&auto=format\&n=UZ_4Jfz7cU6MnXtE\&q=85\&s=366c8e9396506163e23ffdc92fbe8c02)

### Thiết lập tích hợp Zotero

1. Mở [liên kết này](https://www.zotero.org/oauth/apps) để tạo một Zotero OAuth client (như hình minh họa)
2. Chọn **Application Type**: **Browser**
3. Thiết lập Callback URL là `${OVERLEAF_SITE_URL}/user/zotero/oauth/callback` của bạn
4. Cấu hình tệp `config/variables.env`

![](https://mintcdn.com/ayakaleaf-pro/UZ_4Jfz7cU6MnXtE/images/on-premises/image-42.png?fit=max\&auto=format\&n=UZ_4Jfz7cU6MnXtE\&q=85\&s=7b2ed79ba28f7d77bc07711068ca71fc)

```dotenv title="config/variables.env" theme={null}
#################
#    Zotero     #
#################
# 'zotero' must be in ENABLED_LINKED_FILE_TYPES (set in develop/docker-compose.yml)
ENABLED_LINKED_FILE_TYPES=project_file,project_output_file,url,zotero

# From a Zotero OAuth client (register at https://www.zotero.org/oauth/apps)
# Application Type: Browser 
# Callback URL -> ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback
ZOTERO_CLIENT_ID=
ZOTERO_CLIENT_SECRET=
# Encrypts the Zotero API key in mongo (set in dev to avoid writing a key file
# to /var/lib/overleaf/data, which the dev web container can't create)
# How to generate: `openssl rand -hex 32`
ZOTERO_CIPHER_PASSWORD=dev-zotero-cipher-password
# Optional: route the module's server-side Zotero requests (OAuth + API) through
# an HTTP proxy (must be reachable from the web container; same as github-sync)
# http://10.0.0.1:10808
# (Optional) ZOTERO_PROXY_URL=
```

### Lưu ý

> [!WARNING]
>
> Khi nâng cấp một bản cài đặt hiện có có các tệp thư mục tham khảo liên kết với Zotero lên bản 6.3.0 được phát hành lại, hãy làm theo [#ayakaleaf-pro-6.3.0](https://ayakaleaf-pro.mintlify.site/vi/on-premises/release-notes/release-notes-6.x.x.md#ayakaleaf-pro-6.3.0 "mention"). Các bản cài đặt mới không cần thực hiện bước di chuyển này.

> [!CAUTION]
>
> Vì Ayakaleaf là một nền tảng cộng tác, để tăng cường bảo mật, bắt đầu từ phiên bản 6.3.0, chỉ người tạo ban đầu của tệp tham khảo `bib` mới được phép cập nhật tệp đã nhập.

Ví dụ, giả sử chủ sở hữu dự án, Người dùng A, bật chia sẻ qua liên kết và tạo tệp `test.bib` trong dự án, liên kết nó với tài khoản Zotero của chính mình. Nếu một người dùng khác, Người dùng B, truy cập dự án thông qua liên kết chia sẻ, Người dùng B vẫn có thể đọc và tải xuống `test.bib`, nhưng sẽ không được phép cập nhật hoặc nhập lại tệp từ Zotero. Chỉ Người dùng A, với tư cách là người tạo ban đầu của tệp tham khảo, mới có thể thực hiện cập nhật. Nói cách khác, chỉ người tạo ban đầu của tệp `.bib` mới có quyền cập nhật nó.

### Hỏi & Đáp

> [accordion] Làm thế nào để sử dụng Zotero trong một dự án?
>
> **Trả lời:** Sau khi liên kết Zotero trong **Account Settings**, hãy mở một dự án và nhấp vào **New file → From Zotero**. Chọn tên tệp, mặc định là `zotero.bib`, và thư viện, sau đó tạo tệp. Trích dẫn các mục của nó như bình thường, ví dụ với `\bibliography{zotero}`.
>
> Tệp này chỉ đọc trong trình soạn thảo. Sau khi thay đổi thư viện Zotero, hãy mở tệp và nhấp vào **Refresh** để nhập lại.

> [accordion] Tại sao “Main bibliography file for this project” trống hoặc bị vô hiệu hóa?
>
> **Trả lời:** Thiết lập này chỉ liệt kê các tệp `.bib` có thể chỉnh sửa trong trình soạn thảo. Các tệp được nhập từ Zotero là chỉ đọc, nên chúng không được liệt kê. Đây là hành vi bình thường: bạn vẫn có thể trích dẫn các mục của chúng.

> [accordion] Phiên bản của tôi có cần truy cập được từ internet không?
>
> **Trả lời:** Không. Việc liên kết Zotero diễn ra thông qua trình duyệt của người dùng, vì vậy chỉ máy chủ cần kết nối được tới Zotero. Nếu cần proxy để làm điều đó, hãy đặt `ZOTERO_PROXY_URL`.


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