☰

Verwenden von Pandoc zum Konvertieren von Markdown in Markdown mit Referenzen / Was bedeutet „Referenz ohne gedruckte Form“?

tag-icon • tag-icon pandoc
Verwenden von Pandoc zum Konvertieren von Markdown in Markdown mit Referenzen / Was bedeutet „Referenz ohne gedruckte Form“?

Ich möchte eine Markdown-Datei mit Referenzen @ref(und einer BibTeX-Datenbank) schreiben. Beim Weitergeben der Datei sollte diese in eine eigenständige Markdown-Datei mit gerenderten Referenzen umgewandelt werden. Der gerenderte Referenzschlüssel sollte nicht numerisch, sondern alphanumerisch sein.

Minimalbeispiel:

minimal.md:

@PTDL2008

minimal.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}
}

ErhaltenDIN 1505-2 (alphanumerisch, deutsch)und speichern Sie es im selben Verzeichnis.

Kommandozeilenaufruf:

pandoc minimal.md -o minimal-new.md --atx-headers --bibliography="minimal.bib" --csl=din-1505-2-alphanumeric.csl

Die Ergebnisausgabe ist

Pandoc-Citeproc-Referenz ohne gedruckte Form

Die generierte Datei „minimal-new.md“ enthält keine gerenderte Referenz.

Antwort1

Prodieser ThreadAuf der Mailingliste pandoc-discuss sollten Sie die Referenzen erweitern können, indem Sie hinzufügen

-t markdown-citations

zu Ihren Pandoc-Argumenten. Dies bedeutet „Markdown minus Zitate“ – das heißt, Sie deaktivieren die citationsErweiterung im Ausgabeformat, sodass der Zitatschlüssel in der Ausgabe erweitert wird. (Zumindest interpretiere ich es so.)

Ich habe dies mit Ihrem Minimalbeispiel und Pandoc Version 1.17.0.2 versucht und es hat die folgende Ausgabe erzeugt:

**???**

<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>

Die Referenz wurde also formatiert, enthält aber HTML-Tags für Dinge, die Markdown nicht nativ kann. Wenn Sie „reines“ Markdown möchten, müssen Sie einige weitere Erweiterungen in Ihrem Ausgabespezifizierer deaktivieren – verwenden Sie

-t markdown-raw_html-citations-native_divs-native_spans

und du bekommst

**???**

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

Die in der CSL-Datei vorgeschriebenen „Kapitälchen“ werden nun durch einfache Großbuchstaben angenähert.

Leider ist dies nur die halbe Lösung: Der bibliografische Eintrag ist korrekt formatiert, aber aus irgendeinem Grund wird die Quellenangabe im Text nur als angezeigt **???**. Ich habe hierfür bisher noch keine Lösung gefunden.

Antwort2

Entsprechendhttps://github.com/jgm/pandoc-citeproc/issues/195das bedeutet, dass keine Referenz gefunden wurde.

Aber für mich sieht das Beispiel ok aus. Wie auch im Problem erwähnt, ist es von der bereitgestellten CSL-Datei abhängig. Ich würde empfehlen, es ohne --cslAngabe zu überprüfen und den Standard-Zitationsstil zu verwenden. Dies sollte ein verständlicheres Ergebnis liefern.

verwandte Informationen