diff --git a/Makefile b/Makefile index 99cef94..0bc7547 100644 --- a/Makefile +++ b/Makefile @@ -1,4 +1,4 @@ -default: vorlage.pdf vorlage.html vorlage.docx +default: vorlage.pdf vorlage.html vorlage.docx vorlage.odt # Artikel-Vorlage für Pandoc (LaTeX und HTML) TEMPLATE=informationspraxis-artikel-vorlage @@ -38,6 +38,9 @@ LATEX_OPTIONS+=-V graphics=1 .md.docx: cat $(patsubst %.md,%.yml,$<) $< | pandoc -s -S -o $@ - +.md.odt: + cat $(patsubst %.md,%.yml,$<) $< | pandoc -s -S -o $@ - + clean: rm -f *.log *.aux *.toc *.out diff --git a/README.md b/README.md index 23b6073..e4c369b 100644 --- a/README.md +++ b/README.md @@ -2,36 +2,62 @@ Dieses git-Repository enthält Vorlagen für Artikel der Fachzeitschrift [Informationspraxis](http://informationspraxis.de/) sowie Skripte zur Konvertierung der Artikel nach HTML und PDF. +# Verwendung der Vorlage zum Verfassen eigener Artikeln + +Die Vorlage besteht aus zwei Dateien: + +* Die Datei **vorlage.yml** für die Metadaten des Artikels + (Titel, Autor, Abstract...) +* Eine der folgenden Dateien für den Artikeltext: + * **vorlage.md** zum Verfassen in Markdown-Syntax + * **vorlage.docx** zum Verfassen mit Word + * **vorlage.odt** zum Verfassen mit Libre/Open Offixe + +Die Verwendung anderer Dokumentformate (LaTeX, Google Docs etc.) ist ebenfalls +möglich, allerdings werden diese zunächst nach Markdown umgewandelt, wobei es +zu Fehlern kommen kann. + +Bitte benennen Sie beide Dateien einheitlich um und behalten die Dateiendung +bei, beispielsweise + +* vorlage.yml $\Rightarrow$ meinartikel.yml +* vorlage.docx $\Rightarrow$ meinartikel.docx + +Bei Bedarf können Sie Ihre Artikel wie im Folgenden beschrieben nach HTML +und/oder PDF konvertieren, um das fertige Layout des Artikels zu überprüfen. + +# Konvertierung nach HTML und PDF + Die Konvertierung benötigt das Program [Pandoc](johnmacfarlane.net/pandoc/) -sowie zur Erzeugung von PDF eine LaTeX-Umgebung und GNU make. +sowie zur Erzeugung von PDF eine LaTeX-Umgebung und das Systemprogramm make. +Die Konvertierung nach HTML und PDF -Der Inhalt der Vorlage befindet sich in Markdown-Syntax in der Datei - -* `vorlage.md` - -und die dazugehörigen Metadaten in der Datei - -* `vorlage.yml` - -Unter einem Unix-System mit LaTeX und Pandoc lässt sich die Vorlage -folgendermaßen nach PDF, HTML und DOCX konvertieren: - - make - -Die HTML-Version ist bislang noch nicht angepasst und die DOCX-Version enthält -(absichtlich) keine Metadaten sondern nur den Artikelinhalt. - -# Anleitung +## Vorbereitung Pro Artikel muss eine Markdown-Datei mit dem Artikelinhalt (Dateieindung `.md`) und eine YAML-Datei mit den Metadaten (Dateiendung `.yml`) angelegt werden. Die Markdown-Datei kann beispielsweise mit durch Konvertierung aus dem DOCX-Format (Word) mit Pandoc erstellt werden. - pandoc -o artikel.md artikel.docx + pandoc meinartikel.docx -o meinartikel.md -Die YAML-Datei muss mit einem Texteditor angepasst werden. Anschließend können -PDF- und HTML-Version folgendermaßen erstellt werden: +Die YAML-Datei muss ggf. mit einem Texteditor angepasst werden. - make artikel.pdf artikel.html +## Konvertierung der Markdown-Datei + +PDF- und HTML-Version können mit folgendem Aufruf auf der Kommandozeile +erstellt werden: + + make meinartikel.html + make meinartikel.pdf + +# Stand der Umsetzung + +Unter einem Unix-System mit LaTeX und Pandoc lässt sich die Vorlage +folgendermaßen nach PDF, HTML, DOCX und ODT konvertieren: + + make + +Die HTML-Version ist bislang noch nicht angepasst und die DOCX-Version enthält +(absichtlich) keine Metadaten sondern nur den Artikelinhalt. diff --git a/informationspraxis-artikel-vorlage.html b/informationspraxis-artikel-vorlage.html index 14bff62..d14cc9b 100644 --- a/informationspraxis-artikel-vorlage.html +++ b/informationspraxis-artikel-vorlage.html @@ -37,26 +37,58 @@ $endfor$ $for(include-before)$ $include-before$ $endfor$ -$if(title)$ +
+
+ $for(author)$$author.name$$sep$, $endfor$ +

$title$

-$if(subtitle)$ -

$subtitle$

-$endif$ -$for(author)$ -

$author$

-$endfor$ -$if(date)$ -

$date$

-$endif$ +

Zusammenfassung

+

$abstract$

+

Schlüsselwörter

+

$for(keywords)$$keywords$$sep$, $endfor$

+ +

$title-en$

+

Abstract

+

$abstract-en$

+ +

Keywords

+

$for(keywords-en)$$keywords-en$$sep$, $endfor$

+ +

Classification

+

$for(jita)$$jita$$sep$, $endfor$

+ +
+

+ Einreichung / Annahme / Veröffentlichung: + $received$ / $accepted$ / $published$ +

+
-$endif$ + $if(toc)$ $endif$ $body$ + +

AutorInnen

+ + $for(include-after)$ $include-after$ $endfor$ diff --git a/vorlage.html b/vorlage.html new file mode 100644 index 0000000..3e4f0b2 --- /dev/null +++ b/vorlage.html @@ -0,0 +1,156 @@ + + + + + + + Deutscher Titel + + + + + +
+
+ Vorname Nachname, Vorname Nachname +
+

Deutscher Titel

+

Zusammenfassung

+

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

+

Schlüsselwörter

+

Schlüsselwort 1, Schlüsselwort 2, Schlüsselwort 3, …

+ +

English title

+

Abstract

+

Every article must conatain an English abstract. The abstract is limited to one paragraph and up to 700 characters.

+ +

Keywords

+

keyword 1, keyword 2, keyword 3, …

+ +

Classification

+

A. Theoretische und allgemeine Aspekte von Bibliotheken und Informationen, GI. Weiterbildung

+ +
+

+ Einreichung / Annahme / Veröffentlichung: + 6.10.2014 / 12.11.2014 / 3.12.2014 +

+ +
+ +

1. Einleitung

+

Diese Vorlage ist nicht aktuell und dient lediglich als Platzhalter!

+

Text hier. Und hier ist ein in eigenen Worten wiedergegebenes Zitat. (vgl. AutorIn & AutorIn, 2009). Text hier. Text hier. Text hier. Pro Kapitel mind. eine halbe Seite. Text hier. Text hier.

+
+ +
+

Abb. 1: Titel Abbildung 1 (normale Option)

+

Siehe Einleitung

+

2 Überschrift 1. Ebene

+

Text hier. Text hier. Text hier. “Ein wörtliches Zitat soll sehr sparsam eingesetzt werden.” (NAME, Name & NAME, 2014) Text hier. Text hier. Text hier. Text hier.1

+

Abb. 2: Titel Abbildung 2 (Option für breite Abbildungen)

+

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. Text hier. Text hier. Text hier.

+

2.1 Überschrift 2. Ebene

+

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. Text hier. Text hier. Text hier.1

+

2.2 Überschrift 2. Ebene

+

Text hier. Text hier. Hervorhebungen sparsamund immer nur kursiv einsetzen. 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.2 Verwenden Sie nicht die automatisierten Aufzählungen Ihres Textprogrammes. Aufzählungszeichen Minus Leerzeichen Text der Aufzählung.
- Liste

+ +

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.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Wahllos eingegebene Zahlen und ein Minuszeichen

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

+

2.2 Listen

+

Verwenden Sie nicht die automatisierten Aufzählungen Ihres Textprogrammes. Einfache Listen: Minus Leerzeichen Text der Aufzählung.

+ +

Nummerierte Listen: Nummer Punkt Leerzeichen Text der Aufzählung.

+
    +
  1. Nummerierte Liste

  2. +
  3. Nummerierte Liste

  4. +
  5. Nummerierte Liste

  6. +
+

2.2.2 Programmcode und Datensätze

+

Programmcode 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. Die Code-Abschnitte werden in einer 1x1 Tabelle gesetzt. Bei Bedarf können sie auch mit einem Titel versehen werden, die Nummerierung erfolgt allerdings als Abbildung (“Abb. X”)!

+
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. 3: Ausschnitt aus einem MARC-Datensatz

+

Umfangreichere Daten und Programme sollten in etablierten Forschunsgdaten- und/oder Code-Repositories verfügbar gemacht und im Artikel verlinkt werden.

+

3 Quellen

+

Nachname, Vorname (xx. Jan. 2012): Titel: Untertitel[online]. Zugriff am: 10. Aug. 2014]. Verfügbar unter: http://www.adresse.de/titel/name_name_titel_name/

+

Nachname, Vorname (2009): Titel des unselbständigen Werkes. In: Nachname, Vorname und Nachname, Vorname, Hg.: Der Titel des selbständigen Titels. Ort: Verlag, S. von-bis

+

Nachname, Vorname Vorn. (2013): Titel: Untertitel. Ort: Verlag.

+

Nachname, Vorname, Nachname, Vorname & Nachname, Vorname (2010). Titel des Artikels. In: Titel des Journals109, 2, S. 16–26. [Zugriff am 10. Aug. 2014]. DOI: http://dx.doi.org/10.2403/jo.nam.2010.07.008.

+
+
+
    +
  1. Eine Fußnote. So wenige wie möglich verwenden

  2. +
  3. Leider funktionieren bei Google keine Endnoten, aber das wäre unsere Empfehlung für die eingereichten Artikel

  4. +
+
+ +

AutorInnen

+ + + + diff --git a/vorlage.odt b/vorlage.odt new file mode 100644 index 0000000..63b7965 Binary files /dev/null and b/vorlage.odt differ