# 引用と参考文献

出典を探し、メタデータを確認し、適切な参考文献ファイルに追加し、カーソル位置で引用し、Typst の引用スタイルを選び、元のデータを失わずにライブラリを整理します。

引用は鎖のようにつながっています。主張が引用キーを指し、キーが参考文献の項目を指し、項目が実在の出典を指します。Oleafly はこのつながりを見える状態に保つので、ちょっとした検索が、あとで正体のわからない参考文献になることはありません。

![Oleafly の参考文献パネル。参照、引用、シンボルを切り替え、検索欄で現在のビューを絞り込みます。](https://cdn.oleafly.com/images/screenshots/desktop/docs/references-panel-dark-window-v2.png#view=0,45,344,703)

## 書きながら引用する

![「プロジェクトから引用」で参考文献の選択画面が開きます。キー、著者、タイトルで検索できます。「新しい引用を探して追加」でオンライン検索が開きます。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-citation-picker-dark-window-v2.png#view=415,77,365,467)

LaTeX または Typst のツールバーで、`@` アイコンの**プロジェクトから引用**を選びます。現在の参考文献をキー、著者、タイトルで検索し、項目を選びます。

⌘K または Ctrl+K のコマンドパレットから**引用を追加**を実行することもできます。Oleafly は、開いているプロジェクトに合った構文を挿入します。

- LaTeX では `\cite{key}`。
- Typst では `@key`。メイン文書に `#bibliography(...)` の行がなければ、末尾に追加します。
- Markdown では `[@key]`。必要に応じて、フロントマターに `bibliography:` の行を追加します。

Zotero を接続していると、 **引用を追加**には、Zotero ライブラリの一致する項目が先に表示されます。

## Zotero ライブラリから引用する

[Zotero を接続](/docs/integrations/research-sources/#zotero)したら、`@` に続けて、著者名の一部、タイトルの単語、年、またはキーを入力します。プロジェクト自身の参考文献と並んで、Zotero ライブラリ全体が候補に表示されます。論文を選ぶと、Oleafly は、そのドキュメントがすでに使っている引用の書き方で引用を挿入します。LaTeX では、そのドキュメントでいちばん多く使われているコマンド (`\citep` や `\parencite` など)、Typst では `@key`、Markdown では `[@key]` になります。すでにある `\cite{...}` の中で `@` を入力すると、そこに別のキーを追加できます。

プロジェクトの `.bib` に入るのは、その 1 件だけで、ファイルの末尾に追加されます。ファイルのほかの部分は変わりません。すでに `.bib` にある論文は、キーが同じでも DOI が同じでも、二重に追加されません。項目に、お使いのコンピュータ上の PDF のパスが含まれることはありません。プロジェクトにまだ参考文献の行がない場合は、Oleafly が追加します。LaTeX では `\bibliography` か `\addbibresource`、Typst では `#bibliography`、Markdown ではフロントマターの `bibliography:` です。`.bib` ファイルが複数ある場合は、新しい参考文献をどのファイルに入れるかを Oleafly が 1 度だけ尋ね、その答えを記憶します。

参考文献を `thebibliography` 環境で手書きしている LaTeX の論文で、初めて Zotero から引用するときは、その一覧を `.bib` に移すかどうかを Oleafly が尋ねます。移すと、すべての参考文献が 1 つの番号付きリストにまとまります。

### .bib を Zotero と同期させる

引用されているのに `.bib` にないキーが Zotero にある場合は、 **Zotero から追加**が表示されます。⌘K のパレットから**不足している引用を Zotero から追加**を実行すると、引用されているすべてのキーを一度に確認できます。Zotero にあるものは追加し、ないものは一覧にして、すでに参考文献にある論文を指しているキーを知らせます。

Zotero で論文が変更されると、その `.bib` の項目に **Zotero から更新**が表示されます。パレットの **Zotero から .bib の項目を更新**では、変更されたすべての項目を確認できます。手で編集した項目は、確認したあとにだけ置き換えられます。 **Zotero ライブラリを同期**は、ライブラリを読み込み直します。Oleafly が自分の判断で `.bib` から何かを削除することはありません。

![論文タイトルの一部を貼り付けると、その BibTeX エントリが refs.bib に保存されます。](https://cdn.oleafly.com/images/gifs/desktop/add-citation.gif?v=2)

## 新しい参考文献を探して追加する

選択画面で**新しい引用を探して追加**を選びます。入力は次のいずれかで始められます。

- `10.1145/3592979` のような DOI
- `1706.03762` のような arXiv ID
- ISBN-10 または ISBN-13
- PubMed ID (PMID)
- これらの識別子のいずれかを含む URL
- 論文のタイトル

DOI、arXiv、ISBN、PubMed の検索には、それぞれの公開カタログを使います。タイトル検索では、著者、年、発表先とともに候補が返されるので、推測をそのまま受け入れるのではなく、自分で選べます。

返された BibTeX を確認して、**.bib に追加して引用**を選びます。すると Oleafly は次のことを行います。

1. 開いている参考文献に、重複しないキーを追加する
2. 同じ DOI がすでにある場合は、既存の項目を再利用する
3. 現在のカーソル位置に引用を挿入する
4. ファイルツリーと参考文献パネルをすぐに更新する

メタデータは編集できます。原稿の一部になる前に、記録を修正してください。

ドキュメントが複数の参考文献を宣言している場合、ダイアログに**参考文献**メニューが表示されます。項目は選んだファイルに入り、Oleafly はその選択をそのプロジェクトで記憶します。

## Oleafly が参考文献ファイルを選ぶ方法

LaTeX プロジェクトでは、有効なメイン文書の宣言に従います。

- `biblatex` では `\addbibresource{references.bib}`
- BibTeX のワークフローでは `\bibliography{references}`

パスは、TeX ツールチェーンが想定するのと同じ拡張子と相対パスの扱いで解決されます。存在しないファイルを指す宣言は、黙ってほかの場所に書き込むのではなく、そのソースの行で報告されます。

Typst プロジェクトでは、`#bibliography(...)` の呼び出しに従います。指定が 1 つのファイルでもリストでも、ファイルが BibTeX の `.bib` でも Hayagriva の `.yml` や `.yaml` でも同じです。新しい引用は、ドキュメントが宣言したファイルに入ります。そのファイルが Hayagriva 形式の場合、Oleafly は BibTeX の項目を変換してから書き込みます。呼び出しで複数のファイルが指定されている場合は、ダイアログの**参考文献**メニューで書き込み先を選びます。

Markdown プロジェクトでは、フロントマターの `bibliography:` フィールドに従います。

参考文献が宣言されていない場合、Oleafly はプロジェクト内の最初の `.bib` を使います。ない場合は `references.bib` を作成し、ファイルツリーと引用の選択画面で使えるようにします。

ライブラリが複数あるプロジェクトでは、項目を追加する前に、選ばれている書き込み先を確認してください。

## Typst の引用スタイルを選ぶ

Typst ドキュメントに `#bibliography(...)` の呼び出しがあると、参考文献パネルの**引用**ビューの下部に**引用スタイル**メニューが表示されます。プロジェクトの Typst のバージョンに対応する Typst 組み込みのスタイルと、プロジェクト内の `.csl` ファイルが一覧に並びます。スタイルを選ぶと、その呼び出しの `style:` 引数に書き込まれます。指定がない場合、Typst は `ieee` を使います。

LaTeX では、スタイルをソースで設定します。`\bibliographystyle{` では、よく使う BibTeX のスタイルが補完されます。`biblatex` では、`style=` オプションを使います。

## 参考文献ライブラリをまとめて読み込む

参考文献パネルで**参考文献ライブラリの読み込み**を選びます。ファイルか、Zotero ライブラリを読み込めます。

**ファイルから**は、書き出したライブラリを選びます。

| 元の形式 | ファイル |
| --- | --- |
| BibTeX | `.bib` |
| RIS | `.ris` |
| EndNote XML | `.xml` |
| Zotero RDF | `.rdf` |

**Zotero から**は、 **設定 → 連携 → Zotero** で zotero.org アカウントを 1 度接続し、Zotero のカードで **Zotero ライブラリを読み込む**を選びます。Oleafly は最大 5,000 件を取り込みます。設定の手順は[調査ソースを接続する](/docs/integrations/research-sources/#zotero)で説明しています。

Oleafly は記録を BibTeX に変換し、DOI が読み込み先のライブラリにすでにある、または同じバッチの前のほうにある参考文献はスキップします。重複しないキーを作り、結果を 1 回の書き込みで追記します。メッセージには、追加された件数と、すでにあった件数が表示されます。ライブラリの読み込みでは、カーソル位置に引用は挿入されません。

読み込んだあとは、引用の選択画面で新しい項目を検索し、いくつかを元のカタログと照らして確認してください。

## 参考文献ライブラリを整理する

参考文献パネルでは、ファイルを変更する前に、整理の内容をプレビューできます。

1. プロジェクトを開き、参考文献パネルで**参考文献ライブラリを整理**を選びます。
2. プロジェクトに `.bib` ファイルが複数ある場合は、対象のファイルを選びます。
3. 操作の一覧と、変更前後の差分を読みます。
4. 提案されているキーの変更、削除される DOI の重複、注意事項を一つずつ確認します。
5. プレビューが意図と合っていることを確認してから適用します。

整理では、キーを著者・年・タイトルの一貫したパターンに変更し、プロジェクトのソースファイル全体の引用を更新します。DOI の重複を削除するのは、残す項目に、削除する項目のすべてのフィールドが含まれている場合だけです。DOI が食い違う記録やタイトルが似ている記録は、推測で統合せず、確認用に印を付けます。

コメントと BibTeX の string 定義は保持されます。適用するときは、ライブラリがプレビューとまだ一致しているかを確認し、ファイルを変更する前にバックアップを書き込みます。差分が大きい場合、プレビューには先頭の 500 行が表示されますが、変更を適用するときは完全なファイルが使われます。

:::caution[適用する前に確認]
2 つの版、翻訳、プレプリントとジャーナル版、タイトルが似た論文は、意図的に別のものになっていることがあります。手動で何かを統合する前に、注意事項を読み、実際の出典を比べてください。
:::

## 参考文献の補完と移動

`\cite{}`、`\citep{}`、`\citet{}`、`\parencite{}`、`\textcite{}` などの LaTeX の引用コマンドの中では、自動補完がプロジェクトのすべての `.bib` ファイルを検索します。Typst では、`@` で `.bib` と Hayagriva の両方のファイルからキーが補完されます。Zotero を接続していると、候補には Zotero ライブラリも含まれます。

その `.bib` ファイルを開いていない間に追加された項目 (たとえばアシスタントや Zotero による追加) への引用は、すぐに解決されます。先にドキュメントで何か入力する必要はありません。

- F12 か、修飾キーを押しながらのクリックで、引用キーからその項目に移動します。
- ⇧F12 で、出典のすべての使用箇所を一覧表示します。
- F2 で、ソースと参考文献ファイル全体でキーの名前を変更します。
- ポインタを合わせると参照先が表示されます。解決できないキーや曖昧なキーには、コンパイル前に印が付きます。

ナビゲーションの全体像は、[コードインテリジェンス](/docs/code-intelligence/)で説明しています。

## Oleafly を引用する

論文の作成に Oleafly が役立った場合は、コマンドパレットか、参考文献パネルの**引用**ビューの下部から、 **この論文で Oleafly を引用する**を実行します。Oleafly は、ドキュメントが宣言している参考文献ファイルに、キー `oleafly` の項目を、BibTeX 形式で (Hayagriva ファイルの場合は Hayagriva 形式で) 追加します。メッセージにはファイル名と使う構文 (`\cite{oleafly}` や `@oleafly` など) が表示され、横に**元に戻す**が付きます。項目がすでにある場合は、代わりにキーが表示されます。

参考文献ファイルがないプロジェクトは変更されず、コピーできるように項目がダイアログに表示されます。同じ項目は、[設定 → ヘルプと情報](/docs/settings/help/#cite-oleafly-in-a-paper)にいつでもあります。

## 参考文献のビルドと Biber

`biblatex` では、コンパイラが使える `.bbl` を生成しなかった場合に、Oleafly が対応する Biber の手順をもう一度実行します。`.bib` のパスが見つからないといった Biber のメッセージは、コンパイルのログとエディタの診断に表示されます。

Biber 自体が失敗した場合は、コンパイルのログに理由が表示されます。足りないシステムライブラリの名前と、Biber なしでビルドする方法として `\usepackage[backend=bibtex]{biblatex}` が示されます。Fedora では、Oleafly の `.rpm` が、Biber に必要な 2 つのライブラリを推奨パッケージとして指定しています。

参照が未定義のままの場合は、次を確認します。

1. 参考文献の宣言とパスを確認します。
2. **ログ**を開き、最初の Biber または参考文献のメッセージを探します。
3. 引用キーがちょうど 1 つだけ存在することを確認します。
4. `.bib` ファイルを保存してから、再コンパイルします。

エンジンごとの復旧方法は、[コンパイルとログ](/docs/compiling/)と [LaTeX のエンジンとパッケージ](/docs/latex-engines/)をご覧ください。

## 単体の参考文献ツール

プロジェクトを開かなくても、参考文献を準備できます。

- [引用ジェネレータ](/docs/tools/citation-generator/)は、識別子、タイトル、構造化されたフィールド、または BibTeX を受け付けます。
- [参考文献ジェネレータ](/docs/tools/bibliography-generator/)は、リストを作成して検証します。
- [スタイル別の引用ジェネレータ](/docs/tools/citation-styles/)は、8 つのスタイルを比べられます。
- 用途を絞ったツールとして、[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/)、[ウェブアドレス](/docs/tools/url-to-bibtex/)を扱うものがあります。

手動での編集と引用の整形は、ローカルで完結します。識別子とタイトルの検索には、接続が必要です。[オフラインモード](/docs/settings/general/#offline-mode)では、これらの検索はブロックされますが、既存の参考文献の補完とナビゲーションは引き続き使えます。

## 根拠を探し、確認する

[引用を探す](/docs/tools/find-citations/)は、学術インデックスを検索するか、開いている草稿をスキャンして、裏付けが必要そうな箇所を探します。引用する前にその論文を読み、各主張は、手法と結果が裏付ける範囲にとどめてください。
