GitHubZettlrにおける引用¶バージョン1.0.0以降では、Zettlrで引用ソースを直接使用することができるようになりました。この機能により学術論文を実際に引用するためにZettlrのエクスポート機能を迂回する必要がなくなり、学術論文を書くのが以前よりも簡単になりました。Zettlrの引用機能はciteproc-jsを使用しています。これは、pandocのciteproc-engineやZoteroと同じように機能するライブラリです。ZoteroのワードプラグインやLibreOfficeプラグインが生成するのと同等のものがZettlrに表示されます。Zettlrの引用エンジンは3つの部品からなっています。edition)を置き換えるCSLスタイルシート、最後に、プレビューエンジンです。以下のガイドでは引用を使えるようにし、正しく一貫性のある引用を含んだ、美しい見た目のファイル(PDFに限りません)を生成できるように解説します。バージョン1.3.0以降では、BibTexライブラリも引用に使用できるようになりました。引用には2つのエンジンがあり、それぞれ異なる引用の体系に属しています。プレビュー(引用は画像として、もしくはリンクとしてプレビュー可能です)と、実際の引用を生成するプロセス(これはエクスポート時のみ実行されます)です。いずれの機能も、参照先を含んだ引用ライブラリを選択することで実行されます。このようなライブラリがなくても、Zettlrでは引用のプレビューは行えます(何がpandocのciteprocのトリガーとなるかを確認することができます)。引用の中身が実際に生成されて置換されることはありません。ライブラリを指定しないと、pandocのciteprocエンジンが実行されず、引用の解析が行われなくなります。そこで、まず最初のステップとしてファイルを作成します。ライブラリを管理するアプリケーションはZoteroを推奨します。以下のチュートリアルではZoteroを使うものとして説明します。JSON形式でエクスポートする方法を確認してください。JSON形式で出力する機能を持たない管理ソフトウェアを使用する場合は、BibTexファイルを使用することができます。JSONファイルと同じように使えます。最初のステップはZoteroのBetterBibTexプラグインのインストールです。このプラグインの主な利点は、ライブラリ全体で引用IDを一意にしてくれることです。各引用項目には、それぞれ一意のIDが振られます。これは、例えば発行日が間違って保存されていたことに気づいた時に、Zoteroで修正するだけで、その後citeprocが正しい情報を使用できるようにするために必要です。BetterBibTexを使わない場合、同じIDが複数回発行される可能性があります。この場合、エラーを発生させるか(これは何か悪いことが起きていると分かるので良い方法です)、もしくは最初にIDに一致したものを採用します(これはエクスポート後に間違った引用を発見できるかどうか運任せになってしまうので悪い方法です)。BetterBibTexをインストールしたら、IDの生成方法などの設定項目を触ってみても良いでしょう。BetterBibTexが一意なIDを自動生成するアルゴリズムはカスタマイズすることができます。ほとんどの場合、良く知られたJabRefパターンが使われますが、このパターンに大きな拡張が加えられています。Harvey2005cのようなIDが得られます。)BetterBibTexの全機能についてはプラグインのドキュメンテーションに書かれています。次のステップでは実際にライブラリをエクスポートします。Zoteroの役割は引用先の管理を行うことであり、引用を作成するのはciteprocの役割です。citeprocを使うには別のファイルが必要となります。Zettlrとpandocのciteprocで使えるライブラリファイルをエクスポートするには、まず左側のサイドバーでエクスポートしたいコレクションを選択します。ライブラリ全体を選択することもでき、そうすれば、すべての項目が自由に使えて複数のライブラリを作る必要もありません。(参考までに:700項目を含むライブラリで確認しましたが、パフォーマンス上の問題はありませんでした。library...を選択します。JSONを選択します。JSONを選択してもかまいません。updated"というチェックボックスをオンにすると、BetterBibTexはZoteroで変更があるたびに自動的にファイルのエクスポートを行い、Zoteroと同期を行います。(そうすれば、変更点が自動的にZettlrに連携され、常に正しい引用を行うことができるようになります。Exportを選択すると、ライブラリファイルの状態を確認することができます。エクスポートの内容とタイミングの細かい設定を行うこともできます。ライブラリをZettlrで開く¶ここで、Zettlrにライブラリをインポートします。そのためには、Zettlrの設定ダイアログでエクスポートタブを選択し、参考文献データベース入力欄の右側にある小さなフォルダアイコンをクリックします。データベースファイルを選択するためのダイアログが表示されます。ファイルを選択し、設定を保存すると、自動的にデータベースが読み込まれます。これで、引用を行う準備ができました。Zettlrにおける引用¶Zettlrで引用を使用する方法は簡単です。Zettlrではpandocのciteproc-syntaxをサポートして、引用を書く方法は2種類あります。一つ目は文章中に識別子を一つ置き、このキーに対応した引用を出力する方法です。この場合、@Harvey2005aのような形式になります。引用キーの前には必ず@が付きます。Zettlrには補完機能があるので、@を入力すると利用可能な引用キーを表示してくれます。これで、正しいIDを使用できているか最初に確認することができます。何も補完候補が表示されない場合は、そのIDはおそらくライブラリファイル中に存在しません。通常は引用に対して、ページ範囲などを加えていくらか限定した形にしたいと思います。そのためには、角括弧を使った拡張形式を使用します。この方法では、角括弧の中にプレフィックス、引用キー、ページ範囲を書きます。45-51]著者が複数の場合、それぞれのブロックをセミコロンで区切ります。8-9]pandocのciteprocエンジンにおける引用についての詳しい説明は、ガイドを参照してください。Zettlrのciteprocエンジンは、プレビューのみを目的としています。簡潔さのため、Zettlrはすべての引用を完全に解析することはせず、正確性をいくらか犠牲にしています。エクスポート時にpandocのciteprocが完全に正確に動作することは、疑う余地もありませんが、引用のプレビューについては、引用が正しく認識されていて、エクスポートする引用に漏れがないかを確認することにとどめてください。引用を作成し終わって、引用するつもりのものがすべて入っているかどうかをするには、添付ファイルサイドバー(Ctrl/Cmd+3のショートカット)を開きます。選択中ディレクトリにあるファイル一覧の下に、ファイル中に見つかったすべての参考文献の一覧が表示されます。ここで足りていないものがある場合は、おそらくファイル中で引用していないはずです。引用のスタイルを変更する¶Zettlrは内部的には常にAPAスタイルを使って引用を作成します。プレビューで表示される引用は、脚注スタイルではなく文書中に表示されるスタイルとなります。Zettlrでは、すべてが正しく動作していることを確認しやすくするために、このようにしています。これ以外にも、投稿先のジャーナルの要求や、個人的な好みに合わせた引用スタイルを使うこともできます。pandocのciteprocが引用を出力するスタイルを変更するには、それに応じたCSLファイルをダウンロードする必要があります。repositoryを見てみてください。特定のスタイルを検索し、プレビューしダウンロードすることができます。Zettlrが使用するCSLファイルの設定は2か所あります。一つは、設定ダイアログです。エクスポートタブの参考文献データベース欄の下に、使いたいCSLスタイルを選択する設定があります。ツールバーのボタンからファイルを個別にエクスポートする際に、ここで選択したスタイルが使用されます。プロジェクトごとに異なるCSLスタイルを使いたいと思います。そこで、それぞれのプロジェクトの設定でもCSLファイルを選択することができます。そのプロジェクト内では設定したスタイルでエクスポートを行うようになります。参考文献一覧のフォーマット¶もちろん、ファイル中に引用を書いたら、きちんとフォーマットされた参考文献一覧も必要だと思います。WordまたはLibreOfficeにエクスポートする場合は、ファイルを送る前にそれぞれのファイルを編集してスタイルを設定することができます。PDFにエクスポートしてしまうと、それも不可能です。pandoc-citeprocでは、単に参考文献をまとめて、何の書式も設定しないで文書の最後に出力します。参考文献一覧の見た目をよくするには、ちょっとしたトリックが必要となります。LaTeXでは長さを基準にして、エクスポートするPDF全体にわたる位置を決定しています。普通、この長さの設定はグローバルなものですが、ソースファイルによって変更できます。設定項目の一つにparindentがあり、これは段落のぶらさがりインデントをコントロールします。見出しに続く段落では長さが追加されますが、それはここでは考えないことにします。parindent変数はZettlrのPDF設定で変更することができます。それでは、すべての段落に対するグローバルな設定となってしまいます。参考文献も普通の段落のスタイルでフォーマットされるので、インデントも他の段落と同じようになってしまいます。参考文献の見た目を良くするちょっとしたトリックがあります。References(他の名前でも構いません)の見出しを書き、その後で段落の長さを上書きしてしまいましょう。見た目が良くなるように再設定するだけです。次のコードスニペットのようにします。paragraphs上の例だと、参考文献は負のインデント(-1cm)で出力されます。加えて、0.5cmの全体のインデントが適用されます(ページ余白からの相対値なので、左余白を3cmに設定したなら、普通の段落のオフセットが3.0cmに対して参考文献の段落は3.5cmのオフセットとなります)。最後の値(parskip)は段落間の間隔をコントロールします。各項目の間が0.1cm空くことになります。この設定から始めて、他の長さの設定も検索して、好みに合うように調整してみてください。