Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Cleanup Structures: Include Markdown Files #27

Open
cagix opened this issue Jul 18, 2022 · 0 comments
Open

Cleanup Structures: Include Markdown Files #27

cagix opened this issue Jul 18, 2022 · 0 comments

Comments

@cagix
Copy link
Owner

cagix commented Jul 18, 2022

Einbindung der einzelnen Markdown-Dateien:

Beachten: Targets im Makefile sollen nur ausgeführt werden, wenn es wirklich was zu tun gibt - wenn sich die Sourcen geändert haben. Wenn die Sourcen in einem eigenem Template oder einem Defaultfile gezogen werden, müsste man sie entweder im Makefile erneut definieren oder aber einfach immer übersetzen ...

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)?

Siehe auch #60

@cagix cagix added this to the framework overhaul milestone Jul 18, 2022
@cagix cagix self-assigned this Jul 18, 2022
@cagix cagix removed their assignment Jun 27, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant