emacs Wiki Markup

emacs Wiki Markup
2007-04-24 13:14标题
* 一级标题
** 二级标题
*** 三级标题

注意 一级标题在生成的代码中实际上是使用H2标识的，以便于和文件的抬头有所区别。
水平线
----
强调
*强调*
**更强的强调**
***最强的强调***
_带下划线的文字_
=等宽文字（仅对ASCII字符有效）=
用于大块文字的等宽环境（仅对ASCII字符有效）

强调
更强的强调
最强的强调
带下划线的文字
等宽文字（仅对ASCII字符有效）
用于大块文字的等宽环境（仅对ASCII字符有效）
脚注

用方括号括起来的数字，就标识了一个引用1。
用方括号括起来的数字，就标识了一个引用[1]。



1 引用条目的数字标号与引用处方括号内的数字相同。你可以使用footnote-mode的快捷键C-c !来方便的在编辑的同时加入脚注，然后使用C-x C-x来返回插入脚注的地点。
段落

用一个或多个空白行来分隔段落。
居中段落和引用文字

一个居中段落用6列以上的空白字符（空格或者制表符）来标识。如果你用快捷键M-s来使得段落居中，通常会在段落前面加入很多空格，因此我做了这样的假定。

以空白字符起始的行，但是少于6列时，则标识了一行引用文字。
诗篇

诗歌通常需要保留空白字符，但是你并不想仅仅求助于HTML标签“PRE”。因此设计了如下特殊标签，它会使你想起Email中的引用文字
> 这是一行关于Emacs的诗；
> 请原谅它如此的简洁

如果你喜欢，也可以使用verse标签
<verse>
这是一行关于Emacs的诗；
请原谅它如此的简洁
</verse>
原文环境

使用HTML标签

可以插入一个段落并且保留其中的空白字符。当你在页面中加入程序片断的时候，可能会在 pre标签中不停的使用等宽环境，以避免生成页面时的替换。使用标签，你可以更加快捷的做到这一点。

一些原样输出的文字或者代码。

一些原样输出的文字或者代码。
列表
- 圆点列表项
1. 数字列表项
项 :: 定义
圆点列表项
数字列表项
项
定义
表格

支持两种形式的表格标签。如果安装了Takaaki Ota编写的table.el话，那么请使用它创建你的表格，这些表格会被输出成为合适的HTML代码。

如果你没有安装table.el，那么只能支持简单的表格标签。生成表格的属性由变量emacs-wiki-table-attributes控制。语法则如下：
双竖线 || 区分首行表格列
单竖线 | 区分普通表格列
再来一些 | 表格列
三竖线 ||| 区分末行表格列双竖线 区分首行表格列
单竖线 区分普通表格列
再来一些 表格列
三竖线 区分末行表格列


其它的关于段落的标签对于两种表格形式都适用，即如果6列以上的空白字符出现在的首行的前面，表格将被居中；如果首行前面有空白字符，表格将被之置于引用标签（blockquote）之内。
锚（anchor）和标记链接（tagged links）
#anchor 以"#anchor"开始的行

以"#anchor"开始的行

将创建一个文档中的锚，注意#标记后的文字不能含有空格，且不会在输出网页中显示出来。

你可以在其它页（或者就是本页）中如下引用这个锚代表的文档位置
WikiName#anchor

例如WikiMarkup:anchor

不管是在定义处还是引用处，文字#anchor永远不会在生成的HTML中显示出来。但它只会使得点击时让浏览器跳转到文档的相应位置。
重定向到其它的网页

需要重定向到其它的网页时，你可以在页面的顶端输入


如果你指定了转向的内容，那么本页将会被当作转向前的说明，而不是默认页面。

转向延迟的时间可以在变量emacs-wiki-redirect-delay中设定，默认是2秒。转向前显示出来的页面将会包含一个链接，用于那些不支持自动转向的浏览器情况。
链接

直接输入URL就可以自动生成链接。如果是一个指向图片的URL，输出时将使用IMG标签。
嵌入式Lisp
<lisp>(concat "This from gets" "inserted")<lisp>
对WikiNames的特殊处理

如果你需要在WikiName后面加入复数标记，用四个引号分隔它们：
WikiName''''s

如果要阻止链接名字或者其它文字作标签转换，可以如同等宽字体一样用等号将其括起来，或者在其前面加入nop标签－例如：
WikiTag
特殊的Wiki链接

除开标准的WikiName类型的链接，emacs-wiki还支持扩展类型的链接：

这里是Wiki标签说明
[[WikiMarkup][这里是Wiki标签说明]]

尽管看起来不同，扩展类型的链接也是链接的一种。这意味着你可以使用任何emacs-wiki-directories变量所指定目录中的文件做为一个Wiki文件。你可以提供描述性文字用来取代链接本身被显示出来，这在提供URL的文本描述时非常有用。
InterWiki名字

有时可能需要经常引用其它网站的页面。为了避免重复输入URL的乏味操作，你可以定义InterWiki名字。它是一组WikiName到URL 的映射，可以在文本中被自动替换，且支持锚（锚将被附加在URL的后面）。例如，假设变量emacs-wiki-interwiki-names定义 MeatballWiki这个名字，就意味着你可以如下引用MeatballWiki网站上的MeatBall页面：

MeatballWiki:MeatBall
MeatballWiki#MeatBall