updated README and examples on citations

2022-07-03 17:19:20 +02:00
parent c8c2dd4044
commit d0e72bd152
5 changed files with 48 additions and 18 deletions
@@ -0,0 +1,7 @@
+
+@book{zotero-54,
+  title = {Ein {{Beispiel Buch}}},
+  author = {Mustermann, Max}
+}
+
+
@@ -19,6 +19,8 @@ student:
  stammkurs: 14 5
 nur-nachname: true
 datum: 21. Dezember 1999
+csl: ../csl/tgs-weimar-seminarfach.csl
+bibliography: ./Bibliografie.bib
 ---

 # Einleitung
@@ -29,6 +31,8 @@ Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor i

 Sequitur sunt tota Democriti, atomi, inane, imagines, quae eidola nominant, quorum incursione non solum videamus, sed etiam praetereat omnes voluptates, dolores denique quosvis suscipere malit quam deserere ullam officii partem, ad ea, quae dices, libenter assentiar. Probabo, inquit, modo ista sis aequitate.

+Hier könnte etwas stehen das ich aus einem Buch zitiere[@zotero-54, S. 21 ff] .
+
 Familiaritatem effecerit, tum amorem efflorescere tantum, ut, etiamsi nulla sit utilitas ex amicitia, tamen ipsi amici propter se esse iucunda, per se ipsa allicit nec patientia nec assiduitas nec vigiliae nec ea ipsa, quae ab illo est, tum innumerabiles mundi, qui et oriantur et intereant cotidie. Quae.

 # Erstes Kapitel
@@ -57,5 +61,3 @@ Familiaritatem effecerit, tum amorem efflorescere tantum, ut, etiamsi nulla sit
 : Eine Beispiel Tabelle

 Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquip ex ea commodi consequatur? quis autem vel eum iure reprehenderit, qui in ea voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa.
-
-Sequitur sunt tota Democriti, atomi, inane, imagines, quae eidola nominant, quorum incursione non solum videamus, sed etiam praetereat omnes voluptates, dolores denique quosvis suscipere malit quam deserere ullam officii partem, ad ea, quae dices, libenter assentiar. Probabo, inquit, modo ista sis aequitate.
@@ -50,6 +50,28 @@ Falls ein Deckblatt generiert werden soll müssen diese Variablen gesetzt werden

 Um eine eigenes Latex-Deckblatt zu benutzen muss `deckblatt-datei: Pfad-zur-datei` angegeben werden, z.B. `deckblatt-datei: ./deckblatt.tex`

+### Zitieren
+
+Um Zitate in den Fußnoten nach den Vorgaben zu formatieren, kann diese [CSL-Datei](csl/tgs-weimar-seminarfach.csl) benutzt werden. Dazu muss diese im Header angegeben werden.
+
+```yaml
+csl: ./tgs-weimar-seminarfach.csl
+```
+
+Damit Es überhaupt etwas zu Zitieren gibt, wird eine Bib-Latex Datei benötigt. Diese kann einfach aus [Zotero](https://www.zotero.org/) mit dem [Better Bibtex Addon](https://retorque.re/zotero-better-bibtex/installation/) exportiert werden. Dabei müssen sogenannte Citation-Keys für jeden Eintrag (Quelle) [gesetzt werden](https://alix-lahuec.gitbook.io/zotero-roam/getting-started/prereqs#setup-checklist). Dann können die Quellen in eine Bib-Latex Datei exportiert werden, in dem beim Rechtsklick auf die Sammlung oder Bibliothek exportiern gewählt wird und im erscheinenden Menü das Format zu Better Biblatex gesetzt wird und und besten auch noch "Halte aktuell" ausgewählt wird. In der Markdown-Datei kann dann so die Quelle angegeben werden:
+
+```md
+Ich zitiere: „Sein oder Nichtsein, das ist hier die Frage“[@citationkey].
+```
+
+Und im Header muss der Pfad zu `.bib` Datei angegeben werden z.B.:
+
+```yaml
+bibliography: ./meine_bibliografie
+```
+
+(Unter Windows werden Pfade etwas anders mit einem Backslash (` \ `) angegeben)
+
 ### Beispiele

 #### Yaml Kopf
@@ -76,6 +98,8 @@ student:
  stammkurs: 14 5
 nur-nachname: true
 datum: 21. Dezember 1999
+csl: ./tgs-weimar-seminarfach.csl
+bibliography: ./meine_bibliografie.bib
 ---
 ```

@@ -92,7 +116,7 @@ datum: 21. Dezember 1999
 + Befehl:

 ```bash
-pandoc file.md --standalone --template=seminarfach -o outputfile.pdf --pdf-engine=xelatex
+pandoc file.md --standalone --template=seminarfach -o outputfile.pdf --pdf-engine=xelatex -C
 ```

 # Ressourcen
@@ -104,8 +128,9 @@ pandoc file.md --standalone --template=seminarfach -o outputfile.pdf --pdf-engin

 + [ ] definition von `documentclass` unnötig machen 
 + [ ] vielleicht generelle einführung in Pandoc
-+ [ ] Richtige Zitierweise implementieren siehe [CSL](https://github.com/citation-style-language/styles)
+ [x] Richtige Zitierweise implementieren siehe [CSL](https://github.com/citation-style-language/styles)
 	+ [CSL-Editor](https://editor.citationstyles.org/about/)
 	+ [Pandoc-citations](https://pandoc.org/MANUAL.html#citations)
 	+ Vorlagen die möglicherweise passen: [1](https://editor.citationstyles.org/styleInfo/?styleId=http%3A%2F%2Fwww.zotero.org%2Fstyles%2Fneuroimaging-clinics-of-north-america), [2](https://editor.citationstyles.org/styleInfo/?styleId=http%3A%2F%2Fwww.zotero.org%2Fstyles%2Fbritish-journal-of-dermatology)
 	+ und dann natürlich noch erklären eg. .bib datein etc.
+ [ ] Wenn Dokumentation etc. zu viel wird zu wiki umsteigen
@@ -11,7 +11,7 @@
      <email>tgs.info.oskar@gmail.com</email>
    </author>
    <summary>Seminarfach</summary>
-    <updated>2022-07-02T19:51:04+00:00</updated>
+    <updated>2022-07-03T14:27:08+00:00</updated>
    <rights>This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 License</rights>
  </info>
  <macro name="author">
@@ -40,27 +40,23 @@
      </else>
    </choose>
  </macro>
-  <citation>
-    <layout vertical-align="sup">
-      <text variable="citation-number" vertical-align="sup" display="block"/>
-    </layout>
-  </citation>
-  <bibliography>
-    <layout>
-      <text variable="citation-number" suffix=" "/>
+  <citation name-form="short">
+    <layout vertical-align="baseline">
      <choose>
        <if match="any" position="ibid-with-locator">
          <text term="ibid"/>
        </if>
+        <else-if match="any" position="ibid">
+          <text term="ibid"/>
+          <text variable="page"/>
+        </else-if>
        <else>
          <text macro="author"/>
          <text macro="title"/>
+          <text variable="page" suffix="."/>
        </else>
      </choose>
-      <text variable="page" suffix="."/>
-      <choose>
-        <if match="any" position="ibid-with-locator"/>
-      </choose>
    </layout>
-  </bibliography>
+  </citation>
+  <bibliography/>
 </style>