コンテンツにスキップ
Oleaflyv0.4.12

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

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

引用のつながりテキスト中の引用コマンド(たとえばバックスラッシュ cite vaswani2017)がキーを指定します。キーは references.bib のエントリを指し、エントリは DOI または arXiv ID を通じて実際の出典を指します。新しいエントリは、Zotero ライブラリ、DOI・arXiv ID・ISBN を使った「探して追加」、または「参考文献ライブラリの読み込み」から .bib に追加されます。テキスト中\cite{vaswani2017}references.bib 内@article{vaswani2017実際の出典DOI または arXiv IDZotero@ で引用探して追加DOI、arXiv ID、ISBN読み込みライブラリ全体キーDOI引用のつながりテキスト中の引用コマンド(たとえばバックスラッシュ cite vaswani2017)がキーを指定します。キーは references.bib のエントリを指し、エントリは DOI または arXiv ID を通じて実際の出典を指します。新しいエントリは、Zotero ライブラリ、DOI・arXiv ID・ISBN を使った「探して追加」、または「参考文献ライブラリの読み込み」から .bib に追加されます。テキスト中\cite{vaswani2017}references.bib 内@article{vaswani2017実際の出典DOI または arXiv ID新しいエントリZotero、探して追加、参考文献ライブラリの読み込みキーDOI
テキスト中のキーは .bib のエントリを指し、エントリは実際の出典を指します。新しいエントリは Zotero、「探して追加」、読み込みから入ります。
Oleafly の参考文献パネル。参照、引用、シンボルを切り替え、検索欄で現在のビューを絞り込みます。
Oleafly の参考文献パネル。参照、引用、シンボルを切り替え、検索欄で現在のビューを絞り込みます。 スクリーンショット全体を開く
「プロジェクトから引用」で参考文献の選択画面が開きます。キー、著者、タイトルで検索できます。「新しい引用を探して追加」でオンライン検索が開きます。
「プロジェクトから引用」で参考文献の選択画面が開きます。キー、著者、タイトルで検索できます。「新しい引用を探して追加」でオンライン検索が開きます。 スクリーンショット全体を開く

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

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

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

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

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

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

論文タイトルの一部を貼り付けると、その BibTeX エントリが refs.bib に保存されます。
論文タイトルの一部を貼り付けると、その BibTeX エントリが refs.bib に保存されます。 スクリーンショット全体を開く

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

「新しい参考文献を探して追加する」セクション

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

  • 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 が参考文献ファイルを選ぶ方法

「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 ドキュメントに #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 件を取り込みます。設定の手順は調査ソースを接続するで説明しています。

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

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

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

「参考文献ライブラリを整理する」セクション

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

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

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

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

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

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

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

ナビゲーションの全体像は、コードインテリジェンスで説明しています。

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

参考文献ファイルがないプロジェクトは変更されず、コピーできるように項目がダイアログに表示されます。同じ項目は、設定 → ヘルプと情報にいつでもあります。

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

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

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

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

エンジンごとの復旧方法は、コンパイルとログと LaTeX のエンジンとパッケージをご覧ください。

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

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

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

画像のプレビュー

AI の回答を読み込めませんでした

もう一度試すか、ドキュメントを検索してください。