参照 (および BibTeX データベース) を含むマークダウン ファイルを作成したいと考えています@ref
。ファイルを送信するときは、レンダリングされた参照を含むスタンドアロンのマークダウン ファイルに変換する必要があります。レンダリングされた参照キーは、数値ではなく、英数字である必要があります。
最小限の例:
最小限:
@PTDL2008
最小限のbib:
@article{PTDL2008,
title = {{Service-Oriented Computing: State of the Art and Research Challenges}},
author = {Michael P. Papazoglou and Paolo Traverso and Schahram Dustdar and Frank Leymann},
journal = {International Journal of Cooperative Information Systems (IJCIS)},
year = {2008},
month = {June},
number = {2},
pages = {233--255},
volume = {17},
doi = {10.1109/MC.2007.400}
}
得るDIN 1505-2 (英数字、ドイツ語)同じディレクトリに保存します。
コマンドライン呼び出し:
pandoc minimal.md -o minimal-new.md --atx-headers --bibliography="minimal.bib" --csl=din-1505-2-alphanumeric.csl
結果出力は
印刷形式なしの pandoc-citeproc リファレンス
生成された minimal-new.md にはレンダリングされた参照が含まれていません。
答え1
パーこのスレッドpandoc-discussメーリングリストでは、次の項目を追加することで参考文献を拡張できるはずです。
-t markdown-citations
pandoc 引数に追加します。これは「マークダウンマイナス引用」と解釈されます。つまり、citations
出力形式で拡張機能を無効にするので、出力で引用キーが展開されます。(少なくとも、私はこのように解釈しています。)
最小限の例と pandoc バージョン 1.17.0.2 でこれを試してみたところ、次の出力が生成されました。
**???**
<div id="refs" class="references">
<div id="ref-PTDL2008">
<span style="font-variant:small-caps;">Papazoglou, Michael P.</span> ;
<span style="font-variant:small-caps;">Traverso, Paolo</span> ; <span
style="font-variant:small-caps;">Dustdar, Schahram</span> ; <span
style="font-variant:small-caps;">Leymann, Frank</span>: Service-Oriented
Computing: State of the Art and Research Challenges. In: *International
Journal of Cooperative Information Systems (IJCIS)* Bd. 17 (2008),
Nr. 2, S. 233–255
</div>
</div>
つまり、参照はフォーマットされていますが、マークダウンがネイティブに実行できないHTMLタグが含まれています。「純粋な」マークダウンが必要な場合は、出力指定子でさらにいくつかの拡張機能を無効にする必要があります。
-t markdown-raw_html-citations-native_divs-native_spans
そしてあなたは得るでしょう
**???**
PAPAZOGLOU, MICHAEL P. ; TRAVERSO, PAOLO ; DUSTDAR, SCHAHRAM ; LEYMANN,
FRANK: Service-Oriented Computing: State of the Art and Research
Challenges. In: *International Journal of Cooperative Information
Systems (IJCIS)* Bd. 17 (2008), Nr. 2, S. 233–255
現在、CSL ファイルで義務付けられている「小文字大文字」は、従来の大文字を使用して近似されるようになりました。
残念ながら、これでは解決の半分しか達成できません。書誌エントリは正しくフォーマットされていますが、何らかの理由で、本文中の引用自体は として出力されます**???**
。今のところ、これに対する解決策は見つかっていません。
答え2
によるとhttps://github.com/jgm/pandoc-citeproc/issues/195つまり、参照が見つからなかったということです。
しかし、私にはこの例は問題ないように見えます。問題にも記載されているように--csl
、これは提供された csl ファイルに依存します。指定せずにデフォルトの引用スタイルを使用して確認することをお勧めします。これにより、より理解しやすい出力が生成されるはずです。