Jekyll auf Github Seiten: include Markdown in einer anderen Markdown-Datei

Question

Ich verwende kramdown mit Jekyll auf Github Pages. Ich habe ein Stück Markdown, das ich zweimal verwenden möchte, und möchte nicht zwei Versionen davon beibehalten. Wie kann ich dies in andere Markdown-Dateien einfügen?

Zum Beispiel möchte ich so etwas wie

{: include otherFile.md } 

und haben den Inhalt otherFile.md direkt gerendert geben, wo dieser Befehl ist. Beachten Sie, dass die übergeordnete Datei auch eine Markdown-Datei und keine HTML-Vorlage ist.

Zusätzliche Überlegungen: Es wäre großartig, dies mit dem standardmäßigen GitHub-Seiten-Workflow zu tun und nicht ein Plugin zu verwenden, das von GH-Seiten deaktiviert ist und kompilierte Versionen der Site manuell übertragen muss.

Answer 1

Der Weg zu gehen scheint include_relative zu sein. Ich fand diese Antwort vom Benutzer geraldb auf dem alten Jekyll forums:

Ja, es gibt einen einfachen Weg. Es funktioniert "out-of-the-box" in Jekyll (und GitHub Pages). Habe es einfach ausprobiert. Siehe die Vienna.html Testseite z.B .:

--- 
layout: default 
--- 

some text here 

{% include_relative test_header.md %} 

some more text here 

{% include_relative test_footer.md %} 

die Quelle Siehe -> test.md und die live page.

Der „Trick“, wenn Sie es nennen wollen, so - ist include_relative zu verwenden, wenn Sie die Baustein Texte haben wollen (zB intro.md, explanation.md, conclusion.md, etc.) zusammen mit Ihrer Seite (in der gleicher Ordner). Prost. Glückliches Jekylling.

---

Da ich diese Antwort zuerst geschrieben habe, scheint die ursprüngliche Forum Post vollständig verschwunden zu sein, und ich habe es archive.org archiviert nicht gefunden. Der Antwortlink auf dem alten Forum war this, und das Profil von geraldb im neuen Forum ist here.

Die Links in der zitierten Antwort funktionieren nicht mehr, aber hier ist ein Link zum viennahtml.github.io Repo.