如何使 Emacs org 文档在 github 存储库中更漂亮？答案

【问题标题】：How can I make Emacs org docs more beautiful in github repository?如何使 Emacs org 文档在 github 存储库中更漂亮？
【发布时间】：2013-04-15 14:02:31
【问题描述】：

github 支持多种标记语言，其中一种是Emacs org mode docs。

但是使用默认的 CSS 文件总是看起来很难看（比不过，默认的是内置 org 模式。
此外，似乎 源代码块也没有语法高亮。

那么是否可以通过对 org 文件进行一些小的更改来使其更美观？或者你能给我一些建议或好的做法吗？

【问题讨论】：

最近的 org-mode 增加了对 markdown 的导出，你不妨试试看。
@rvf0068 哪个版本？你有没有尝试过，感觉如何？
参见例如github.com/rvf0068/org-document-test，文件 README.md 是从 first.org 导出的。这是使用 org 的开发版本（来自 git）。
@rvf0068 是的，这样更好。但并没有我想象的那么好。
有一个源代码块问题的错误报告：github.com/github/markup/issues/186 不过还没有活动。

标签： emacs github markdown markup org-mode

【解决方案1】：

Github 使用 org-ruby 将 org-mode 转换为 html。似乎最新版本的 org-ruby 支持小写 org-mode 关键字和源代码块中的语法突出显示（以及其他好东西）。在官方 Github 升级之前，看起来唯一的选择是使用大写 BEGIN_SRC/END_SRC 或将您的 org 文件导出到 emacs 中的 html/md 并使用您喜欢的任何选项/css/etc 并将生成的文件发布到Github。

【讨论】：

【解决方案2】：

Githubs Org-Mode 支持已升级但 #+TITLE: 不受支持，例如大多数有问题的链接。所以它主要工作。

【讨论】：