# Trích dẫn và tài liệu tham khảo

Tìm một nguồn, xem siêu dữ liệu của nó, thêm vào đúng danh mục tài liệu tham khảo, trích dẫn ngay tại con trỏ, chọn kiểu trích dẫn Typst, và dọn dẹp thư viện mà không làm mất bản gốc.

Một trích dẫn là một chuỗi: luận điểm trỏ đến một khóa, khóa trỏ đến một mục trong danh mục tài liệu tham khảo, và mục đó trỏ đến một nguồn thật. Oleafly giữ chuỗi này luôn hiển thị để một lần tra cứu nhanh không biến thành một tham chiếu khó hiểu về sau.

![Panel References của Oleafly. Chuyển giữa References, Citations và Symbols; lọc chế độ xem hiện tại từ ô tìm kiếm.](https://cdn.oleafly.com/images/screenshots/desktop/docs/references-panel-dark-window-v2.png#view=0,45,344,703)

## Trích dẫn trong khi viết

![Cite from project mở bộ chọn tài liệu tham khảo. Tìm theo khóa, tác giả hoặc tiêu đề; Find and add a new citation mở tra cứu trực tuyến.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-citation-picker-dark-window-v2.png#view=415,77,365,467)

Trong thanh công cụ LaTeX hoặc Typst, hãy chọn **Cite from project** (biểu tượng `@`). Tìm trong danh mục tài liệu hiện tại theo khóa, tác giả hoặc tiêu đề rồi chọn một mục.

Bạn cũng có thể chạy **Add citation** từ bảng lệnh ⌘K hoặc Ctrl+K. Oleafly chèn cú pháp phù hợp với dự án đang mở:

- `\cite{key}` trong LaTeX;
- `@key` trong Typst, đồng thời thêm dòng `#bibliography(...)` vào cuối tài liệu chính nếu tài liệu chưa có;
- `[@key]` trong Markdown, đồng thời thêm dòng `bibliography:` vào phần front matter khi cần.

Khi đã kết nối Zotero, **Add citation** hiển thị trước các kết quả trùng khớp từ thư viện Zotero của bạn.

## Trích dẫn từ thư viện Zotero của bạn

Sau khi [kết nối Zotero](/docs/integrations/research-sources/#zotero), hãy gõ `@` cùng một phần tên tác giả, một từ trong tiêu đề, một năm, hoặc một khóa. Toàn bộ thư viện Zotero của bạn xuất hiện bên cạnh các tài liệu tham khảo riêng của dự án. Chọn một bài báo và Oleafly chèn trích dẫn theo đúng cách tài liệu vẫn trích dẫn. LaTeX nhận lệnh mà tài liệu dùng nhiều nhất, chẳng hạn `\citep` hoặc `\parencite`, Typst nhận `@key`, và Markdown nhận `[@key]`. Gõ `@` bên trong một `\cite{...}` sẵn có sẽ thêm một khóa nữa vào đó.

Duy nhất mục đó được thêm vào `.bib` của dự án, ở cuối tệp, và phần còn lại của tệp được giữ nguyên. Một bài báo đã có trong `.bib`, theo khóa hoặc DOI của nó, sẽ không bao giờ được thêm hai lần. Các mục không bao giờ chứa đường dẫn đến các PDF trên máy của bạn. Nếu dự án chưa có dòng khai báo bibliography, Oleafly sẽ thêm một dòng: `\bibliography` hoặc `\addbibresource` trong LaTeX, `#bibliography` trong Typst, hoặc `bibliography:` trong phần front matter của Markdown. Khi dự án có nhiều hơn một tệp `.bib`, Oleafly hỏi một lần xem tệp nào nhận tài liệu tham khảo mới và ghi nhớ câu trả lời của bạn.

Lần đầu bạn trích dẫn từ Zotero trong một bài báo LaTeX liệt kê tài liệu tham khảo thủ công trong môi trường `thebibliography`, Oleafly đề xuất chuyển danh sách đó vào `.bib`. Sau đó mọi tài liệu tham khảo dùng chung một danh sách đánh số.

### Giữ .bib đồng bộ với Zotero

Một khóa đã trích dẫn mà thiếu trong `.bib` nhưng có trong Zotero sẽ đi kèm tùy chọn **Add from Zotero**. Chạy **Add missing citations from Zotero** từ bảng lệnh ⌘K để kiểm tra mọi khóa đã trích dẫn cùng một lúc. Nó thêm những khóa Zotero có, liệt kê những khóa Zotero không có, và chỉ ra các khóa trỏ đến một bài báo đã có trong tài liệu tham khảo của bạn.

Khi một bài báo thay đổi trong Zotero, mục `.bib` tương ứng sẽ có tùy chọn **Update from Zotero**. **Update .bib entries from Zotero** trong bảng lệnh xem lại mọi mục đã thay đổi. Một mục bạn đã sửa thủ công chỉ được thay thế sau khi bạn xác nhận. **Sync Zotero library** đọc lại thư viện. Oleafly không bao giờ tự ý xóa bất cứ thứ gì khỏi `.bib`.

![Một phần tiêu đề bài báo được dán vào, và mục BibTeX của nó được lưu vào refs.bib.](https://cdn.oleafly.com/images/gifs/desktop/add-citation.gif?v=2)

## Tìm và thêm một tài liệu tham khảo mới

Chọn **Find and add a new citation** từ bộ chọn. Bắt đầu với bất kỳ mục nào sau đây:

- một DOI chẳng hạn `10.1145/3592979`;
- một arXiv ID chẳng hạn `1706.03762`;
- một ISBN-10 hoặc ISBN-13;
- một PubMed ID (PMID);
- một URL chứa một trong các định danh đó;
- một tiêu đề bài báo.

Tra cứu DOI, arXiv, ISBN và PubMed dùng các danh mục công khai của chúng. Tìm theo tiêu đề trả về các kết quả khả dĩ kèm tác giả, năm và nơi công bố để bạn tự chọn thay vì chấp nhận một phỏng đoán.

Xem lại BibTeX trả về, rồi chọn **Add to .bib and cite**. Oleafly sẽ:

1. thêm một khóa không trùng vào danh mục tài liệu đang dùng;
2. dùng lại mục sẵn có khi DOI đã tồn tại;
3. chèn trích dẫn tại vị trí con trỏ hiện tại;
4. làm mới cây tệp và panel References ngay lập tức.

Siêu dữ liệu có thể chỉnh sửa được. Hãy sửa bản ghi trước khi nó trở thành một phần của bản thảo.

Khi tài liệu khai báo nhiều hơn một danh mục tài liệu, hộp thoại hiển thị menu **Bibliography**. Mục sẽ vào tệp bạn chọn, và Oleafly ghi nhớ lựa chọn đó cho dự án này.

## Oleafly chọn danh mục tài liệu như thế nào

Các dự án LaTeX theo các khai báo trong tài liệu chính có hiệu lực:

- `\addbibresource{references.bib}` cho `biblatex`;
- `\bibliography{references}` cho quy trình BibTeX.

Đường dẫn được phân giải với cùng hành vi phần mở rộng và đường dẫn tương đối mà bộ công cụ TeX yêu cầu. Một khai báo trỏ đến tệp còn thiếu sẽ được báo tại đúng dòng nguồn đó, thay vì âm thầm ghi sang nơi khác.

Các dự án Typst theo lệnh gọi `#bibliography(...)`, dù lệnh nêu một tệp hay một danh sách, và dù các tệp là BibTeX `.bib` hay Hayagriva `.yml` và `.yaml`. Một trích dẫn mới được ghi vào tệp mà tài liệu khai báo. Nếu tệp đó là Hayagriva, Oleafly chuyển đổi mục BibTeX trước khi ghi. Khi lệnh gọi nêu nhiều hơn một tệp, hãy chọn đích trong menu **Bibliography** của hộp thoại.

Các dự án Markdown theo trường `bibliography:` trong phần front matter.

Khi không có danh mục tài liệu nào được khai báo, Oleafly dùng tệp `.bib` đầu tiên trong dự án. Nếu không có tệp nào, Oleafly tạo `references.bib` và đưa tệp này vào cây tệp và bộ chọn trích dẫn.

Với một dự án có nhiều thư viện, hãy xem xét đích được chọn trước khi thêm một bản ghi.

## Chọn kiểu trích dẫn Typst

Khi tài liệu Typst có lệnh gọi `#bibliography(...)`, cuối chế độ xem **Citations** của panel References hiển thị menu **Citation style**. Menu liệt kê các kiểu dựng sẵn của Typst cho phiên bản Typst của dự án, cùng mọi tệp `.csl` trong dự án. Chọn một kiểu sẽ ghi nó vào đối số `style:` của lệnh gọi đó. Nếu không có, Typst dùng `ieee`.

Với LaTeX, hãy đặt kiểu ngay trong mã nguồn. `\bibliographystyle{` gợi ý hoàn thành các kiểu BibTeX thông thường; với `biblatex`, hãy dùng tùy chọn `style=` của nó.

## Nhập toàn bộ thư viện tài liệu tham khảo

Trong panel References, chọn **Import reference library**. Bạn có thể nhập từ một tệp hoặc từ thư viện Zotero của mình.

**From a file**, hãy chọn một thư viện đã xuất:

| Định dạng nguồn | Tệp |
| --- | --- |
| BibTeX | `.bib` |
| RIS | `.ris` |
| EndNote XML | `.xml` |
| Zotero RDF | `.rdf` |

**From Zotero**, hãy kết nối tài khoản zotero.org của bạn một lần trong **Settings → Integrations → Zotero**, rồi chọn **Import Zotero library** trên thẻ Zotero. Oleafly nhập tối đa 5.000 mục. Trang [Kết nối nguồn nghiên cứu](/docs/integrations/research-sources/#zotero) hướng dẫn từng bước.

Oleafly ánh xạ các bản ghi sang BibTeX và bỏ qua tài liệu tham khảo nào có DOI đã nằm trong thư viện đích hoặc xuất hiện trước đó trong cùng một đợt. Oleafly tạo các khóa không trùng và ghi nối kết quả trong một lần ghi. Thông báo cho biết bao nhiêu tài liệu tham khảo đã thêm và bao nhiêu đã có sẵn. Việc nhập thư viện không chèn trích dẫn tại con trỏ.

Sau khi nhập, hãy tìm các mục mới trong bộ chọn trích dẫn và kiểm tra một mẫu đối chiếu với danh mục gốc.

## Dọn dẹp thư viện tài liệu tham khảo

Panel References có thể xem trước một lượt dọn dẹp trước khi thay đổi các tệp.

1. Mở dự án và chọn **Clean reference library** trong panel References.
2. Chọn tệp `.bib` khi dự án có nhiều hơn một tệp.
3. Đọc danh sách hành động và diff trước/sau.
4. Kiểm tra từng lần đổi khóa được đề xuất, từng bản trùng DOI bị xóa, và từng cảnh báo.
5. Chỉ áp dụng khi phần xem trước đúng ý bạn.

Bộ dọn đổi tên các khóa theo một quy tắc tác giả-năm-tiêu đề nhất quán và cập nhật các trích dẫn trên toàn bộ tệp nguồn của dự án. Nó chỉ xóa một bản trùng DOI khi mục được giữ lại bảo toàn mọi trường của mục bị xóa. Các bản ghi DOI xung đột và các tiêu đề tương tự được đánh dấu để xem lại, không bị gộp theo phỏng đoán.

Chú thích và các định nghĩa chuỗi BibTeX được giữ nguyên. Khi áp dụng, Oleafly kiểm tra thư viện vẫn khớp với phần xem trước và ghi một bản sao lưu trước khi thay đổi các tệp. Diff lớn hiển thị 500 dòng đầu trong phần xem trước; các tệp đầy đủ vẫn được dùng khi áp dụng các thay đổi.

:::caution[Xem lại trước khi áp dụng]
Hai lần xuất bản, các bản dịch, bản preprint và bản tạp chí, hoặc các bài báo có tiêu đề tương tự có thể được cố ý tách riêng. Hãy đọc cảnh báo và so sánh các nguồn thật trước khi tự tay gộp bất cứ thứ gì.
:::

## Hoàn tất và di chuyển giữa các tài liệu tham khảo

Bên trong các lệnh trích dẫn LaTeX như `\cite{}`, `\citep{}`, `\citet{}`, `\parencite{}` và `\textcite{}`, tính năng tự động hoàn thành tìm kiếm mọi tệp `.bib` của dự án. Trong Typst, `@` hoàn thành khóa từ cả tệp `.bib` lẫn tệp Hayagriva. Khi đã kết nối Zotero, danh sách còn bao gồm thư viện Zotero của bạn.

Một trích dẫn đến mục vừa được thêm vào `.bib` trong khi tệp đó chưa mở, chẳng hạn bởi trợ lý hoặc từ Zotero, được phân giải ngay. Bạn không phải gõ vào tài liệu trước.

- F12 hoặc nhấp với phím bổ trợ nhảy từ một khóa trích dẫn đến mục của nó.
- ⇧F12 liệt kê mọi lần dùng của một nguồn.
- F2 đổi tên một khóa trên cả tệp nguồn lẫn tệp tài liệu tham khảo.
- Di chuột hiển thị đích; các khóa chưa phân giải hoặc mơ hồ được đánh dấu trước khi biên dịch.

[Code intelligence](/docs/code-intelligence/) giải thích đầy đủ mô hình điều hướng.

## Trích dẫn Oleafly

Nếu Oleafly đã góp phần vào một bài báo, hãy chạy **Cite Oleafly in this paper** từ bảng lệnh hoặc từ cuối chế độ xem **Citations** của panel References. Oleafly thêm một mục với khóa `oleafly` vào danh mục tài liệu mà tài liệu khai báo, theo BibTeX hoặc, với tệp Hayagriva, theo Hayagriva. Một thông báo nêu tệp và cú pháp cần dùng, chẳng hạn `\cite{oleafly}` hoặc `@oleafly`, kèm **Undo** bên cạnh. Nếu mục đã có sẵn, bạn nhận được lời nhắc về khóa thay vào đó.

Một dự án không có tệp tài liệu tham khảo sẽ được giữ nguyên, và một hộp thoại hiển thị mục để bạn sao chép. Cùng mục đó luôn có trong [Settings → Help & About](/docs/settings/help/#cite-oleafly-in-a-paper).

## Biên dịch tài liệu tham khảo và Biber

Với `biblatex`, Oleafly chạy lại bước Biber tương ứng khi trình biên dịch chưa tạo được tệp `.bbl` dùng được. Các thông báo của Biber, kể cả đường dẫn `.bib` còn thiếu, xuất hiện trong nhật ký biên dịch và chẩn đoán của trình soạn thảo.

Khi chính Biber thất bại, nhật ký biên dịch nói rõ lý do. Nó nêu tên thư viện hệ thống còn thiếu, và gợi ý `\usepackage[backend=bibtex]{biblatex}` như một cách dựng mà không cần Biber. Trên Fedora, gói `.rpm` của Oleafly đề xuất hai thư viện mà Biber cần.

Nếu các tài liệu tham khảo vẫn chưa được xác định:

1. Kiểm tra khai báo và đường dẫn của danh mục tài liệu.
2. Mở **Logs** và tìm thông điệp Biber hoặc tài liệu tham khảo đầu tiên.
3. Xác nhận khóa trích dẫn tồn tại đúng một lần.
4. Biên dịch lại sau khi tệp `.bib` được lưu.

Xem [Biên dịch và nhật ký](/docs/compiling/) và [Engine và gói lệnh LaTeX](/docs/latex-engines/) để biết cách xử lý riêng cho từng engine.

## Các công cụ tài liệu tham khảo độc lập

Bạn có thể chuẩn bị tài liệu tham khảo mà không cần mở dự án:

- [Citation Generator](/docs/tools/citation-generator/) nhận định danh, tiêu đề, các trường có cấu trúc, hoặc BibTeX.
- [Bibliography Generator](/docs/tools/bibliography-generator/) dựng và kiểm tra tính hợp lệ của một danh sách.
- [Citation Generators by Style](/docs/tools/citation-styles/) so sánh tám kiểu.
- Các công cụ chuyên biệt xử lý [DOI](/docs/tools/doi-to-bibtex/), [ISBN](/docs/tools/isbn-to-bibtex/), [PubMed ID](/docs/tools/pubmed-to-bibtex/), [arXiv](/docs/tools/arxiv-citation-generator/), và [địa chỉ web](/docs/tools/url-to-bibtex/).

Chỉnh sửa thủ công và định dạng trích dẫn chạy cục bộ trên máy. Tra cứu theo định danh và tiêu đề cần kết nối mạng. [Chế độ ngoại tuyến](/docs/settings/general/#offline-mode) chặn các tra cứu đó trong khi phần hoàn thành và điều hướng tài liệu tham khảo sẵn có vẫn hoạt động.

## Tìm bằng chứng, rồi kiểm chứng

[Find Citations](/docs/tools/find-citations/) tìm trong các chỉ mục học thuật hoặc quét bản thảo đang mở để tìm các đoạn có thể cần dẫn nguồn. Hãy đọc bài báo trước khi trích dẫn và giữ mỗi luận điểm trong phạm vi những gì phần phương pháp và kết quả xác lập.
