用Emacs/Muse/Dot写技术文档

      这几个月来都是在Emacs里学习和开发Javascript，却还真没有用Emacs来写过技术文档，尤其有插图的时候几乎不敢想怎么能用Emacs来完成文档，更别说“生活在Emacs里”了。不过经过一天（就是一天）的时间，终于集网络大成，总结了一套在Emacs下完成图文并茂文档写作的经验。在可以写作之前你需要以下的环境。

一、软件安装

1. Muse

    首先，你需要安装Muse，这是专门为写作（侧重于Publish）开发的Emacs插件。非常简单的几个语法，一个小时的学习基本上就可以上手，当然一些复杂的定制就需要花更多的时间去学习了。网址在

在我的系统理(FreeBSD 8.2/64)，Muse安装在~/.emacs.d/elpa/muse-3.20里。

2. Htmlize

    这是一个可以将代码格式化成HTML的Emacs插件，会按照你的代码LANG-mode的语法高亮来生成HTML，它被Muse使用来处理内嵌在文档里的代码。el文件可以到下载。

文件下载来以后，放在~/.emacs.d/elpa/htmlize下。并编译成elc。  

3. Graphviz-dot

    这是一个用于Graphviz的dot语言编辑的Emacs插件，支持dot语言的语法高亮以及图片预览。dot语言，要上手很快，也是一两个小时，当然要精通估计是很难的。el文件可以到下载。

文件下载来以后，放在~/.emacs.d/elpa/dot下。并编译成elc。

4. Graphviz

  AT＆T贡献的大名鼎鼎的跨平台图形生成工具，装她是为了dot语言，具体的可以访问

二、配置.emacs

    以下几行分别配置了 Muse, Htmlize, Dot

;; Muse
(setq load-path (append (list (expand-file-name "~/.emacs.d/elpa/muse-3.20")) load-path))
(autoload 'muse-mode "muse" nil t)
(add-to-list 'auto-mode-alist '("\\.muse$" . muse-mode))
(require 'muse-html)

;; Htmlize
(setq load-path (append (list (expand-file-name "~/.emacs.d/elpa/htmlize")) load-path))
(require 'htmlize)

;; Dot
(setq load-path (append (list (expand-file-name "~/.emacs.d/elpa/dot")) load-path))
(autoload 'graphviz-dot-mode "graphviz-dot-mode" nil t)
(add-to-list 'auto-mode-alist '("\\.dot$" . graphviz-dot-mode))

三、有图有真相

先看图，看到真相以后，估计才就会有兴趣去尝试。



未完待续...