pandoc-thesis icon indicating copy to clipboard operation
pandoc-thesis copied to clipboard

Cleanup Structures: Frontmatter, Include-Header, ...

Open cagix opened this issue 1 year ago • 0 comments

Da fliegen viele Dateien herum, die an irgendeiner Stelle irgendwie eingebunden werden:

  • titlepage.tex (--include-in-header)
  • include-header.tex (--include-in-header für CleanThesis)
  • frontmatter.tex (--include-before-body)
  • references.md (geht am Ende vom Content mit)
  • backmatter.tex (--include-after-body)

Diese Dateien sollten zumindest in einen "versteckten" Ordner verschoben werden.

Welche Strukturen/Dateien brauchen wir wirklich noch? Was kann irgendwie anders realisiert werden, etwa per Definition im entsprechenden Defaultfile?

references.md könnte durch ein eigenes Markdown-Template eingespart werden (vgl. #27).

Ein eigenes Markdown-Template könnte die Struktur des Gesamtdokuments deutlicher machen. Außerdem könnten Teile wie "references.md" direkt eingebunden werden und müssten nicht als Dummy-Datei definiert werden. Möglicher Nachteil: Es müsste zunächst von Markdown nach Markdown übersetzt werden, und Pandoc ist da teilweise etwas zu eifrig mit dem Escaping ... Außerdem ist die Templatesyntax evtl. störend?

Eigenes Markdown-Template: Einbinden anderer Dateien (auf der selben Ebene!) via ${ abstr.md() } funktioniert, TeX-Befehle bleiben erhalten. Problem: $ wird als besonderes Zeichen erkannt, d.h. die eingebundenen Dateien dürften Markdown enthalten, aber kein $ (bzw. man müsste jedes $ mit einem weiteren $ escapen, also statt $e=m*c^2$ müsste man $$e=m*c^2$$ schreiben). => Template mit Dokumentstruktur und Einbinden der Markdown-Inhalte per lokalem Link (plus Filter, der die Links auflöst)?

Spezifikation von Footern etc. im YAML-Header (aus https://github.com/Wandmalfarbe/pandoc-latex-template/issues/381#issuecomment-2040707574):

header-includes: 
- \usepackage{lastpage}
footer-left: "\\thepage \\hspace{1pt} / \\pageref*{LastPage}"
``

cagix avatar Jul 18 '22 16:07 cagix