Workflow dokumentiert

README.md

@@ -1,58 +1,126 @@
-Dieses Repository enthält Vorlagen für Artikel der Fachzeitschrift [Informationspraxis](http://informationspraxis.de/) sowie Konfigurationsdateien zur Konvertierung der Artikel mit [Pandoc](johnmacfarlane.net/pandoc/) nach HTML, PDF und EPUB.
+Dieses Repository enthält Vorlagen für Artikel der Fachzeitschrift [Informationspraxis](http://informationspraxis.de/) sowie Konfigurationsdateien zur Konvertierung der Artikel mit [Pandoc](https://pandoc.org) nach HTML, PDF und EPUB.
 
-## Vorlage
+## Vorlage für Beitragseinreichungen
 
-Die Vorlage für Artikel besteht aus zwei Dateien:
+* [vorlage-word.dotx](vorlage-word.dotx) zum Verfassen mit Word
+* [vorlage-markdown.md](vorlage-markdown.md) zum Verfassen in Markdown-Syntax
+* vorlage-libreoffice.ott zum Verfassen mit Libre/Open Office
+  - [ ] TODO: Vorlage für LibreOffice
 
-* Die Datei **vorlage-metadaten.yml** für die Metadaten des Artikels (Titel, Autor/in, Abstract...)
-* Eine der folgenden Dateien für den Artikeltext:
-    * **vorlage-markdown.md** zum Verfassen in Markdown-Syntax
-    * **vorlage-word.docx** zum Verfassen mit Word
-    * **vorlage-libreoffice.odt** zum Verfassen mit Libre/Open Offixe
+## Redaktionsworkflow
 
-## Redaktionelle Bearbeitung
+Für die Konvertierung der eingereichten Artikel nach HTML, PDF und EPUB nutzen wir [Pandoc](https://pandoc.org/). Für die redaktionelle Bearbeitung nutzen wir den Markdown-Editor [Typora](https://typora.io). Beide Tools sind für Windows, macOS und Linux verfügbar. Unter Windows benötigen wir zusätzlich einen vernünftigen Texteditor zur Bearbeitung der Metadaten im YAML-Format wie z.B. Notepad++.
 
-1. Konvertierung des eingereichten Dokuments nach Markdown mit Hilfe von Pandoc:
+### Beispiel
 
-    - von Format DOCX:
+- AutorInnen
+  - Einreichung nach Word-Vorlage: [example/erstautorin-2019.docx](example/erstautorin-2019.docx)
+- Redaktion
+  - Metadaten in YAML erfassen: [example/erstautorin-2019.yaml](example/erstautorin-2019.yaml)
+  - Markdown aus DOCX generiert und nachbearbeitet: [example/erstautorin-2019.yaml](example/erstautorin-2019.yaml)
+- Pandoc
+  - HTML: [example/erstautorin-2019.html](example/erstautorin-2019.html)
+  - PDF: [example/erstautorin-2019.pdf](example/erstautorin-2019.pdf)
+  - EPUB: [example/erstautorin-2019.epub](example/erstautorin-2019.epub)
 
-    ```
-    pandoc --extract-media . -o erstautorin-yyyy-mm-dd.md erstautorin-yyyy-mm-dd.docx
-    ```
-    
-    - von Format ODT:
-    
-    ```
-    pandoc -o erstautorin-yyyy-mm-dd.md erstautorin-yyyy-mm-dd.odt
-    ```
-    
-    - von Format DOC: Zunächst Konvertierung in DOCX, z.B. mit Word oder [http://cloudconvert.org](http://cloudconvert.org), dann Konvertierung mit Pandoc (s.o.)
+### Installation
 
-2. Erstellung einer YAML-Datei `erstautorin-yyyy-mm-dd.yml` für die Metadaten entsprechend der Vorlage `vorlage-metadaten.yml`
+Windows, MacOS, Linux:
 
-3. Bearbeitung der Markdown-Datei `erstautorin-yyyy-mm-dd.md`
+* Pandoc installieren: https://pandoc.org/installing.html
+  * Pandoc benötigt LaTeX, siehe dazu den letzten Punkt der Pandoc Installationsanweisung.
+  * Unter Windows wird beispielsweise die (zusätzliche) Installation von [MiKTeX](https://miktex.org/howto/install-miktex) empfohlen.
+* Markdown-Editor Typora installieren: https://typora.io/#download
+* Vorlagen herunterladen: https://github.com/felixlohmeier/artikel-vorlage/archive/master.zip
 
-    - Titel, Abstract, Keywords, (Informationen über die) Autoren etc.
-      gehören *ausschließlich* in die YAML-Datei
+Windows zusätzlich:
 
-    - Sichtprüfung der Formatierung und ggf. Korrekturen nach [Pandoc-Markdown-Syntax](http://pandoc.org/MANUAL.html#pandocs-markdown)
+* Notepad++ installieren: https://notepad-plus-plus.org/download/
 
-## Konvertierung nach HTML, PDF und EPUB
+### Redaktionelle Bearbeitung
 
-1.  Erstellung der HTML-Version
+Der folgende Workflow wurde getestet am 6.6.2019 unter Windows mit:
 
-	```
-	pandoc -s --template pandoc-template.html -o erstautorin-yyyy-mm-dd.html erstautorin-yyyy-mm-dd.yml erstautorin-yyyy-mm-dd.md
-	```
+* Pandoc 2.7.2
+* MiKTeX 2.9.7086
+* Typora 0.9.70
+* Notepad++ 7.7
 
-2. Erstellung der PDF-Version
+#### Schritt 1: Erstellung einer YAML-Datei für die Metadaten
 
-	```
-	pandoc -s --template pandoc-template.tex -V fontsize=12pt -V papersize=a4paper -V documentclass=article -V headheight=20mm -V headsep=10mm -V footskip=20mm -V top=30mm -V bottom=40mm -V left=25mm -V right=25mm -V graphics=1 -o erstautorin-yyyy-mm-dd.pdf erstautorin-yyyy-mm-dd.yml erstautorin-yyyy-mm-dd.md
-	```
+Vorlagendatei `vorlage-metadaten.yml` in einem UTF-8-fähigen-Texteditor (z.B. Notepad++ unter Windows) öffnen, alle relevanten Daten ausfüllen und unter neuem Dateinamen speichern, hier im Beispiel  `erstautorin-2019.yml`.
 
-3. Erstellung der EPUB-Version
+Der Abschnitt "von den AutorInnen vergebene Metadaten" kann ggf. per Copy & Paste aus dem von den AutorInnen eingereichten Dokument übernommen werden.
+
+![Metadaten in YAML](screenshots/metadaten.png)
+
+#### Schritt 2: Konvertierung des eingereichten Dokuments nach Markdown
+
+Öffnen Sie eine Kommandozeile (Windows: PowerShell, macOS/Linux: Terminal) und wechseln Sie in das Verzeichnis, in das Sie die Vorlagen heruntergeladen haben.
+
+Legen Sie das eingereichte Dokument ebenfalls in diesem Verzeichnis ab. In diesem Beispiel heißt die Quelldatei `erstautorin-2019.docx`
+
+![Konvertierung nach Markdown](screenshots/docx2md.png)
+
+* von Format Markdown
+  * keine Konvertierung notwendig, weiter mit Schritt 3
+* von Format DOC
+  * Datei in Word oder LibreOffice öffnen und als DOCX speichern
+  * Dann weiter mit Format DOCX
+
+- von Format DOCX (Beispiel für Quelldatei `erstautorin-2019.docx`)
+
+```
+pandoc --extract-media . --wrap=none -t markdown-simple_tables -o erstautorin-2019.md erstautorin-2019.docx
+```
+
+- von Format ODT (Beispiel für Quelldatei `erstautorin-2019.odt`)
+
+```
+pandoc --extract-media . --wrap=none -t markdown-simple_tables -o erstautorin-2019.md erstautorin-2019.odt
+```
+
+#### Schritt 3: Nachbearbeitung der Markdown-Datei
+
+Die im vorigen Schritt erstellte Markdown-Datei in einem Markdown-Editor (z.B. Typora unter Windows) öffnen und bereinigen.
+
+![Nachbearbeitung mit Typora](screenshots/typora.png)
+
+Folgende Nacharbeiten sind erforderlich:
+
+* Metadaten und Fragmente aus der Vorlage zu Beginn der Datei löschen. Der Text muss direkt mit der ersten Überschrift (z.B. `1 Einleitung`) beginnen.
+* Prüfen, ob alle Bilder korrekt angezeigt werden. Größenangaben wie `{width="6.531496062992126in" height="2.263779527559055in"}` löschen.
+* Bildunterschriften prüfen und ggf. vereinheitlichen.
+* Wenn Listen kompakt dargestellt werden sollen, dann im Quellcode (Menü Darstellung / Quellcodemodus) leere Zeilen innerhalb der Aufzählungen entfernen.
+* Ggf. weitere Formatierung gemäß der [Richtlinien](https://journals.ub.uni-heidelberg.de/index.php/ip/about/submissions) und nach [Pandoc-Markdown-Syntax](http://pandoc.org/MANUAL.html#pandocs-markdown)
+
+### HTML, PDF und EPUB generieren
+
+Zurück in der Kommandozeile die folgenden Befehle aufrufen, um die fertigen Dateien für OJS zu erstellen.
+
+![Konvertierung von Markdown nach HTML, PDF und EPUB](screenshots/md2html-pdf-epub.png)
+
+#### Schritt 4: Erstellung der HTML-Version
+
+```
+pandoc -s --toc --template pandoc-template.html -o erstautorin-2019.html erstautorin-2019.yml erstautorin-2019.md
+```
+
+Manuelle Nacharbeiten:
+
+* Mit Suchen & Ersetzen die Pfadangabe für Bilddateien anpassen, da OJS direkte Links auf Dateinamen der Bilddateien erwartet
+  * Suchen: `img src="./media/`
+  * Ersetzen: `img src="`
+
+#### Schritt 5: Erstellung der PDF-Version
+
+```
+pandoc -s --toc --template pandoc-template.tex -V fontsize=12pt -V papersize=a4paper -V documentclass=article -V headheight=20mm -V headsep=10mm -V footskip=20mm -V top=30mm -V bottom=40mm -V left=25mm -V right=25mm -V graphics=1 -o erstautorin-2019.pdf erstautorin-2019.yml erstautorin-2019.md
+```
+
+#### Schritt 6: Erstellung der EPUB-Version
+
+```
+pandoc -s --toc -o erstautorin-2019.epub erstautorin-2019.yml erstautorin-2019.md
+```
 
-	```
-	pandoc -s -o erstautorin-yyyy-mm-dd.epub erstautorin-yyyy-mm-dd.yml erstautorin-yyyy-mm-dd.md
-	```

example/erstautorin-2019.html

@@ -0,0 +1,182 @@
+<!DOCTYPE html>
+<html lang="de">
+<head>
+  <meta charset="utf-8">
+  <meta name="generator" content="pandoc">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
+  <meta name="author" content="Vorname NACHNAME, Vorname NACHNAME">
+  <title>Deutscher Titel</title>
+  <style type="text/css">code{white-space: pre;}</style>
+</head>
+<body>
+
+<header>
+<p>DOI: <a href="https://doi.org/10.11588/ip.2019.1.52673">https://doi.org/10.11588/ip.2019.1.52673</a></p>
+<p class="author"><b>Vorname NACHNAME, Vorname NACHNAME</b></p>
+<h1 class="title">Deutscher Titel</h1>
+<h3 class="abstract">Zusammenfassung</h3>
+<p>Jeder Artikel muss eine Zusammenfassung in deutscher Sprache enthalten. Die Zusammenfassung soll einen kurzen und vollständigen Überblick über den Inhalt des Artikels geben. Die wichtigsten Ergebnisse, Hintergrund und Vorgehensweise des Artikels sollten klar nachvollziehbar aus der Zusammenfassung hervorgehen. Der Umfang der Zusammenfassung ist auf 700 Zeichen (incl. Leerzeichen) beschränkt. Die Zusammenfassung sollte aus einem einzelnen Absatz bestehen.</p>
+<h3 class="keywords">Schlüsselwörter</h3>
+<p>Schlüsselwort 1, Schlüsselwort 2, Schlüsselwort 3 (max 5)</p>
+
+<h1 class="title">English title</h2>
+<h3 class="abstract">Abstract</h3>
+<p>Every article must contain an English abstract. The abstract is limited to one paragraph and up to 700 characters.</p>
+<h3 class="keywords">Keywords</h3>
+<p>keyword 1, keyword 2, keyword 3 (max 5)</p>
+
+
+<hr>
+<p><b>Veröffentlichung:</b> 10.03.2019 in Informationspraxis Bd. 5, Nr. 1 (2019)</p>
+<hr>
+
+</header>
+
+<h1>Inhaltsverzeichnis</h1>
+<nav id="TOC">
+<ul>
+<li><a href="#einleitung-überschrift-1.-ebene">1 Einleitung (Überschrift 1. Ebene)</a></li>
+<li><a href="#abbildungen">2 Abbildungen</a><ul>
+<li><a href="#zitate-überschrift-2.-ebene">2.1 Zitate (Überschrift 2. Ebene)</a></li>
+<li><a href="#sparsame-formatierung">2.2 Sparsame Formatierung</a><ul>
+<li><a href="#tabellen-überschrift-3.-ebene">2.2.1 Tabellen (Überschrift 3. Ebene)</a></li>
+<li><a href="#listen">2.2.2 Listen</a></li>
+<li><a href="#links">2.2.3 Links</a></li>
+<li><a href="#code-und-datensätze">2.2.4 Code und Datensätze</a></li>
+</ul></li>
+</ul></li>
+<li><a href="#quellen">3 Quellen</a></li>
+</ul>
+</nav>
+<h1 id="einleitung-überschrift-1.-ebene">1 Einleitung (Überschrift 1. Ebene)</h1>
+<p>Titel, Zusammenfassung, Schlüsselwörter und Angaben zu den AutorInnen (alles in deutsch und englisch) bitte ausschließlich im Formular auf der vorherigen Seite. Bitte kein Inhaltsverzeichnis erstellen, das wird von der Redaktion automatisch generiert. Kurze, prägnante Überschriften verfassen und bitte keine (durchgängige) Großschreibung verwenden.</p>
+<p>Wir empfehlen für Kurzbeiträge eine Länge bis etwa 12.000 Zeichen und für Fachbeiträge eine Länge bis etwa 40.000 Zeichen.</p>
+<p>Alle Beiträge erscheinen unter der Lizenz Creative Commons Namensnennung 4.0. Die AutorInnen treten darüber hinaus keine Rechte an Informationspraxis ab.</p>
+<h1 id="abbildungen">2 Abbildungen</h1>
+<p>Abbildungen bitte als Bilddatei einfügen und nicht weiter formatieren. Abbildungen bitte mit Bildunterschriften versehen in der Form „Abb. 1: …" und durchnummerieren.</p>
+<p><img src="./media/image1.png" /></p>
+<p>Abb. 1: Titel Abbildung 1</p>
+<h2 id="zitate-überschrift-2.-ebene">2.1 Zitate (Überschrift 2. Ebene)</h2>
+<p>Kurze Zitate im Fließtext. „Ein wörtliches Zitat soll sehr sparsam eingesetzt werden." (NAME, Vorname &amp; NAME, 2014).</p>
+<p>Längere Zitate einrücken:</p>
+<blockquote>
+<p>„Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier." (NAME, Vorname &amp; NAME, 2014)</p>
+</blockquote>
+<h2 id="sparsame-formatierung">2.2 Sparsame Formatierung</h2>
+<p>Hervorhebungen (<em>kursiv</em>, <strong>fett</strong>) sparsam einsetzen.</p>
+<p>Als weitere Formatierungen sind <sup>hochgestellt</sup>, <sub>tiefgestellt</sub> und <del>durchgestrichen</del> möglich.</p>
+<p>Verwenden Sie Fuß-<a href="#fn1" class="footnote-ref" id="fnref1" role="doc-noteref"><sup>1</sup></a> oder Endnoten<a href="#fn2" class="footnote-ref" id="fnref2" role="doc-noteref"><sup>2</sup></a> allenfalls für notwendige Anmerkungen.</p>
+<h3 id="tabellen-überschrift-3.-ebene">2.2.1 Tabellen (Überschrift 3. Ebene)</h3>
+<p><span id="Tabelle1" class="anchor"></span>Einfache Tabellen ohne weitere Formatierungen können hier erstellt werden. Komplex formatierte Tabellen bitte als Bilddatei einfügen. Alle Tabellen bitte mit einer Bildunterschrift in der Form „Tabelle 1: …" versehen und durchnummerieren.</p>
+<table>
+<thead>
+<tr class="header">
+<th>Spalte 1</th>
+<th>Spalte 2</th>
+<th>Spalte 3</th>
+<th>Spalte 4</th>
+</tr>
+</thead>
+<tbody>
+<tr class="odd">
+<td>Zeile 2</td>
+<td>123,45</td>
+<td>17,2</td>
+<td>1232,23</td>
+</tr>
+<tr class="even">
+<td>Zeile 3</td>
+<td>56,78</td>
+<td>-</td>
+<td>189,9</td>
+</tr>
+<tr class="odd">
+<td>Zeile 4</td>
+<td>198</td>
+<td>67,325</td>
+<td>789567,03</td>
+</tr>
+</tbody>
+</table>
+<p>Tabelle 1: Zahlen und ein Minuszeichen</p>
+<h3 id="listen">2.2.2 Listen</h3>
+<p>Einfache Listen werden unterstützt (spezielle Aufzählungszeichen werden ignoriert)</p>
+<ul>
+<li>Ein Stichpunkt
+<ul>
+<li>Ein Stichpunkt auf zweiter Ebene</li>
+<li>Ein weiterer Stichpunkt auf zweiter Ebene</li>
+</ul></li>
+<li>Ein weiterer Stichpunkt</li>
+</ul>
+<p>Nummerierte Listen werden ebenfalls unterstützt (wird im Layout jedoch immer zu 1,2,3 etc., unabhängig von der gewählten Form der Nummerierung)</p>
+<ol type="1">
+<li>Punkt 1
+<ol type="a">
+<li>Punkt 1.1</li>
+<li>Punkt 1.2</li>
+</ol></li>
+<li>Punkt 2</li>
+</ol>
+<h3 id="links">2.2.3 Links</h3>
+<p>Kurze und bedeutsame URLs können in den Fließtext aufgenommen werden: Zeitschrift Informationspraxis (<a href="http://informationspraxis.de" class="uri">http://informationspraxis.de</a>)</p>
+<p>Lange URLs als betitelte Links einfügen (und lieber nicht als Fußnote): <a href="http://informationspraxis.de/zeitschrift-informationspraxis/richtlinien-fuer-das-open-peer-review/">Richtlinien für das Open Peer Review der Zeitschrift Informationspraxis</a></p>
+<p>Querverweise im Dokument sind möglich, aber nur auf zuvor selbst erstellte Textmarken. Dazu zuerst an die gewünschte Textstelle wechseln und über die Funktion Textmarke eine Textmarke hinzufügen. Anschließend über die Funktion Link (STRG+K) und dann den Button Textmarke die erstellte Textmarke auswählen. Querverweise auf Überschriften werden nicht unterstützt. Beispiel für einen Querverweis: <a href="#Tabelle1">#Tabelle1</a></p>
+<h3 id="code-und-datensätze">2.2.4 Code und Datensätze</h3>
+<p>Code und Datensätze sollten in Artikeln überschaubar bleiben und angemessen beschrieben werden. Der wesentliche Inhalt und Zweck eines Code-Abschnitts sollte auch ohne tiefere Kenntnisse des Datenformates bzw. der Programmiersprache erkennbar sein.</p>
+<p>Für Code-Abschnitte bitte immer die Formatvorlage Source Code verwenden, damit doppelte Leerzeichen usw. erhalten bleiben.</p>
+<pre><code>240 10 _aLiving my life &lt;dt.&gt;
+245 10 _aGelebtes Leben
+       _bAutobiografie
+       _cEmma Goldman. Mit einem Vorw. von Ilija Trojanow.
+250    _aErstausg., 1. Aufl.
+260 3  _aHamburg
+       _bEd. Nautilus
+       _c2010</code></pre>
+<p>Abb. 2: Ausschnitt aus einem MARC-Datensatz</p>
+<p>Umfangreichere Daten und Programme sollten in etablierten Forschungsdaten- und/oder Code-Repositories verfügbar gemacht und im Artikel verlinkt werden.</p>
+<p>Die einer Veröffentlichung zugrunde liegenden Rohdaten sollten - sofern Urheberrecht und Datenschutz dem nicht im Wege stehen - unter der Lizenz CC-BY frei und öffentlich zur Verfügung stehen. Auf re3data.org finden AutorInnen eine große Auswahl an Repositories, auf denen Rohdaten veröffentlicht werden können. Informationspraxis empfiehlt die Nutzung von Zenodo.org. Hier ist eine <a href="https://zenodo.org/collection/user-informationspraxis">Community Informationspraxis</a> eingerichtet, in welche die Daten hochgeladen werden können.</p>
+<p>Informationspraxis empfiehlt die Verwendung von Open-Source-Software. Wenn Sie quelloffene Software zur Verarbeitung von Daten nutzen, sollten Quellcode und Prozess so weit wie möglich nachvollziehbar gemacht werden (R-Skripte etc.). Der Quellcode zu verwendeter Software sollte ebenfalls möglichst offen zur Verfügung stehen.</p>
+<h1 id="quellen">3 Quellen</h1>
+<p>Wir empfehlen den Zitierstil <a href="http://editor.citationstyles.org/styleInfo/?styleId=http%3A%2F%2Fwww.zotero.org%2Fstyles%2Fharvard-gesellschaft-fur-bildung-und-forschung-in-europa">Harvard nach GBFE</a> (Gesellschaft für Bildung und Forschung in Europa; "Harvard author-date style with German Unisa / GBFE changes"). Der Stil befolgt folgende Grundsätze:</p>
+<ul>
+<li>Author-Date Format</li>
+<li>Journal-Namen nicht abgekürzt</li>
+<li>Vorname nicht abgekürzt</li>
+<li>Im Literaturverzeichnis: Nachname, Vorname, und das auch für die/den weitere/n AutorInnen</li>
+<li>Keine Kapitälchen oder durchgehende Großschreibung für egal was</li>
+<li>URL wird genannt</li>
+<li>Name des Journals / übergeordneten Werkes kursiv gesetzt</li>
+<li>ansonsten möglichst einfache Typographie, möglichst nichts anderes kursiv und überhaupt nichts fett, unterstrichen etc.</li>
+</ul>
+<p>Christensen, Anne (29. Aug. 2012): Mentale Modelle: Die Brücke zwischen Discovery Tools und Informationskompetenz? [online]. Zugriff am: 10. Juli 2014. Verfügbar unter: <a href="http://xenzen.wordpress.com/2012/08/29/mentale-modelle-die-brucke-zwischen-discovery-tools-und-informationskompetenz/" class="uri">http://xenzen.wordpress.com/2012/08/29/mentale-modelle-die-brucke-zwischen-discovery-tools-und-informationskompetenz/</a></p>
+<p>Klee, Carsten (2013): Vokabulare für bibliographische Daten. Zwischen Dublin Core und bibliothekarischem Anspruch. In: Patrick Danowski und Adrian Pohl, Hg.: (Open) linked data in Bibliotheken. Berlin: de Gruyter Saur, S. 45-63. Verfügbar unter: <a href="https://doi.org/10.1515/9783110278736.45" class="uri">https://doi.org/10.1515/9783110278736.45</a></p>
+<p>Weinberger, David (2008): Das Ende der Schublade. Die Macht der neuen digitalen Unordnung. München: Hanser.</p>
+<section class="footnotes" role="doc-endnotes">
+<hr />
+<ol>
+<li id="fn1" role="doc-endnote"><p>Eine Fußnote, möglichst wenig verwenden.<a href="#fnref1" class="footnote-back" role="doc-backlink">↩</a></p></li>
+<li id="fn2" role="doc-endnote"><p>Eine Endnote, möglichst wenig verwenden.<a href="#fnref2" class="footnote-back" role="doc-backlink">↩</a></p></li>
+</ol>
+</section>
+
+<hr>
+
+<h2>AutorInnen</h2>
+<ul>
+<li>
+  <div>Vorname Nachname, name@beispiel.de</div>
+  
+  <div><a href="http://example.org">http://example.org</a></div>
+  <div><a href="https://orcid.org/0000-0000-0000-0001">https://orcid.org/0000-0000-0000-0001</a></div>
+</li>
+<li>
+  <div>Vorname Nachname, name@beispiel.de</div>
+  <div>Beispielorganisation, Beispielstraße 123, 00000 Dingshausen</div>
+  
+  
+</li>
+</ul>
+
+</body>
+</html>

example/erstautorin-2019.md

@@ -0,0 +1,118 @@
+1 Einleitung (Überschrift 1. Ebene)
+===================================
+
+Titel, Zusammenfassung, Schlüsselwörter und Angaben zu den AutorInnen (alles in deutsch und englisch) bitte ausschließlich im Formular auf der vorherigen Seite. Bitte kein Inhaltsverzeichnis erstellen, das wird von der Redaktion automatisch generiert. Kurze, prägnante Überschriften verfassen und bitte keine (durchgängige) Großschreibung verwenden.
+
+Wir empfehlen für Kurzbeiträge eine Länge bis etwa 12.000 Zeichen und für Fachbeiträge eine Länge bis etwa 40.000 Zeichen.
+
+Alle Beiträge erscheinen unter der Lizenz Creative Commons Namensnennung 4.0. Die AutorInnen treten darüber hinaus keine Rechte an Informationspraxis ab.
+
+2 Abbildungen
+=============
+
+Abbildungen bitte als Bilddatei einfügen und nicht weiter formatieren. Abbildungen bitte mit Bildunterschriften versehen in der Form „Abb. 1: ..." und durchnummerieren.
+
+![](./media/image1.png)
+
+Abb. 1: Titel Abbildung 1
+
+2.1 Zitate (Überschrift 2. Ebene)
+---------------------------------
+
+Kurze Zitate im Fließtext. „Ein wörtliches Zitat soll sehr sparsam eingesetzt werden." (NAME, Vorname & NAME, 2014).
+
+Längere Zitate einrücken:
+
+> „Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier. Text hier." (NAME, Vorname & NAME, 2014)
+
+2.2 Sparsame Formatierung
+-------------------------
+
+Hervorhebungen (*kursiv*, **fett**) sparsam einsetzen.
+
+Als weitere Formatierungen sind ^hochgestellt^, ~tiefgestellt~ und ~~durchgestrichen~~ möglich.
+
+Verwenden Sie Fuß-[^1] oder Endnoten[^2] allenfalls für notwendige Anmerkungen.
+
+### 2.2.1 Tabellen (Überschrift 3. Ebene)
+
+[]{#Tabelle1 .anchor}Einfache Tabellen ohne weitere Formatierungen können hier erstellt werden. Komplex formatierte Tabellen bitte als Bilddatei einfügen. Alle Tabellen bitte mit einer Bildunterschrift in der Form „Tabelle 1: ..." versehen und durchnummerieren.
+
+| Spalte 1 | Spalte 2 | Spalte 3 | Spalte 4  |
+|----------|----------|----------|-----------|
+| Zeile 2  | 123,45   | 17,2     | 1232,23   |
+| Zeile 3  | 56,78    | \-       | 189,9     |
+| Zeile 4  | 198      | 67,325   | 789567,03 |
+
+Tabelle 1: Zahlen und ein Minuszeichen
+
+### 2.2.2 Listen
+
+Einfache Listen werden unterstützt (spezielle Aufzählungszeichen werden ignoriert)
+
+-   Ein Stichpunkt
+    -   Ein Stichpunkt auf zweiter Ebene
+    -   Ein weiterer Stichpunkt auf zweiter Ebene
+-   Ein weiterer Stichpunkt
+
+Nummerierte Listen werden ebenfalls unterstützt (wird im Layout jedoch immer zu 1,2,3 etc., unabhängig von der gewählten Form der Nummerierung)
+
+1.  Punkt 1
+    a.  Punkt 1.1
+    b.  Punkt 1.2
+2.  Punkt 2
+
+### 2.2.3 Links
+
+Kurze und bedeutsame URLs können in den Fließtext aufgenommen werden: Zeitschrift Informationspraxis (<http://informationspraxis.de>)
+
+Lange URLs als betitelte Links einfügen (und lieber nicht als Fußnote): [Richtlinien für das Open Peer Review der Zeitschrift Informationspraxis](http://informationspraxis.de/zeitschrift-informationspraxis/richtlinien-fuer-das-open-peer-review/)
+
+Querverweise im Dokument sind möglich, aber nur auf zuvor selbst erstellte Textmarken. Dazu zuerst an die gewünschte Textstelle wechseln und über die Funktion Textmarke eine Textmarke hinzufügen. Anschließend über die Funktion Link (STRG+K) und dann den Button Textmarke die erstellte Textmarke auswählen. Querverweise auf Überschriften werden nicht unterstützt. Beispiel für einen Querverweis: [\#Tabelle1](#Tabelle1)
+
+### 2.2.4 Code und Datensätze
+
+Code und Datensätze sollten in Artikeln überschaubar bleiben und angemessen beschrieben werden. Der wesentliche Inhalt und Zweck eines Code-Abschnitts sollte auch ohne tiefere Kenntnisse des Datenformates bzw. der Programmiersprache erkennbar sein.
+
+Für Code-Abschnitte bitte immer die Formatvorlage Source Code verwenden, damit doppelte Leerzeichen usw. erhalten bleiben.
+
+    240 10 _aLiving my life <dt.>
+    245 10 _aGelebtes Leben
+           _bAutobiografie
+           _cEmma Goldman. Mit einem Vorw. von Ilija Trojanow.
+    250    _aErstausg., 1. Aufl.
+    260 3  _aHamburg
+           _bEd. Nautilus
+           _c2010
+
+Abb. 2: Ausschnitt aus einem MARC-Datensatz
+
+Umfangreichere Daten und Programme sollten in etablierten Forschungsdaten- und/oder Code-Repositories verfügbar gemacht und im Artikel verlinkt werden.
+
+Die einer Veröffentlichung zugrunde liegenden Rohdaten sollten - sofern Urheberrecht und Datenschutz dem nicht im Wege stehen - unter der Lizenz CC-BY frei und öffentlich zur Verfügung stehen. Auf re3data.org finden AutorInnen eine große Auswahl an Repositories, auf denen Rohdaten veröffentlicht werden können. Informationspraxis empfiehlt die Nutzung von Zenodo.org. Hier ist eine [Community Informationspraxis](https://zenodo.org/collection/user-informationspraxis) eingerichtet, in welche die Daten hochgeladen werden können.
+
+Informationspraxis empfiehlt die Verwendung von Open-Source-Software. Wenn Sie quelloffene Software zur Verarbeitung von Daten nutzen, sollten Quellcode und Prozess so weit wie möglich nachvollziehbar gemacht werden (R-Skripte etc.). Der Quellcode zu verwendeter Software sollte ebenfalls möglichst offen zur Verfügung stehen.
+
+3 Quellen
+=========
+
+Wir empfehlen den Zitierstil [Harvard nach GBFE](http://editor.citationstyles.org/styleInfo/?styleId=http%3A%2F%2Fwww.zotero.org%2Fstyles%2Fharvard-gesellschaft-fur-bildung-und-forschung-in-europa) (Gesellschaft für Bildung und Forschung in Europa; \"Harvard author-date style with German Unisa / GBFE changes\"). Der Stil befolgt folgende Grundsätze:
+
+-   Author-Date Format
+-   Journal-Namen nicht abgekürzt
+-   Vorname nicht abgekürzt
+-   Im Literaturverzeichnis: Nachname, Vorname, und das auch für die/den weitere/n AutorInnen
+-   Keine Kapitälchen oder durchgehende Großschreibung für egal was
+-   URL wird genannt
+-   Name des Journals / übergeordneten Werkes kursiv gesetzt
+-   ansonsten möglichst einfache Typographie, möglichst nichts anderes kursiv und überhaupt nichts fett, unterstrichen etc.
+
+Christensen, Anne (29. Aug. 2012): Mentale Modelle: Die Brücke zwischen Discovery Tools und Informationskompetenz? \[online\]. Zugriff am: 10. Juli 2014. Verfügbar unter: <http://xenzen.wordpress.com/2012/08/29/mentale-modelle-die-brucke-zwischen-discovery-tools-und-informationskompetenz/>
+
+Klee, Carsten (2013): Vokabulare für bibliographische Daten. Zwischen Dublin Core und bibliothekarischem Anspruch. In: Patrick Danowski und Adrian Pohl, Hg.: (Open) linked data in Bibliotheken. Berlin: de Gruyter Saur, S. 45-63. Verfügbar unter: <https://doi.org/10.1515/9783110278736.45>
+
+Weinberger, David (2008): Das Ende der Schublade. Die Macht der neuen digitalen Unordnung. München: Hanser.
+
+[^1]: Eine Fußnote, möglichst wenig verwenden.
+
+[^2]: Eine Endnote, möglichst wenig verwenden.

example/erstautorin-2019.yml

@@ -0,0 +1,39 @@
+---
+# Von den AutorInnen vergebene Metadaten
+title: Deutscher Titel
+title-en: English title
+author: Vorname NACHNAME, Vorname NACHNAME
+author-detail:
+    - name: Vorname Nachname
+      email: name@beispiel.de
+      url: http://example.org
+      orcid: 0000-0000-0000-0001
+    - name: Vorname Nachname
+      email: name@beispiel.de
+      affiliation: Beispielorganisation
+      address: Beispielstraße 123, 00000 Dingshausen
+abstract:
+    Jeder Artikel muss eine Zusammenfassung in deutscher Sprache enthalten. Die Zusammenfassung soll einen kurzen und vollständigen Überblick über den Inhalt des Artikels geben. Die wichtigsten Ergebnisse, Hintergrund und Vorgehensweise des Artikels sollten klar nachvollziehbar aus der Zusammenfassung hervorgehen. Der Umfang der Zusammenfassung ist auf 700 Zeichen (incl. Leerzeichen) beschränkt. Die Zusammenfassung sollte aus einem einzelnen Absatz bestehen.
+abstract-en:
+    Every article must contain an English abstract. The abstract is limited to one paragraph and up to 700 characters.
+keywords:
+    - Schlüsselwort 1
+    - Schlüsselwort 2
+    - Schlüsselwort 3 (max 5)
+keywords-en:
+    - keyword 1
+    - keyword 2
+    - keyword 3 (max 5)
+
+# Von der Redaktion vergebene Metadaten
+author-short: Nachname/Nachname
+title-short: Kurztitel
+category: Fachbeitrag
+date: 10.03.2019
+received: 10.03.2019
+accepted: 10.03.2019
+identifier: 10.11588/ip.2019.1.52673
+publisher: Informationspraxis Bd. 5, Nr. 1 (2019)
+lang: de
+rights: CC-BY 4.0
+...