当你知道了Wiki的文本编辑器是如何工作的时候,你此时最好去阅读[WikiEtiquette],这样你才能够掌握最新的Wiki语法...
[{TableOfContents}]
!!快速参考
{{{
---- = 水平线。多余的'-'将被忽略。
// = 强制换行。
[link] = 创建连至内部名为 'link' 的 WikiPage 的超链。
[also a link] = 创建连至内部名为'AlsoALink'页面但显示依然如输入那样带空格的超链。
[例|link] = 创建创建连至内部名为'Link'页面但显示为文本'例'的超链。
[1] = 创建脚注号为1的脚注参考。
[#1] = 设置脚注1。
[[link] = 创建文本'[link]'。
!heading = 小号标题文本 'heading'。
!!heading = 中号标题文本 'heading'。
!!!heading = 大号标题文本 'heading'。
''text'' = 以斜体显示 'text'。
__text__ = 以粗体显示 'text'。
{{text}} = 以等宽字体显示 'text'。
* text = 以文本 'text' 创建普通列表。
# text = 以文本 'text' 创建数字列表。
;term:ex = 以'def'中的文字说明'term'项。
}}}
!!文本编辑
你无需知道任何Wiki的语法规则,像写邮件一样用普通的文本然后再用一个空行来作为段落的标记就行了。
任何时候你都可以对页面进行编辑(看左边的工具栏),再看看使用中的页面发生了什么变化。
!加入图片
你可以插入任何图片到Wiki里面并加入链接,在Wiki页面允许的情况下。
例如,这是一个包含了[PNG]的图片: [http://www.ecyrd.com/~jalkanen/test.png].
如果你制定了一个链接的文本([[this one here|http://example.com/example.png]) ,那么这个链接的文本就会显示在图片没有被显示出来的图片框里面。
你也可以加上一个图片, 并把它指向其他的页面. 看看 [WikiAttachments] 来获得更多的帮助吧.
如果你想更多的控制页面布局,可以使用[Image]插件。它可以实现更多的功能。
Wiki决定着哪些图片是可以支持的. 查看 [SystemInfo] 可以看到一组不同类别的图片类型。
!标题
JSPWiki有3种类型的标题://
小标题 用一个感叹号'!'//
中等标题 用二个感叹号'!!'//
大标题 用三个感叹号'!!!'//
标题会产生一个"命名标记", 你可以从其他页面指到这个页面的标题上。查看 [Named Headings] 获得更多的帮助.
!列表
在一行的开头使用星号(*) 来生成列表.多个星号可以生成多级列表,例子如下:
{{{
* 水果
* MP3
* 电脑
** 联想电脑
}}}
效果如
* 水果
* MP3
* 电脑
** 联想电脑
!数字标题
与列表类似,只是使用了(#) 而不是星号. 如下:
{{{
# 一 标题1
# 二 标题2
# 三 标题3
## 三.一 标题3.1
}}}
效果如
# 一 标题1
# 二 标题2
# 三 标题3
## 三.一 标题3.1
如果一个列表的行使用多行来显示,那么直接在第二行的文本开始加空格直道和第一行对齐就可以了。例:
* 这是一行的列表项.//
* 这是个多行的列表项.//
我们继续在该列表项中添加行.//
现在在第三行了...//
* 这是第三行列表项.//
!定义表注释
一个简单的方法是用 ';:' -创建:
;__创建__:''在这里进行创建的操作''
另一个用法是用 ';:' 来注释别人写的文本, 在定义的是时候使用一个空的 '条件', 像这样:
{{{
;:''这里是注释.''
}}}
显示效果如下:
;:''这里是注释.''
!文本效果
你可以使用 __粗体__ 或 ''斜体'' , 分别使用两个下划线和两个单引号. 如果你使用的是微软的视窗系统,确定你使用了正确的单引号, 因为有很多符号比较类似, 实际上它们不是单引号.
!预格式文本
如果你想建立一个预格式化的文本 (像代码) 使用3个({) 做为开始, 3个(}) 作为结束,中间填写代码.
!!链接部分
链接是Wiki的主要部分.
!链接到Wiki页面
在括号里输入链接页的名字就可以了: [[像这样]. 这将自动创建一个链接的页面。
!链接到外部站点
链接也可以直接指向 http:, ftp:, mailto:, https:, 或 news:, 如果这个链接指向了一个外部地址. 例如, 指向java.sun.com 的主页, 使用 [[http://java.sun.com], 会变成 [http://java.sun.com/]; [[Java home page|http://java.sun.com], 会变成 [Java home page|http://java.sun.com].
!脚注
这是一个特殊的超链接. 在链接的里面只需要使用数字。
像 [[1], 会创建一个脚注[1]. 一个真正的脚注如 [[#1]
会指向你链接的地方. 同过下面的例子来理解脚注.
你也可以使用一个普通的链接作为脚注. 例如, 这个脚注[Footnote number 1|1] 是上面的脚注, 但是这个指向了其他的脚注[2].
!Wiki内部链接
你可以不需要知道URL就指定链接到不同的Wiki中。仅仅使用一个链接从[[Wiki:WikiPage] 并且 JSPWiki 会为你创建一个链接. 例如, 这个链接指到[JSPWiki TextFormatting rules|JSPWiki:TextFormattingRules]. 查看 [SystemInfo] 获得更多帮助。
如果Wiki不支持内部的链接, 当你保存的时候会得到一个提示信息。
!!表格
你可以使用('|')来创建简单的表格。使用两个竖杠('||')作为表格的标题,使用一个竖杠来生成表格的行。
例如:
{{{
|| 标题1 || 标题2
| ''咯咯咯'' | 酒吧
| [主要链接] | [动物世界]
}}}
你也可以在表格中加入链接,效果如下:
|| 标题1 || 标题2
| ''咯咯咯'' | 酒吧
| [主要链接] | [动物世界]
!!样式
%%commentbox
__你好!注意这里__//
这个评论窗口使用了"commentbox"的样式, 该样式定义在 "jspwiki.css" 样式表中. 制作一个同样的样式,你可以使用 {{{%%commentbox <这里是填写的文本内容> %%}}}.
%%
除了Wiki样式表提供的样式外,我们也可以使用自定义的样式表。如:
{{{
%%small
这里的文本使用了小一些的字体
%%
}}}
使用了css的"small", 同样在jspwiki.css文件中有定义。 也有可能这些css定义在不同的站点之间,这取决于这些站点的管理员如何定义这些css文件。
你甚至可以定义任何的CSS:
{{{
%%( font-size: 150%; color: red; )
你好,世界!
%%
}}}
将显示为:
%%( font-size: 150%; color: red; )
你好, 世界!
%%
__注意__ 如果你想结束这个CSS使用{{{%%}}}!
!!管理你的Wiki
!冲突
如果某人和你正在编辑同一个页面,JSPWiki将给你一个提示,首先改变页面的人会成功...
__警告的话:__ 如果你使用返回按钮进入到编辑页面,你也会看到一个提示。此时浏览器认为你仍然在编辑一个早期的副本。
!删除页面
每个页面的下面都有“更多信息”的链接. 如果你点击他, 你就会进入一个页面,这个页面可以删除或者恢复该文章以往的版本。 注意可能Wiki的管理员不允许用户删除页面。
!添加新页面
创建一个链接指向一个新的页面使用 [WikiName]。
点击那个新的链接, 链接的后缀将会出现一个?并且页面会跳到编辑一个新页面上。
!添加附件
如果Wiki管理员已经配置了它, 将会在每个页面的底部出现 "添加附件" 的链接。 点击它你可以上传附件,查看 [WikiAttachments]获得更多帮助。
!!使用变量
在JSPWiki里,有一些系统定义好的或者用户自定义的变量,我们可以在自己的Wiki页面里读取并显示这些变量. 基本格式为:
!插入变量
你可以在页面里插入很多变量:
{{ [[{$variablename}], }}
__注意__: 变量名是不区分大小写的, "paGeNamE" 与 "PageName" 表示相同的变量.
你可以在[WikiVariables]里面找到变量的用法。
!加入插件
加入插件的基本语法是:
[[{INSERT <plugin class> WHERE param1=value, param2=value, ...}]
更多的信息请查看 [JSPWikiPlugins].
!插入表单
请查看 [WikiForms].
----
[#1] 这里是上面提及的脚注
[The other footnote|#2] 其他的脚注. 注意它们的名字为什么不同?