使用
ScrewTurn Wiki编辑页面是非常简单的。你可以插入
WikiMarkup(Wiki标记)、标准的
XHTML标记或者使用整合的
格式辅助工具条。不管你使用什么方式,你都可以简单快捷的插入格式化的文本、链接、图片和许多其他内容。
1 - WikiMarkup(Wiki标记)
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 - 类别
你可以用下面的语法链接到一个
Category:
[c:CategoryName]
例如, 你可以链接到
Help 类别或者所有的
未分类页面 (
[c:-|uncategorized Pages])。
1.2.3 - 附加页面
你可以用下面的语法在一个页面上
attach(附加)一个文件:
[attachment:File.jpg]
附件将被列在页面底部。请注意, 此功能仍是很"原始", 附加文件并不是真正的附加, 只链接一些
上传的文件。
1.3 - 标题
你可以使用相等数量的(
=)标记创建标题:
==最大号标题 (H1)=====大号标题 (H2)=======小号标题 (H3)=========最小号标题 (H4)=====- The first 3 Headings work as separators, the latter is only a small heading (use it sparingly)
- 不推荐使用H1, 因为它被使用为页面的标题, 因此可能造成混乱
注: 标题必须位于一行的行首处。
1.3.1 - 水平线
你可以使用四个横线创建一个水平线
----。
1.4 - 图象
图像使用
[ 和
] 来标示。
注: 从 1.0.10 版开始, 图象还可以使用两个括号, 如
[[image|Title|Url]]。
有以下几种不同类型的图像:
[image|Title|Url|Big Url/Link Url (optional)] inserts an inline image, without borders nor legend[imageleft|Title|Url|Big Url/Link Url (optional)] 和 [imageright|Title|Url|Big Url (optional)] 插入的图象将显示在左边或右边, 并且显示边框和说明。[imageauto|Title|Url|Big Url/Link Url (optional)] 插入一幅图像自动适应图象大小, 并显示边框和描述- In all the cases, Big Url/Link Url is optional; when specified, it links the image with its big version or with any another document
你可以通过
文件管理界面上传图象。
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 - 换行符
Two line breaks are treated as they are. A single line break is ignored. If you want to insert a single line break, you can use the standard XHTML tag
<br /> or its
WikiMarkup alias
{BR} (letter casing is ignored). It's not recommended to abuse single line breaks because they tend to create confusion in the page.
1.8 - 特殊标记
ScrewTurn Wiki 包含一些特殊标记,所有这些特殊标记都是不区分大小写的。
{wikititle} 将显示 ScrewTurn Wiki (Wiki的标题){up} 将显示 GetFile.aspx?File= (文档的上传路径){top} 将显示 顶部 (跳转到当前页面的顶部){toc} 将显示当前页面内容中使用Hx标题标记所产生的一个索引目录表{themepath} 将显示 Themes/Default/ (当前主题路径){rsspage} 将显示
(一个连接到当前页面Rss订阅的地址, 只能在页面中使用){wikiversion} 将显示 3.0.2.509 (Wiki引擎的当前版本){mainurl} 将显示 http://wiki.supesoft.com/ (Wiki的地址){pagecount} 将显示 24 (Wiki中包含的页面数量)访客 将显示当前用户的用户名{cloud} 将显示分类的云图形式{searchbox} 将显示一个搜索框 (只有当搜索框可用时才能正常显示){clear} 在需要将图片插入到页面底部时使用
1.9 - 框
如果你创建一个有实线的文本框,可以使用括号
((( 和
)))。 例如,
(((My box))) 将显示
My box
1.10 - 文本缩进
在
行首,可以使文本
缩进 一列或多列。
: 一列缩进
:: 二列缩进
将显示
一列缩进
二列缩进
1.11 - Tables
The
WikiMarkup also supports tables. Since the tables offer many options, they are described in the dedicated section
Tables.
1.12 - User Signature
Users can sign their edits using four tildes:
~~~~. The result is the following:
Dario Solera, 2007/02/15 11:391.13 - Snippets and Page Transclusion¶
To use the special features called
Snippets and
Page Transclusion, please go to the dedicated pages:
1.14 - Page Redirection
You can redirect a user automatically to another Page when he visits a Page. You can just add the following code
at the beginning of the Page:
>>> [PageName]
or
>>> PageName
When the user visits a Page containing a Redirection tag, the engine will display the destination Page. At the top of the destination Page Page, a message will be displayed, containing a link for visiting the origin Page without being redirected.
1.15 - XHTML Support and Escaping¶
ScrewTurn Wiki supports standard XHTML content. You can use any tag, except for
<script> that might be disabled by the administrators.
XHTML comments are also supported:
<!-- -->.
If you want to insert a block of HTML or XML displaying the tags, you can use the
<esc></esc> tag. This tags escapes all the angular brackes making them visible.
<esc><strong>Your tag</strong></esc>
produces
<strong>Your tag</strong>
2 - Format Toolbar
In the editing page there is the toolbar reported in this picture:
 Format Toolbar |
The list of the buttons is reported below.
- Bold: sets/unsets selected text as bold
- Italic: sets/unsets selected text as italic
- Underlined: sets/unsets selected text as underlined
- Striked: sets/unsets selected text as
striked - H1: sets/unsets selected text as Header Level 1 (unrecommended)
- H2: sets/unsets selected text as Header Level 2
- H3: sets/unsets selected text as Header Level 3
- H4: sets/unsets selected text as Header Level 4 (use sparingly)
- Subscript: sets/unsets selected text as subscript
- Superscript: sets/unsets selected text as superscript
- Page link: allows to insert a link to a Wiki Page using a menu
- File link: allows to insert a link to an uploaded file
- External: allows to insert a link to an external destination
- Image: allows to insert an image using a simple Image Browser
- Anchors: shows two items, the first allows to inserts anchors in the text, the second allows to insert links to anchors in the text
- Inline Code: sets/unsets selected text as
code - Block Code: sets/unsets selected text as a block of code
- Box: wraps/unwraps selected text with
(((...))) - Line Break: inserts a single line break in the text
- Insert Snippet: allows to insert a Snippet using a menu
- Special Tags: shows a list of available special tags which, once clicked, insert a specific special tag in the text
- NoWiki: wraps/unwraps selected text with
<nowiwi>...</nowiwi> tags - Comment: wraps/unwraps selected text with XHTML comment tags
- Escape: wraps/unwraps selected text with escape tags