在
ScrewTurn Wiki 中编辑一个 Wiki 页面是非常简单的。 可以插入
WikiMarkup, 标准的
XHTML 或者使用整合的
格式辅助工具条。不管你使用什么方式,你都可以简单快捷的插入格式化的文本、链接、图片和许多其他内容。
编辑1 - WikiMarkup
WikiMarkup 是一套特定的前缀和后缀,用来编排文本、插入项目,如链接和图像。在本节你将会学如何使用
WikiMarkup.
编辑1.1 基本文本格式
- 输入
'''bold''' 将显示 bold - 输入
''italic'' 将显示 italic - 输入
__underlined__ 将显示 underlined - 输入
--striked-- 将显示 striked - 你还可以将他们任意组合, 例如输入
--striked '' '''bold''' and italic''-- 将显示 striked bold and italic
编辑1.2 - 链接
链接使用
[ 和
] 来标示。
注: 从 1.0.10 版开始, 链接还可以使用两个括号来标示, 如
[[Link]]。
- 插入一个到内部页面的链接只需要写
[PageName], 这将显示 PageName (如果链接的目标页面不存在, 这个链接将会显示为不同的颜色) - 你可以给链接添加指定的标题:
[PageName|这是一个链接] 将显示 这是一个链接 - 电子邮件链接将被自动检测到, 例如
[mail@server.com] 将显示 mail@server.com。
很显然, 你同样可以添加标题: [mail@server.com |联系我们] 将显示 联系我们 - 外部链接将会附带一个特定的图标:
[http://www.screwturn.eu] 将显示 http://www.screwturn.eu - 你可以链接到一个内部文件或子目录:
[blog/|Blog] 将显示 Blog 和 [GPL.txt|GPL] 将显示 GPL - 如果你使用了
^ 标记该url, 将会打开一个新窗口, 如 [^MyPage]。
你可以通过
文件管理界面上传文件。
编辑1.2.1 - 注意
链接和图象使用相同的标记, 但是存在一定数量的不同。
编辑1.2.2 - 类别
你可以用下面的语法链接到一个
分类:
[c:CategoryName]
例如, 你可以链接到
Help 类别或者所有的
未分类页面 (
[c:-|uncategorized Pages])。
编辑1.2.3 - 页面附件
你可以用下面的语法在一个页面上
attach(附加)一个文件:
[attachment:File.jpg]
附件将被列在页面底部。请注意, 此功能仍是很"原始", 附加文件并不是真正的附加, 只链接一些
上传的文件。
编辑1.3 - 标题
你可以使用相等数量的(
=)标记创建标题:
==最大号标题 (H1)=====大号标题 (H2)=======小号标题 (H3)=========最小号标题 (H4)=====- 前三个标题单独使用,最后一个标题是唯一的小标题(尽量少用)
- 不推荐使用H1, 因为它被使用为页面的标题, 因此可能造成混乱
注: 标题必须位于一行的行首处。
编辑1.3.1 - 水平线
你可以使用四个横线创建一个水平线
----。
编辑1.4 - 图象
图像使用
[ 和
] 来标示。
注: 从 1.0.10 版开始, 图象还可以使用两个括号, 如
[[image|Title|Url]]。
有以下几种不同类型的图像:
[image|Title|Url|Big Url/Link Url (可选)] 插入一幅内联图像,没有边框也没有图例说明[imageleft|Title|Url|Big Url/Link Url (可选)] 和 [imageright|Title|Url|Big Url (optional)] 插入的图象将显示在左边或右边, 并且显示边框和说明。[imageauto|Title|Url|Big Url/Link Url (可选)] 插入一幅图像自动适应图象大小, 并显示边框和描述- 在所有方法中, Big Url/Link Url 是可选的;在指定它时,它将图像连接到图像的大尺寸的版本或任何其他文档
你可以通过
文件管理界面上传图象。
编辑1.4.1 - 注意
链接和图象使用相同的标记, 但是存在一定数量的不同。
编辑1.5 - 列表
列表是由用一个或多个星号(
*)和/或井号(
#)构成的一个序列行构成的。您可以使用一个以上星号或井号创建嵌套列表。
* Element 1 * Element 2显示为
|
# Element 1 # Element 2显示为- Element 1
- Element 2
|
# Element 1 # Element 2 #* Element 2.1 #* Element 2.2 # Element 3显示为- Element 1
- Element 2
- Element 3
|
# Element 1 # Element 2 #* Element 2.1 #*# Element 2.1.1 #*#* Element 2.1.1.1 # Element 3显示为- Element 1
- Element 2
- Element 3
|
编辑1.6 - 代码和NoWiki标记
如果你想在一行内插入一个内嵌代码, 用
{{ 和
}} 将代码包含; 例如
{{This is code}} 将产生
This is code.
如果你想插入一个代码块, 比如一段C#代码, 用
{{{{ 和
}}}} 将代码包含, 例如
using System;
namespace MyNamespace {
public class HelloWorld {
public static void Main(string[] args) {
Console.WriteLine("Hello World");
}
}
}
如果你不想让你的文字被WIki引擎进行文本格式化, 用
<nowiki> 和
</nowiki> 将内容包含, 例如
<nowiki>[MyPage]</nowiki> 将显示为 [MyPage].
编辑1.6.1 - @@ 标记
如果你需要包含一些代码, 比如, XML 和所有 WikiMarkup, 如果你想让他显示出来, 用两个
@包含:
@ @
<xml>
'''Bold'''
<bla z="b" />
</xml>
@ @
删除
@之间的空格后, 结果如下:
<xml>
'''Bold'''
<bla z="b" />
</xml>
编辑1.7 - 换行符
两个换行符被处理为换行符,但单个换行符会被忽略。如果要插入单个的换行符,可以使用标准的 XHTML 标记
<br /> 或者它的
WikiMarkup 别名
{BR} (忽略字母的大小写)。 不推荐滥用单个换行符,因为它们趋向于在页面中制造混乱。
编辑1.8 - 特殊标记
ScrewTurn Wiki 包含一些特殊标记,所有这些特殊标记都是不区分大小写的。
{wikititle} 将显示 .NET 藏经阁 - 知识分享 (Wiki的标题){up} 将显示 GetFile.aspx?File= (文档的上传路径){top} 将显示 顶部 (跳转到当前页面的顶部){toc} 将显示当前页面内容中使用Hx标题标记所产生的一个索引目录表{themepath} 将显示 Themes/FlatEarth/ (当前主题路径){rsspage} 将显示
(一个连接到当前页面Rss订阅的地址, 只能在页面中使用){wikiversion} 将显示 2.0.31 (Wiki引擎的当前版本){mainurl} 将显示 http://wiki.entlib.net.cn/ (Wiki的地址){pagecount} 将显示 450 (Wiki中包含的页面数量){username} 将显示当前用户的用户名{cloud} 将显示分类的云图形式{searchbox} 将显示一个搜索框 (只有当搜索框可用时才能正常显示){clear} 在需要将图片插入到页面底部时使用
编辑1.9 - 框
如果你创建一个有实线的文本框,可以使用括号
((( 和
)))。 例如,
(((My box))) 将显示
My box
编辑1.10 - 文本缩进
在
行首,可以使文本
缩进 一列或多列。
: 一列缩进
:: 二列缩进
将显示
一列缩进
二列缩进
编辑1.11 - 表格
WikiMarkup 还支持表格。因为表格提供许多选择,所以在单独的节
表格中描述它。
编辑1.12 - 用户签名
用户可以用四个
~(波浪符)来对所编辑的页面进行签名。
~~~~. 结果如下:§§(doriandeng,2007/11/05 13:42:31)§§
编辑1.13 - 摘录和页面包含
要使用特殊的
摘录(Snippet) 和
页面包含 (Page Transclusion )特性,请到专门的页面中查看:
编辑1.14 - 页面重定向
可以自动的把一个用户从访问的页面重定向到另一个页面,在
页面的最前面添加如下代码:
>>> [PageName]
或者
>>> PageName
当用户访问包含重定向标记的页面时,引擎将显示目标页面。在目标页面的顶部,将显示一条包含没有重定向时的原始页面的链接的消息。
编辑1.15 - XHTML 支持和排除( Escaping )
ScrewTurn Wiki 支持标准的 XHTML 内容。可以使用除
<script> 以外的任何标记,
<script> 可能会被管理员禁用。
XHTML 注释也是受支持的:
<!-- -->.
如果要插入一个显示标记的 HTML 或 XML 块,可以使用
<esc></esc> 标记。 此标记排除所有的尖括号( angular brackes )而使它们可见。
<esc><strong>Your tag</strong></esc>
生成
<strong>Your tag</strong>
编辑2 - 格式工具栏
这是在编辑页面中的工具栏图片:
 格式工具栏 |
下面是按钮列表的报告。
- 粗体: 设置/取消所选文本为粗体
- 斜体: 设置/取消所选文本为斜体
- 下划线: 设置/取消所选文本的下划线
- 删除线: 设置/取消所选文本的
删除线 - H1: 设置/取消所选文本为标题1(不推荐)
- H2: 设置/取消所选文本为标题2
- H3: 设置/取消所选文本为标题3
- H4: 设置/取消所选文本为标题4 (少使用)
- 下标: 设置/取消所选文本为 下标
- 上标: 设置/取消所选文本为 上标
- 页面链接: 允许使用菜单插入一个到 Wiki 页面的链接
- 文件链接: 允许插入一个到上传的文件的链接
- 外部链接: 允许插入一个到外部目的地的链接
- 图片: 允许使用简单的 图片浏览器 插入一张图片
- 锚: 显示二个条目,第一个允许在文本中插入锚点,第二个允许插入到文本中锚点的链接
- 内联代码: 设置/取消选择的文本为
代码 - 代码块: 设置/取消选择的文本为一个代码块
- Box: 使用
(((...)))包围/取消包围所选择的文本 - 分行符:在文本中插入单个的分行符
- 插入摘录: 允许使用一个菜单插入 摘录
- 特殊标记:显示一个可用特殊标记的列表,每单击一次,就插入一个特殊标记到文本中
- NoWiki: 用
<nowiwi>...</nowiwi> 标记包围/取消包围所选的文本 - 注释: 用 XHTML 注释标记包围/取消包围所选的文本
- 排除: 用 escape标记包围/取消包围所选的文本