Emacswiki - C-x C-s

这套插件是用来在单机上建立wiki页的，适合做笔记，网站，用法很简单，除了输入内容基本就没别的要求了。不过因为文件名不能是中文，索引用处不大。

关于emacs-wiki的教程网上到处都是，以下为非常非常基础的用法:

例子：如何建立一个wiki项目

安装

我用Debian，所以只要apt安装（注：不知道以后的版本还会不会包含 emacs-wiki，因为该项目已经不更新了，由muse-mode继承）

以下是我的.emacs相关设置，应该是从帮助文档里或别人的网站上弄来的──因为我不会写elisp

;;\begin{for emacs-wiki}
(require 'emacs-wiki)

(add-hook 'emacs-wiki-mode-hook (lambda () (define-key
emacs-wiki-mode-map (kbd "C-c C-h") 'emacs-wiki-preview-html)
(define-key emacs-wiki-mode-map (kbd "C-c C-c")
'emacs-wiki-preview-source) (define-key emacs-wiki-mode-map (kbd "C-c
C-v") 'emacs-wiki-change-project)
))

(setq emacs-wiki-directories '("~/WiKi"))

;for Chinese support
(setq emacs-wiki-meta-charset "gb2312")
(setq emacs-wiki-charset-default "gb2312")

(setq emacs-wiki-style-sheet
  "<link rel=\"stylesheet\" type=\"text/css\" href=\"article.css\" />")

(setq emacs-wiki-inline-relative-to 'emacs-wiki-publishing-directory)

(defun emacs-wiki-preview-source ()
  (interactive)
  (emacs-wiki-publish-this-page)
  (find-file (emacs-wiki-published-file)))

(defun emacs-wiki-preview-html ()
  (interactive)
  (emacs-wiki-publish-this-page)
  (browse-url (emacs-wiki-published-file)))

(setq emacs-wiki-projects
      `(("default" . ((emacs-wiki-directories . ("~/WiKi"))))
        ("Articles" . ((emacs-wiki-directories . ("~/Articles"))
(emacs-wiki-publishing-directory . "~/WebArticles")))
        ("WikiPlanner" . ((emacs-wiki-directories . ("~/Articles"))
(emacs-wiki-publishing-directory . "~/WebPlanner")))
        ("WikiNotes" . ((emacs-wiki-directories . ("~/WikiNotes"))
(emacs-wiki-publishing-directory . "~/WebNotes")))))
;;\end{for emacs-wiki}

使用

按照以上的设置，开始编辑WikiNotes项目：

M-x emacs-wiki-change-project

输入项目名称 WikiNotes，Emacs自动进入目录~/WikiNotes，并且网页会发布到~ /WebNotes。当然目录可以在.emacs里自由设置。

加入 EmacsNotes 条目

C-c C-f

输入 EmacsNotes, 这会在~/WikiNotes目录创建一个空白文档 EmacsNotes 。现在处于活动窗口的应该是 EmacsNotes，只要编辑即可。markup规则可以在 /usr/share/doc/emacs-wiki找到，或者google

发布该页：

C-c C-p

默认首页为WelcomePage, 所以为了在首页加入EmacsNotes链接，打开 WelcomePage并在该文件页面输入EmacsNotes，然后会自动生成EmacsNotes链接

如果要加入其它条目，可以先在WelcomePage输入名称，然后进入相应页面编辑（直接在名称处回车即可，当然名称必须是大小写结合的WikiName，也叫CamelCase）

比较丢人的是，我花了很长时间才知道原来WelcomePage里要写东西才会生成链接，我还以为是自动的呢。EmacsWiki的确会帮你生成链接，但它可不会帮你管理条目，所以首页还是要自己编辑。

css可以自己定制，在~/.emacs里加入

(setq emacs-wiki-style-sheet
 "<link rel=\"stylesheet\" type=\"text/css\" href=\"article.css\"
 />")

然后在发布网页的目录里加入article.css即可，以下为一个不怎么样的例子

BODY {
	color: #000000;
	background: #d3dcf4;
	padding: 0px, 70px, 70px, 70px;
	font-family: arial, helvetica, sans-serif;
}

P {
	font-size: 14px;
	line-height: 19px;
	font-family: arial, helvetica, sans-serif;
	padding-right: 50px;
}

H1 {
	font-size: 30px;
	font-weight: bolder;

	background-color: #758fd9;
	background-position: right;
	color: #c3cff1;

	font-family: arial, helvetica, sans-serif;
}

H2 {
	font-size: 20px;
	font-family: arial, helvetica, sans-serif;
}

HR {height: 1px;}

pre {
	padding-left: 2%;
	background-color: #B1BDC9;
	font-size: 14px;
	font-family: courier, fixed, monospace;
}

TABLE {
	text-align: center;
	border: 1px #DDDDDD;
}

A:link {color: #5770ba; text-decoration:none;}
A:visited {color: #2a3a68; text-decoration:none;}
A:active {color: #2a3a68; text-decoration:none;}
A:hover {color: #5770ba; text-decoration:underline;}

有用的快捷键

C-x 4 a	把变更写入更新日志，也就是该页面底部的Changes
C-c C-h	发布索引，也就是底部的Index