Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- allgemein:howto:pandoc [2016/03/05 21:27] – richard
+++ allgemein:howto:pandoc [2025/11/19 16:39] (aktuell) – Externe Bearbeitung 127.0.0.1
@@ Zeile 123: / Zeile 123: @@
-====== knitr - Der kleine Helfer ======
+===== knitr - Der kleine Helfer =====
 Tool zu Vereinfachung der Ausgabe kann folgendes Tool verwendet werden.
 http://yihui.name/knitr/demo/pandoc/
@@ Zeile 170: / Zeile 170: @@
 Um ''R'' wieder verlassen zu können muss man folgendes Command eingeben:
-<code>''q()'' </code>
+<code>q() </code>
+IDE für markdown mit knitr Support:
+https://www.rstudio.com/products/rstudio/download/
+===== Template für ein Arbeitsblatt =====
+Das Rstudio ist sehr komfortabel, allerdings möchte man nicht bei jedem neuen Dokument alles erneut einstellen. Daher helfen ein paar kleine Eingriffe, um schnell neue Dokumente
+generieren zu können.
+Rstudio unterstützt Templates. Diese liegen unter Ubuntu in folgendem Ordner:
+Unter Linux:
+<code>/usr/local/lib/R/site-library/rmarkdown/rmarkdown/templates</code>
+Unter Windows:
+<code>C:\Programme\RStudio\R-3.2.3\library\rmarkdown\rmarkdown\templates</code>
+Dort befindet sich pro Template ein Ordner.
+Der Ordner besteht aus folgender Struktur
+<code>
+template_name
+    resources -> z.B. css-Dateien für HTML-Output
+    skeleton -> hier liegen alle Dateien, die für ein neues Dokument benötigt werden
+    template.yaml -> Name und Beschreibung des Templates für Rstudio
+</code>
+Ich habe mir ein Satz zusammengestellt, um meine Arbeitsblätter zu generieren. Diese sind sicherlich nicht perfekt, aber für den Anfang ausreichend.
+{{:allgemein:howto:arbeitsblatt_template.zip|Arbeitsblatt_template}}
+Das Archive enthält die Ordnerstruktur, die in den ''templates''-Ordner von R als ''root'' kopiert werden muss.
+Danach steht die neue Vorlage im Rstudio zur Verfügung.
+===== knitr und pandoc automatisch in Rstudio laden =====
+Da ich es als lästig empfinde die hauptsächlich eingesetzten Bibliotheken immer wieder neu laden zu müssen, habe ich nach einer Lösung gesucht, um diese während des Starts von
+R gleich mit zu laden. Da Rstudio die Standard R-Umgebung als Konsole anbietet, schlägt man gleich zwei Fliegen mit einer Klappe.
+Die Lösung ist denkbar simpel. R lädt u.a. eine Datei ''.Rprofile'', die im Hauptordner des Users liegen muss. Dort kann man häufig benötigte Bibliotheken einbinden.
+Unter Linux:
+<code>/home/USERNAME/</code>
+Unter Windows:
+<code>C:\Users\USERNAME\Documents\</code>
+In der folgende Beispieldatei wird ''knitr'' geladen, so dass der ''pandoc''-Befehl unter ''R'' direkt ausgeführt werden kann.
+<file bash .Rprofile>
+library(knitr)
+</file>
+======= pandoc/latex/knitr unter Windows ======
+Folgende Tools werden benötigt bzw. damit geht es am schnellsten.
+  * R-Programmiersprache (https://cran.r-project.org/bin/windows/base/)
+  * RStudio (https://www.rstudio.com/products/rstudio/download/)
+  * pandoc (https://github.com/jgm/pandoc/releases)
+  * MikTex (http://miktex.org/2.9/setup)
+Die Reihenfolge ist sinnvoll, damit keine Fehlermeldungen entstehen. Über das RStudio können weitere Pakete für MikTex bzw. R nachgeladen werden.
+====== pandoc output ======
+===== Math und das Format-Problem =====
+https://github.com/jgm/pandoc/issues/1938
+Formelsatz in ''markdown'' kann sehr unschöne Ergebnisse hervorbringen, um diese in den Griff zu bekommen sind einige Handgriff notwendig. Hier wird versucht eine Lösung für folgende Kombinationen anzubieten.
+  * ''markdown'' -> ''PDF''
+  * ''markdown'' -> ''dokuwiki''
+  * ''markdown'' -> ''epub''
+  * ''markdown'' -> ''HTML''
+Als Beispiel-Code soll folgender Schnipsel dienen:
+<code>
+Ein wenig Mathematik
+$$
+\begin{align}
+x&=\frac{3}{5}\label{eq:1}\\
+y&=2
+\end{align}
+$$
+End of math. $\eqref{eq:1}$
+</code>
+<code>
+pandoc math.txt -t html -s -o test.html --mathjax=https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML -H mathjax-header-include.txt
+</code>
+<file html mathjax-header-include.txt>
+<script type="text/x-mathjax-config">
+    MathJax.Hub.Config({ TeX: { equationNumbers: {autoNumber: "all"} } });
+  </script>
+</file>