Как сделать 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: не поддерживается, как ссылки, которые в основном прослушиваются. Поэтому он работает в основном.