Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- allgemein:howto:pandoc [2016/03/06 15:38] – 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 ====
+===== 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 Ordnet besteht aus folgender Struktur
+Der Ordner besteht aus folgender Struktur
 <code>
-name
+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
@@ Zeile 194: / Zeile 199: @@
 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>
@@ Zeile 199: / Zeile 220: @@
 Folgende Tools werden benötigt bzw. damit geht es am schnellsten.
- * R-Programmiersprache (https://cran.r-project.org/bin/windows/base/)
+  * R-Programmiersprache (https://cran.r-project.org/bin/windows/base/)
- * RStudio (https://www.rstudio.com/products/rstudio/download/)
+  * RStudio (https://www.rstudio.com/products/rstudio/download/)
- * pandoc (https://github.com/jgm/pandoc/releases)
+  * pandoc (https://github.com/jgm/pandoc/releases)
- * MikTex (http://miktex.org/2.9/setup)
+  * 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.
@@ Zeile 209: / Zeile 230: @@
+====== 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>