本页面描述了 JSPWiki 所使用的 wiki 语法。有关 JSPWiki 语法和 Wikipedia 的区别的详细信息,请参考 MigratingFromMediaWiki


如果您已经明白编辑器如何工作,那么您应该看看 SimplifiedChinese.WikiEtiquette,以便了解如何使用刚学到的技术。沙盒 是一个用来练习的好地方。

快速参考#

----       = 生成水平线。多余的 '-' 将被忽略。
\\         = 强制换行

[link]     = 创建一个到名为 "Link" 的内部 Wiki 页面的超链接。
[this is also a link] = 创建一个到名为 'ThisIsAlsoALink' 的内部 Wiki 页面,链接则显示为带空格的输入内容。
[a sample|link] = 创建一个到名为 "Link" 的内部 Wiki 页面的超链接,但给用户显示的是文本 "a sample"create a hyperlink to an  而非 "Link"。
~NoLink    = 禁止给以驼峰字(CamelCase)形式书写的词创建链接。
[1]        = 引用脚注 1。
[#1]       = 标记为脚注 1。
[link]     = 创建文本 '[link]'。

!heading   = 文本为 'heading' 的小标题
!!heading  = 文本为 'heading' 的中标题
!!!heading = 文本为 'heading' 的大标题

''text''   = 以斜体显示 'text'。
__text__   = 以粗体显示 'text'。
{{text}}   = 以等宽字体显示 'text'。
[text]    = 给 'text' 加上下划线(空白超链接)
* text     = 给 'text' 加上项目符合
# text     = 给 'text' 加上编号
;term:ex   = 对 'term' 以解释 'ex' 做了定义

撰写文本#

您不必了解有关 Wiki 文本格式化规则以使用 Wiki。只需要撰写正常的文本,然后用空行标记一个段落。 就像写电子邮件一样。 您始终可以编辑这个页面(看一下左边的侧栏)看看这个页面所使用的各种效果。

超链接#

链接也可以是直接以http:ftp:mailto:https:news: 开头的 URL,在这种情况下,链接指向外部实体。例如,要指向 java.sun.com 的主页,就要使用 [http://java.sun.com],它会是 http://java.sun.com/ 或者使用 [Java 主页|http://java.sun.com],则会是 Java 主页。 如果链接不以上面的“协议”开头,那么 Wiki 会将其认作链接到 Wiki 空间中其他页面的普通链接,您需要以字母作为这个页面的第一个字符,纯粹数字的页面名是不允许的。如果要在页面中使用方括号([])而不想创建链接,就用两个开口的方括号([[)。所以文本 [[Example Non-Link],会显示为 [Example Non-Link][Murali]。 要添加新页面,您只需要从其他地方创建一个指向它的链接即可。毕竟,要一个不能访问的页面意义不大!在返回到那个页面的时候,您会发现页面名称后面有个小问号。然后,点击这个问号,这样您就创建了一个页面。 在一个 WikiName 中,几乎可以使用任何字符,不过他们要是字母或数字才行。 另外有一点,本 Wiki 可以通过配置来支持标准的驼峰字 CamelCase 连接(如果支持,只要不以 '' 开头,单词 CamelCase 应该就是一个链接)。缺省情况下这个功能是关闭的,当然如果管理员已经将这个设置打开的话,那么 CamelCase 就是你要的了。

脚注#

脚注是一种特殊类型的超链接。创建脚注十分简单,只需在脚注要引用到的超链接中加入数字即可,例如 [1]。 实际使用的时候,把脚注 [#1] 放到应指向的位置。 如下所示。 您还可以创建一个带名字的脚注,方法和创建普通超链接相同。比如 [Footnote name|1],也是引用第一个脚注 [Footnote name]的一种方式。也可以把自定义的名字用作脚注本身,如“Footnote name[2]”。

InterWiki 链接#

您还可以在不同的 Wiki 之间做链接,不一定要知道具体的 URL。只需要使用此格式“[Wiki:WikiPage]”,JSPWiki 会自动帮您创建链接。例如,这个链接是指向 JSPWiki TextFormatting rules。关于哪些 WiKi 链接可用的更多信息,可查看 SimplifiedChinese.SystemInfo 页面。 如果不支持 InterWiki 链接,当您保存这个页面时会收到通知。

添加图片#

您可以把图片嵌入到 wiki 代码里,只要该图片在网络上可用,并且符合以下格式,然后只需链接过去。 如果指定链接文本([this one here|http://example.com/example.png]),对于无法查看或不想查看图片的人,即可显示 ALT 文本。 允许的图片类型取决于 Wiki。您可以查看 SystemInfo 页面获取图片类型列表。 还可以使用 Image plugin 格式控制图片的位置和属性。 要在图片后添加空行,可以使用三个反斜杠(\ \ \)。

符号列表#

可以在第一列使用一个星号(*)来添加符号列表。增加星号数量可添加更多的缩进。例如:
* One \\ one and a half
* Two
* Three
** Three.One
creates
  • One
    one and a half
  • Two
  • Three
    • Three.One

数字列表#

与符号列表类似,只要把星号换成井号(#)。例如:
# One \\ one and a half
# Two
# Three
## Three.One
creates
  1. One
    one and a half
  2. Two
  3. Three
    1. Three.One
如果您想在把列表中的项写到多个行中,只需在下一行中添加一个或多个空格,该行即会自动添加到前一个中。 例如:
* This is a single-line item.
* This is actually a multi-line item.
  We continue the second sentence on a line on a line of its own.
  We might as well do a third line while we're at it...
  Notice, however, as all these sentences get put inside a single item!
* The third line is again a single-line item for your convenience.
显示结果是:
  • This is a single-line item.
  • This is actually a multi-line item. We continue the second sentence on a line on a line of its own. We might as well do a third line while we're at it... Notice, however, as all these sentences get put inside a single item!
  • The third line is again a single-line item for your convenience.

定义列表和注释#

定义列表的一个简单方法是使用 ';:' -construct:
;__Construct__:''Something you use to do something with''
显示结果是:
Construct
Something you use to do something with
用 ';:' 的另一个好处是,您可以用它在别人的文本上添加简短的注释,方法是在定义中放一个空的 'term',例如: ;:''Comment here.'' 显示出来的结果是
Comment here.

文本效果#

您可以使用 bold 文本或 italic 文本,方法是分别使用两个下划线(_)和两个单引号(')。如果您使用的是 Windows 电脑,请确保使用了正确的单引号,因为有另外一个看起来很像,但实际上是错误的。 下划线 underscore 效果可以用超链接来实现,但并不链接到其他地方,如 [like this|]

格式化文本#

如果您想添加一些已经含有固定格式的文本(比如代码),只需使用三个连续的括号“({)”新开始一个区域,然后用三个连续的括号“(})”结束这一区域。编辑此页面做个例子。 ({)java.package.pseudocode.class(})

#

您可以做一些简单的表格,使用竖线 ('|')。双竖线符号表示开始一张表,单竖线符号表示书写表中的行。 可以用表以外的行结束该表。 例如:
|| Heading 1 || Heading 2
| ''Gobble'' | Bar \\ foo
| [Main] | [SandBox]
会显示成以下表。注意在表的内部是如何使用链接的。
Heading 1 Heading 2
Gobble Bar
foo
Main SandBox

CSS 样式#

如果不想像多数文本那样遵循简单的原则,可以在行内使用 CSS 样式 can be used inline 对页面中想要特别强调的部分做修饰。

冲突#

如果有人和您同时对某页面进行编辑,JSPWiki 会阻止您进行修改并显示冲突页面。遗憾的是,首先修改的人会修改成功... 警告信息: 如果您使用浏览器的后退按钮返回编辑页面,通常会引起冲突。这是因为浏览器会认为您还是编辑以前的页面。

删除页面#

这是不可能的。当然,您可以删除对该页面的所有链接,这样这个页面就无法访问了。或电子邮件给管理员,我会帮您删除此页面。您也可以添加一个 DELETEME 链接。

添加新页面#

可以创建一个链接指向新的页面(尚未存在的),方法是使用它的Wiki名字,如 WikiName. 如果现在单击该新链接,会显示一个问号 (?) 后缀,您将获取新页面的编辑权限。 -- Asser

页面别名识别#

有时候您想链接到某个 wiki 页面,以便立即浏览到其他页面。这可以使用“页面别名”来进行。

插入变量#

可以在页面上插入很多种变量。基本的格式为: [{$variablename}], 其中 variablename 是要插入的变量的名称。注意变量名称是不区分大小写的 - 即“pagename”和“paGeNamE”以及“PageName”都是一样的。 您可以在此页面查看可用的变量列表:WikiVariables

插入插件#

插入插件的基本语法如下: [{INSERT <plugin class> WHERE param1=value, param2=value, ...}] 可查看此页面获取更多信息:JSPWikiPlugins.
[#1] 这是我提到过的脚注。 [2-The other footnote] 另外一个脚注。注意到名字的区别了吗?
有任何意见吗 意见? 有任何问题吗 问题


sssssssssssssd

--AnonymousCoward, 15-十月-2009 18:21


测试一下:)

Add new attachment

Only authorized users are allowed to upload new attachments.
« This page (revision-13) was last changed on 11-Jan-2012 05:16 by 114.247.224.62