Как сделать Emacs org docs более красивым в репозитории github?

github поддерживает несколько языков разметки, один из которых - Emacs org mode docs.

Но он всегда выглядит уродливым с файлом CSS по умолчанию (намного лучше, чем тем не менее, по умолчанию используется встроенный режим org.
Также кажется, что блок исходного кода также не имеет подсветки синтаксиса.

Итак, можно ли сделать его более красивым с некоторыми незначительными изменениями в файлах org? Или вы можете дать мне совет или хорошую практику?

Ответ 1

Github использует org-ruby для преобразования org-mode в html. Похоже, что последние версии org-ruby поддерживают как ключевые слова орг-режима в нижнем регистре, так и подсветку синтаксиса в блоках исходного кода (среди других приятных вещей). Пока он не обновлен в официальном Github, похоже, что единственными вариантами являются либо использование верхнего регистра BEGIN_SRC/END_SRC, либо экспорт ваших файлов org в html/md в emacs с любыми параметрами /css/etc, которые вам нравятся, и публикация полученных файлов на Github.

Ответ 2

Поддержка Gigubs Org-Mode обновляется, но # + TITLE: не поддерживается, как ссылки, которые в основном прослушиваются. Поэтому он работает в основном.