Emacswiki - C-x C-s

来源:百度文库 编辑:神马文学网 时间:2024/06/12 14:24:35
Emacswiki
这套插件是用来在单机上建立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-keyemacs-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-cC-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"")(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"")
然后在发布网页的目录里加入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