Blog Digitalgesellschaft Verwaltungsbetrieb Textarchiv Textarchiv Walter Kirk (✝) Impressum

Markdown, LateX und Zotero

Vorbemerkung

Für umfangreiche Texte, wie es zum Beispiel wissenschaftliche Arbeiten sind, hat sich LaTeX als Standard etabliert und wird heute noch in vielen Fakultäten zur Erstellung genutzt. Allerdings ist eine ausführliche Einarbeitung notwendig, die durchaus zeitintensiv sein kann.

In den letzten Jahren zeichnet sich jedoch auch eine andere Entwicklung ab. Die einfache Sprache Markdown wird mit LaTeX und einer Bibliografie verbunden, um 1. einfacher Texte anzufertigen, 2. mit einem sehr guten Ergebnis, 3. in den gängigen Formaten.

Installation

Grundkomponenten

- Markdown-Editor, z.B. Typora

- Citation Style Language - Zitierstildatei .csl

- LaTeX Basis oder Voll

- das Skript pandoc-crossref

- Pandoc

- Zotero mit den AddIn: ZotFile, Better BibTex, MDNotes

Alle vorgenannten Kompenenten stehen für die Betriebssysteme (MacOS, Linux und Windows) zur Verfügung.

Bibliografie

Zotero verwaltet Literatur, ist kostenfrei und lässt sich in andere Programme gut einbinden. Die AddIn vereinfachen die Arbeit.

Hinweise zur Einrichtung unter https://retorque.re/zotero-better-bibtex/installation/

LaTeX

Unter debian-basierten Systemen kann TeXLive aus den Paketquellen installiert werden.

Basis

test@geraet: $ sudo apt install texlive

Voll

xxxxxxxxxx
test@geraet: $ sudo apt install texlive-full

Arbeitsschritte

Schritt 1: Bibliothek erstellen

Jede Quelle ist im .bib-Format in Zotero einzugeben. Nach Abschluss ist die eigene Literatur als .bib zu exportieren.

Schritt 2: Zitierstil festlegen

Im Beispiel wird din-1505-2.csl genutzt.

Download: https://github.com/citation-style-language/styles

Schritt 3: Text erstellen

Als hilfreich erweisen sich Markdown-Editoren, von denen es eine Vielzahl gibt. Im Beispiel wurde ein Text mit Typora erstellt.

Als YAML-Text ist einzugeben:

xxxxxxxxxx
---
lang: de-DE
title: "RStudio installieren und einrichten"
subtitle: ""
author: Wolfgang Kirk
csl: "/home/test/schriften/csl/din-1505-2.csl"
header-includes:
  - \usepackage{color}
  - \usepackage{caption}
  - \captionsetup[figure]{
      name=,
      labelsep=none,
      labelformat=empty}
---

title, author, csl sind selbsterklärend.

Die LaTeX-Ausführungsanweisungen enthalten die notwendigen Angaben für das Ausgabeformat. Diese Angaben können den eigenen Verhältnissen angepasst werden. Hinweise hierzu sind den LaTeX-Tutorials zu entnehmen.

Darunter wird der eigentliche Text eingegeben:

​x
## Vorbemerkung

Text

Schritt 4: Zitation

Im laufenden Text werden Literaturangaben zitiert in der Form: @Citation key.

Einfach den in Zotero angezeigten Zitierschlüssel in den Text an die gewünschte Stelle kopieren, z.B. @wolffVerwaltungsrecht1976a

Schritt 5: Bilder

Damit Pandoc die eingefügten Bilder in das Ausgabeformat integriert, ist das typische Format im Text einzufügen:

xxxxxxxxxx
![ ](bild){ width=300 margin=auto }

Diese Lösung beinhaltet Non-Breaking-Space ( ).

Schritt 6: Ausgabe erstellen

Ein Terminal im dem Ordner mit der .bib und der .md öffnen und eingeben:

PDF

pandoc --toc --metadata link-citations=true --filter citeproc -s test.md --bibliography literatur.bib -s -o test.pdf

HTML

xxxxxxxxxx
pandoc --toc --metadata link-citations=true --filter citeproc -s test.md --bibliography literatur.bib -s -o test.html

Erläuterung

toc: Inhaltsverzeichnis (optional)

metadata: Zitation

Mit der Ausführung wird eine test.pdf bzw. test.html erstellt.

Literatur

Kirk, Wolfgang: Workflow in der Texterstellung, Blogbeitrag vom 2021-04-21

Schlussbemerkung

Die Fokussierung auf die nützlichen Funktionen machen die Einarbeitung weniger zeitintensiv. Mit der Kombination Markdown--LaTeX--Zotero--Pandoc lassen sich qualitativ hochwertige Texte erstellen.

Top

© Wolfgang Kirk

Stand: 2023-06-02,  10:00 Uhr