src/wikipages/zh_CN/TextFormattingRules.txt - jspwiki - Git at Google

 本页面描述了 JSPWiki 所使用的 wiki 语法。有关 JSPWiki 语法和 Wikipedia 的区别的详细信息，请参考 [MigratingFromMediaWiki|http://www.jspwiki.org/wiki/MigratingFromMediaWiki]。

 [{TableOfContents }]
 \\
 如果您已经明白编辑器如何工作，那么您应该看看 [WikiEtiquette]，以便了解如何使用刚学到的技术。[沙盒|http://sandbox.jspwiki.org] 是一个用来练习的好地方。
 !快速参考
 {{{
 ----       = 生成水平线。多余的 '-' 将被忽略。
 \\         = 强制换行

 [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 主页|http://java.sun.com]。
 如果链接不以上面的“协议”开头，那么 Wiki 会将其认作链接到 Wiki 空间中其他页面的普通链接，您需要以字母作为这个页面的第一个字符，纯粹数字的页面名是不允许的。如果要在页面中使用方括号（{{[[]}}）而不想创建链接，就用两个开口的方括号（{{[[[}}）。所以文本 {{[[[Example Non-Link]}}，会显示为 {{[[Example Non-Link]}}[[Murali]。
 要添加新页面，您只需要从其他地方创建一个指向它的链接即可。毕竟，要一个不能访问的页面意义不大！在返回到那个页面的时候，您会发现页面名称后面有个小问号。然后，点击这个问号，这样您就创建了一个页面。
 在一个 [WikiName|http://www.jspwiki.org/wiki/WikiName] 中，几乎可以使用任何字符，不过他们要是字母或数字才行。
 另外有一点，本 Wiki 可以通过配置来支持标准的驼峰字 [CamelCase|http://www.jspwiki.org/wiki/CamelCase] 连接（如果支持，只要不以 '~' 开头，单词 CamelCase 应该就是一个链接）。缺省情况下这个功能是关闭的，当然如果管理员已经将这个设置打开的话，那么 CamelCase 就是你要的了。
 !脚注
 脚注是一种特殊类型的超链接。创建脚注十分简单，只需在脚注要引用到的超链接中加入数字即可，例如 {{[[1]}}。
 实际使用的时候，把脚注 {{[[#1]}} 放到应指向的位置。
 如下所示。
 您还可以创建一个带名字的脚注，方法和创建普通超链接相同。比如 {{[[Footnote name|1]}}，也是引用第一个脚注 [Footnote name|1]的一种方式。也可以把自定义的名字用作脚注本身，如“Footnote name[2]”。
 ![InterWiki|http://www.jspwiki.org/wiki/InterWiki] 链接
 您还可以在不同的 Wiki 之间做链接，不一定要知道具体的 URL。只需要使用此格式“{{[[Wiki:WikiPage]}}”，JSPWiki 会自动帮您创建链接。例如，这个链接是指向 [JSPWiki TextFormatting rules|JSPWiki:TextFormattingRules]。关于哪些 WiKi 链接可用的更多信息，可查看 [SystemInfo] 页面。
 如果不支持 [InterWiki|http://www.jspwiki.org/wiki/InterWiki] 链接，当您保存这个页面时会收到通知。
 !添加图片
 您可以把图片嵌入到 wiki 代码里，只要该图片在网络上可用，并且符合以下格式，然后只需链接过去。
 如果指定链接文本（{{[[this one here|http://example.com/example.png]}}），对于无法查看或不想查看图片的人，即可显示 ALT 文本。
 允许的图片类型取决于 Wiki。您可以查看 [SystemInfo] 页面获取图片类型列表。
 还可以使用 [Image plugin|http://www.jspwiki.org/wiki/Image] 格式控制图片的位置和属性。
 要在图片后添加空行，可以使用三个反斜杠（\ \ \）。
 !符号列表
 可以在第一列使用一个星号（*）来添加符号列表。增加星号数量可添加更多的缩进。例如：
 {{{
 * 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
 # One \\ one and a half
 # Two
 # Three
 ## 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 |http://www.jspwiki.org/wiki/CSSInWikipages] 对页面中想要特别强调的部分做修饰。
 !冲突
 如果有人和您同时对某页面进行编辑，JSPWiki 会阻止您进行修改并显示冲突页面。遗憾的是，首先修改的人会修改成功...
 __警告信息：__ 如果您使用浏览器的后退按钮返回编辑页面，通常会引起冲突。这是因为浏览器会认为您还是编辑以前的页面。
 !删除页面
 这是不可能的。当然，您可以删除对该页面的所有链接，这样这个页面就无法访问了。或电子邮件给管理员，我会帮您删除此页面。您也可以添加一个 [DELETEME|JSPWiki:DELETEME] 链接。
 !添加新页面
 可以创建一个链接指向新的页面（尚未存在的），方法是使用它的Wiki名字，如 [WikiName|http://www.jspwiki.org/wiki/WikiName].
 如果现在单击该新链接，会显示一个问号 (?) 后缀，您将获取新页面的编辑权限。
 -- [Asser|http://www.jspwiki.org/wiki/Asser]
 !页面别名识别
 有时候您想链接到某个 wiki 页面，以便立即浏览到其他页面。这可以使用“页面别名”来进行。
 !插入变量
 可以在页面上插入很多种变量。基本的格式为：
 {{ [[{$variablename}], }}
 其中 ''variablename'' 是要插入的变量的名称。注意变量名称是不区分大小写的 - 即“pagename”和“paGeNamE”以及“PageName”都是一样的。
 您可以在此页面查看可用的变量列表：[WikiVariables|http://www.jspwiki.org/wiki/WikiVariables]。

 !插入插件
 插入插件的基本语法如下：
 [[{INSERT <plugin class> WHERE param1=value, param2=value, ...}]
 可查看此页面获取更多信息：[JSPWikiPlugins | http://www.jspwiki.org/wiki/JSPWikiPlugins].
 ----
 [#1] 这是我提到过的脚注。
 [2-The other footnote|#2] 另外一个脚注。注意到名字的区别了吗？
 ----
 有任何意见吗 [意见 | http://www.jspwiki.org/wiki/IdeasTextFormattingRules]？
 有任何问题吗 [问题 | http://www.jspwiki.org/wiki/TextFormattingRulesDiscussion]？
	本页面描述了 JSPWiki 所使用的 wiki 语法。有关 JSPWiki 语法和 Wikipedia 的区别的详细信息，请参考 [MigratingFromMediaWiki\|http://www.jspwiki.org/wiki/MigratingFromMediaWiki]。

	[{TableOfContents }]
	\\
	如果您已经明白编辑器如何工作，那么您应该看看 [WikiEtiquette]，以便了解如何使用刚学到的技术。[沙盒\|http://sandbox.jspwiki.org] 是一个用来练习的好地方。
	!快速参考
	{{{
	---- = 生成水平线。多余的 '-' 将被忽略。
	\\ = 强制换行

	[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 主页\|http://java.sun.com]。
	如果链接不以上面的“协议”开头，那么 Wiki 会将其认作链接到 Wiki 空间中其他页面的普通链接，您需要以字母作为这个页面的第一个字符，纯粹数字的页面名是不允许的。如果要在页面中使用方括号（{{[[]}}）而不想创建链接，就用两个开口的方括号（{{[[[}}）。所以文本 {{[[[Example Non-Link]}}，会显示为 {{[[Example Non-Link]}}[[Murali]。
	要添加新页面，您只需要从其他地方创建一个指向它的链接即可。毕竟，要一个不能访问的页面意义不大！在返回到那个页面的时候，您会发现页面名称后面有个小问号。然后，点击这个问号，这样您就创建了一个页面。
	在一个 [WikiName\|http://www.jspwiki.org/wiki/WikiName] 中，几乎可以使用任何字符，不过他们要是字母或数字才行。
	另外有一点，本 Wiki 可以通过配置来支持标准的驼峰字 [CamelCase\|http://www.jspwiki.org/wiki/CamelCase] 连接（如果支持，只要不以 '~' 开头，单词 CamelCase 应该就是一个链接）。缺省情况下这个功能是关闭的，当然如果管理员已经将这个设置打开的话，那么 CamelCase 就是你要的了。
	!脚注
	脚注是一种特殊类型的超链接。创建脚注十分简单，只需在脚注要引用到的超链接中加入数字即可，例如 {{[[1]}}。
	实际使用的时候，把脚注 {{[[#1]}} 放到应指向的位置。
	如下所示。
	您还可以创建一个带名字的脚注，方法和创建普通超链接相同。比如 {{[[Footnote name\|1]}}，也是引用第一个脚注 [Footnote name\|1]的一种方式。也可以把自定义的名字用作脚注本身，如“Footnote name[2]”。
	![InterWiki\|http://www.jspwiki.org/wiki/InterWiki] 链接
	您还可以在不同的 Wiki 之间做链接，不一定要知道具体的 URL。只需要使用此格式“{{[[Wiki:WikiPage]}}”，JSPWiki 会自动帮您创建链接。例如，这个链接是指向 [JSPWiki TextFormatting rules\|JSPWiki:TextFormattingRules]。关于哪些 WiKi 链接可用的更多信息，可查看 [SystemInfo] 页面。
	如果不支持 [InterWiki\|http://www.jspwiki.org/wiki/InterWiki] 链接，当您保存这个页面时会收到通知。
	!添加图片
	您可以把图片嵌入到 wiki 代码里，只要该图片在网络上可用，并且符合以下格式，然后只需链接过去。
	如果指定链接文本（{{[[this one here\|http://example.com/example.png]}}），对于无法查看或不想查看图片的人，即可显示 ALT 文本。
	允许的图片类型取决于 Wiki。您可以查看 [SystemInfo] 页面获取图片类型列表。
	还可以使用 [Image plugin\|http://www.jspwiki.org/wiki/Image] 格式控制图片的位置和属性。
	要在图片后添加空行，可以使用三个反斜杠（\ \ \）。
	!符号列表
	可以在第一列使用一个星号（*）来添加符号列表。增加星号数量可添加更多的缩进。例如：
	{{{
	* 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
	# One \\ one and a half
	# Two
	# Three
	## 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 \|http://www.jspwiki.org/wiki/CSSInWikipages] 对页面中想要特别强调的部分做修饰。
	!冲突
	如果有人和您同时对某页面进行编辑，JSPWiki 会阻止您进行修改并显示冲突页面。遗憾的是，首先修改的人会修改成功...
	__警告信息：__ 如果您使用浏览器的后退按钮返回编辑页面，通常会引起冲突。这是因为浏览器会认为您还是编辑以前的页面。
	!删除页面
	这是不可能的。当然，您可以删除对该页面的所有链接，这样这个页面就无法访问了。或电子邮件给管理员，我会帮您删除此页面。您也可以添加一个 [DELETEME\|JSPWiki:DELETEME] 链接。
	!添加新页面
	可以创建一个链接指向新的页面（尚未存在的），方法是使用它的Wiki名字，如 [WikiName\|http://www.jspwiki.org/wiki/WikiName].
	如果现在单击该新链接，会显示一个问号 (?) 后缀，您将获取新页面的编辑权限。
	-- [Asser\|http://www.jspwiki.org/wiki/Asser]
	!页面别名识别
	有时候您想链接到某个 wiki 页面，以便立即浏览到其他页面。这可以使用“页面别名”来进行。
	!插入变量
	可以在页面上插入很多种变量。基本的格式为：
	{{ [[{$variablename}], }}
	其中 ''variablename'' 是要插入的变量的名称。注意变量名称是不区分大小写的 - 即“pagename”和“paGeNamE”以及“PageName”都是一样的。
	您可以在此页面查看可用的变量列表：[WikiVariables\|http://www.jspwiki.org/wiki/WikiVariables]。

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