Emacs Wiki
时间:2009-05-22 来源:wnsfzf
Emacs Wiki
Emacs-wiki写笔记写网页,真是太方便了,本主页这么多页面全都是Emacs-wiki写成的。你在写笔记的时候,不需要管什么时候画表格,不需要管什么时候更改标题文字大小,基本上你只需要写你要写的文字,emacs-wiki就能根据你设定的模板自动给你生成你的网页。
Emacs-wiki学起来不是很难,学会WikiMarkup,搞好.emacs中wiki的部分,找一个好的css就可以了。
初学可以参考薛瑞尼的主页1,bethoven的主页,王垠的主页, 苏勇的主页等,或者去newsmth的Emacs板.
学会emacs
当然首先,你要学会emacs,emacs是很好的东西,你可以用它来收发email,听音乐,查看图片,写TeX文档,浏览网页,关键看你怎么配置~/.emacs了。
配置可以看我的.emacs配置中相应部分,如果仅仅是用wiki,那么可以注释掉其他的部分。或者查看上面其他人的.emacs
要学会emacs的基本操作,其实,emacs的操作也不是很难,慢慢就能习惯的。
emacs最常用的两个键是ctrl和meta键,对一般的键盘而言, meat键就是alt键。以后用C来代表ctrl,用M代表alt。比如C-x表示按住ctrl键,同时按下x键,然后同时松开。
其他的各种操作先不管,先记得
C-x C-c 表示退出emacs C-x C-s 表示存储 C-x C-f 表示查找某文件,若写一个从前没有的名字表示新建文件
其他的可以慢慢学,可以C-h看帮助,或者网上查找中文tutorial,半个小时就能学会,当然要记住要习惯需要不断使用。
认识WikiMarkup
然后应该学习认识WikiMarkup,这个不长,一会儿就能明白,要找到WikiMarkup也不难,只要baidu就能搜索到中文版的,用google去搜索英文版的吧。比如这个
建立工作目录
现在开始写wiki了,首先新建你的工作目录,仿照薛瑞尼的方法,有几个方面的笔记,就建立几个目录,同一方面的在一个目录内,自然生成的html也在相应的一个目录内,当然,建立一个default的虚拟目录。浏览一下我的wiki的各方面内容就能明白我是怎样设置的。
设置css
现在开始找一个好的css了,当然自己做也可以,但初学者还是有点难,这里,我用的是薛瑞尼的,知道了他的目录结构,就能找到css文件的所在,然后用wget或者其他网页下载工具就可以下载了,然后自己来用。一般把css及相关的图片单独存放在一个文件夹中。比如我的css文件叫做core.css
安装emacs和emacs-wiki
在开始写wiki之前,可能有人还不知道怎么在电脑中安装emacs和emacs-wiki。在linux中,这些很简单,只需要你在aptitude中选中emacs和emacs-wiki就可以了。如果你的操作系统是windows,这需要麻烦一点,当然也不是很麻烦的,参考bethoven的方法,没有wiki的具体安装也可以参考auctex等的安装方式。 ntemacs下载也可以去http://www.emacs.cn, 那里还提供wiki的练习。
开始写wiki了
比如
#title 电力系统的稳定性.....
#style ../css/core.css
在下面就可以写你要写的内容了。
两点经验
说两个我学习过程中遇到的感觉很难,搞定后发现很简单的东西,大概这就是入门必须经历的阶段吧。
1,经常看到许多代码放在一个暗色的区域里,可是那么多攻略教程都没有说怎么搞的,把我郁闷了,到处找答案,还是搞不定。偶然尝试WikiMarkup里面说的原文环境. 就有那种很好看的区域了。比如
<example>
main()
{
}
</example>
效果如下:
main() { }
2,锚引用,同项目内文件引用和跨projects引用很长时间都没有搞定,后来才发现应该加[[]] 即
[[wikiname#anchorname]]或者[[wikiname]]或者[[projectname#wikiname]]
效果如下 wikiname#anchorname或者wikiname或者projectname#wikiname
如何在科大主页服务器建立个人主页
在unix和linux系统中,每个文件和目录都有读、写、执行的权限,且还有对属主,对同组,对其他人的区分,所以就有类似如下的
drwxr-xr-x 10 1284 500 4096 Jun 08 13:12 public_html
d表示目录,r w x分别表示可读,可写,可执行,-则表示相应权限没有。第一组表示属主,第二组表示同组,第三组表示其他人。
在科大主页服务器202.38.64.10中,因为考虑安全,chmod命令无效,修改权限只能使用umask的命令.
umask指的是在指定位置没有所指定的权限。
比如 umask 022 是说,新建文件时,文件的权限是755,(755=777-022)
如果要想上传主页内容,必须在上传之前,使用命令
quote site umask 022
然后才能建立public_html文件夹
mkdir public_html
若之前已经有过public_html文件夹,可以删掉
rm -rf public_html
然后重新设定umask,再建立public_html
以后使用ftp软件,比如linux的lftp,比如windows下面的cuteftp等, 把写好的html文件上传到public_html文件夹,这里,我们是把用emacs-wiki生成的html文件上传去。
[1]我现在的css是来自薛瑞尼的主页