Verwenden von Pandoc zum Konvertieren von Markdown in Markdown mit Referenzen / Was bedeutet "Referenz ohne gedrucktes Formular"?

988
koppor

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

Minimales Beispiel:

minimal.md:

@PTDL2008 

minimal.bib:

@article}, author =, journal =, year =, month =, number =, pages =, volume =, doi =  } 

Holen Sie sich DIN 1505-2 (alphanumerisch) und speichern Sie sie im selben Verzeichnis.

Befehlszeilenaufruf:

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

Das Ergebnis wird ausgegeben

Pandoc-Citeproc-Referenz ohne gedrucktes Formular

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

4

2 Antworten auf die Frage

2
Pont

In diesem Thread in der Pandoc-Discemail-Liste sollten Sie die Referenzen durch Hinzufügen erweitern können

-t markdown-citations 

auf Ihre Pandoc-Argumente. Dies bedeutet "Abzug minus Zitate" - das heißt, Sie deaktivieren die citationsErweiterung im Ausgabeformat, sodass der Zitierungsschlüssel in der Ausgabe erweitert wird. (So ​​interpretiere ich es zumindest.)

Ich habe dies mit Ihrer Minimal-Beispiel- und Pandoc-Version 1.17.0.2 ausprobiert und 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 jedoch HTML-Tags für Dinge, die Markdown nicht nativ ausführen kann. Wenn Sie ein "reines" Markdown wünschen, müssen Sie einige weitere Erweiterungen in Ihrem Ausgabespezifizierer deaktivieren - use

-t markdown-raw_html-citations-native_divs-native_spans 

und du wirst bekommen

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

Nun wurden die von der CSL-Datei vorgeschriebenen "Small Caps" mit einfachen alten Großbuchstaben angenähert.

Leider führt dies nur zur Hälfte zu einer Lösung: Der bibliografische Eintrag ist korrekt formatiert, aber aus irgendeinem Grund erscheint das In-Text-Zitat selbst einfach als **???**. Bis jetzt habe ich keine Lösung dafür gefunden.

0
white_gecko

Laut https://github.com/jgm/pandoc-citeproc/issues/195 bedeutet dies, dass keine Referenz gefunden wurde.

Aber für mich sieht das Beispiel gut aus. Wie auch in der Ausgabe erwähnt, ist es abhängig von der bereitgestellten CSL-Datei. Ich würde empfehlen, es ohne zu --cslspezifizieren und mit dem Standardzitierstil zu überprüfen, dies sollte eine verständlichere Ausgabe ergeben.