Wie kann ich Emacs-Org-Dokumente im github-Repository schöner gestalten?

Question

github unterstützt mehrere Auszeichnungssprachen, von denen eine Emacs org mode docs ist.

1. Aber es sieht immer hässlich mit der Standard-CSS-Datei (viel besser als der Standard einer eingebauten in org-Modus, though.
2. Auch scheint es, dass der Quellcodeblock nicht hat Hervorhebungs entweder.

So ist es möglich, es schöner mit einigen geringfügigen Änderungen in org Dateien zu machen? oder können Sie mir einige Ratschläge oder gute Praxis geben?

Answer 1

Github verwendet org-ruby, um den Organisationsmodus in HTML zu konvertieren. Es scheint, dass neuere Versionen von org-ruby sowohl Kleinbuchstaben im Org-Modus als auch Syntax-Highlighting in den Quellcode-Blöcken unterstützen (neben anderen netten Dingen). Bis es im offiziellen Github aktualisiert wird, sieht es so aus, als ob die einzigen Optionen entweder Großbuchstabe BEGIN_SRC/END_SRC oder Export der Org-Dateien nach html/md in Emacs mit allen Optionen/CSS/etc sind, die Sie möchten und die resultierenden Dateien hochladen Github.

Answer 2

Githubs Org-Modus Unterstützung ist aktualisiert aber # + TITLE: wird nicht unterstützt, wie Links, die meist abgehört werden. So funktioniert es meistens.