Wiki编辑语法

修改于 2010/03/28 18:00 由 Administrator 归类为 Wiki帮助
((('''注1''':本文档为官方帮助文档的中文翻译版本，原英文版地址为[http://www.screwturn.eu/PageEditing.ashx]{br}'''注2''':本文档当前对应的官方文档修订版本为 Rev.41)))

使用'''[http://www.screwturn.eu/Wiki.ashx|ScrewTurn Wiki]'''编辑页面是非常简单的。你可以插入'''WikiMarkup(Wiki标记)'''、标准的'''XHTML'''标记或者使用整合的'''格式辅助工具条'''。不管你使用什么方式，你都可以简单快捷的插入格式化的文本、链接、图片和许多其他内容。

{toc}

==1 - WikiMarkup(Wiki标记)==
''WikiMarkup''是一套特定的前缀和后缀,用来编排文本、插入项目,如链接和图像。在本节你将会学如何使用''WikiMarkup''。

===1.1 基本文本格式===
* 输入 {{<nowiki>'''bold'''</nowiki>}} 将显示 '''bold'''
* 输入 {{<nowiki>''italic''</nowiki>}} 将显示 ''italic''
* 输入 {{<nowiki>__underlined__</nowiki>}} 将显示 __underlined__
* 输入 {{<nowiki>--striked--</nowiki>}} 将显示 --striked--
* 你还可以将他们任意组合, 例如输入 {{<nowiki>--striked '' '''bold''' and italic''--</nowiki>}} 将显示 --striked '' '''bold''' and italic''--

===1.2 - 链接===
链接使用 {{&#0091;}} 和 {{&#0093;}} 来标示。{br}
'''注''': 从 1.0.10 版开始, 链接还可以使用两个括号来标示, 如 {{<nowiki>[[Link]]</nowiki>}}。
* 插入一个到内部页面的链接只需要写{{<nowiki>[PageName]</nowiki>}}, 这将显示 [PageName] (如果链接的目标页面不存在, 这个链接将会显示为不同的颜色)
* 你可以给链接添加指定的标题: {{<nowiki>[PageName|这是一个链接]</nowiki>}} 将显示 [PageName|这是一个链接]
* 电子邮件链接将被自动检测到, 例如{{<nowiki>[mail@server.com]</nowiki>}} 将显示 [mail@server.com]。{BR}很显然, 你同样可以添加标题: {{<nowiki>[mail@server.com |联系我们]</nowiki>}} 将显示 [mail@server.com|联系我们]
* 外部链接将会附带一个特定的图标: {{<nowiki>[http://www.screwturn.eu]</nowiki>}} 将显示 [http://www.screwturn.eu]
* 你可以链接到一个内部文件或子目录: {{<nowiki>[blog/|Blog]</nowiki>}} 将显示 [blog/|Blog] 和 {{<nowiki>[GPL.txt|GPL]</nowiki>}} 将显示 [GPL.txt|GPL]
* 如果你使用了 {{^}} 标记该url, 将会打开一个新窗口, 如 {{<nowiki>[^MyPage]</nowiki>}}。

你可以通过[FileManagement|文件管理]界面上传文件。

====1.2.1 - 注意====
链接和图象使用相同的标记, 但是存在一定数量的不同。

====1.2.2 - 类别====
你可以用下面的语法链接到一个[Category]:

{{{{<nowiki>[c:CategoryName]</nowiki>}}}}

例如, 你可以链接到 [c:Help] 类别或者所有的 [c:-|未分类页面] ({{<nowiki>[c:-|uncategorized Pages]</nowiki>}})。

====1.2.3 - 附加页面====
你可以用下面的语法在一个页面上 ''attach''(附加)一个文件:

{{{{<nowiki>[attachment:File.jpg]</nowiki>}}}}

附件将被列在页面底部。请注意, 此功能仍是很"原始", 附加文件并不是真正的附加, 只链接一些[FileManagement|上传的文件]。

===1.3 - 标题===
你可以使用相等数量的({{=}})标记创建标题:
* {{<nowiki>==最大号标题 (H1)==</nowiki>}}
* {{<nowiki>===大号标题 (H2)===</nowiki>}}
* {{<nowiki>====小号标题 (H3)====</nowiki>}}
* {{<nowiki>=====最小号标题 (H4)=====</nowiki>}}
* The first 3 Headings work as separators, the latter is only a small heading (use it sparingly)
* 不推荐使用H1, 因为它被使用为页面的标题, 因此可能造成混乱

'''注''': 标题必须位于一行的行首处。

====1.3.1 - 水平线====
你可以使用四个横线创建一个水平线 {{<nowiki>----</nowiki>}}。

===1.4 - 图象===
图像使用{{&#0091;}} 和 {{&#0093;}} 来标示。{br}
'''注''': 从 1.0.10 版开始, 图象还可以使用两个括号, 如 {{<nowiki>[[image|Title|Url]]</nowiki>}}。{br}
有以下几种不同类型的图像:
* {{<nowiki>[image|Title|Url|Big Url/Link Url (optional)]</nowiki>}} inserts an inline image, without borders nor legend
* {{<nowiki>[imageleft|Title|Url|Big Url/Link Url (optional)]</nowiki>}} 和 {{<nowiki>[imageright|Title|Url|Big Url (optional)]</nowiki>}} 插入的图象将显示在左边或右边, 并且显示边框和说明。
* {{<nowiki>[imageauto|Title|Url|Big Url/Link Url (optional)]</nowiki>}} 插入一幅图像自动适应图象大小, 并显示边框和描述
* 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

你可以通过[FileManagement|文件管理]界面上传图象。

====1.4.1 - 注意====
链接和图象使用相同的标记, 但是存在一定数量的不同。

===1.5 - 列表===
列表是由用一个或多个星号({{*}})和/或井号({{#}})构成的一个序列行构成的。您可以使用一个以上星号或井号创建嵌套列表。

<table cellpadding="0" cellspacing="0"><tr>
<td valign="top">
(((
{{<nowiki>* Element 1<br />* Element 2</nowiki>}}

''显示为''

* Element 1
* Element 2
)))
</td><td valign="top">
(((
{{<nowiki># Element 1<br /># Element 2</nowiki>}}

''显示为''

# Element 1
# Element 2
)))
</td><td valign="top">
(((
{{<nowiki># Element 1<br /># Element 2<br />#* Element 2.1<br />#* Element 2.2<br /># Element 3</nowiki>}}

''显示为''

# Element 1
# Element 2
#* Element 2.1
#* Element 2.2
# Element 3
)))
</td><td valign="top">
(((
{{<nowiki># Element 1<br /># Element 2<br />#* Element 2.1<br />#*# Element 2.1.1<br />#*#* Element 2.1.1.1<br /># Element 3</nowiki>}}

''显示为''

# Element 1
# Element 2
#* Element 2.1
#*# Element 2.1.1
#*#* Element 2.1.1.1
# Element 3
)))
</td>
</tr></table>

===1.6 - 代码和NoWiki标记===
如果你想在一行内插入一个内嵌代码, 用 {{&#0123;&#0123;}} 和 {{&#0125;&#0125;}} 将代码包含; 例如 {{&#0123;&#0123;This is code&#0125;&#0125;}} 将产生 {{This is code}}.{BR}
如果你想插入一个代码块, 比如一段C#代码, 用 {{&#0123;&#0123;&#0123;&#0123;}} 和 {{&#0125;&#0125;&#0125;&#0125;}} 将代码包含, 例如

{{{{
using System;

namespace MyNamespace {
   public class HelloWorld {
      public static void Main(string[] args) {
         Console.WriteLine("Hello World");
      }
   }
}
}}}}

如果你不想让你的文字被WIki引擎进行文本格式化, 用 {{&lt;nowiki&gt;}} 和 {{&lt;/nowiki&gt;}} 将内容包含, 例如 {{&lt;nowiki&gt;<nowiki>[MyPage]</nowiki>&lt;/nowiki&gt;}} 将显示为 <nowiki>[MyPage]</nowiki>.

====1.6.1 - <nowiki>@@</nowiki> 标记====
如果你需要包含一些代码, 比如, 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 {{&lt;br /&gt;}} or its ''WikiMarkup'' alias {{<nowiki>{BR}</nowiki>}} (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 包含一些特殊标记，所有这些特殊标记都是不区分大小写的。
* {{<nowiki>{wikititle}</nowiki>}} 将显示 {wikititle} (Wiki的标题)
* {{<nowiki>{up}</nowiki>}} 将显示 {up} (文档的上传路径)
* {{<nowiki>{top}</nowiki>}} 将显示 {top} (跳转到当前页面的顶部)
* {{<nowiki>{toc}</nowiki>}} 将显示当前页面内容中使用Hx标题标记所产生的一个索引目录表
* {{<nowiki>{themepath}</nowiki>}} 将显示 {themepath} (当前主题路径)
* {{<nowiki>{rsspage}</nowiki>}} 将显示 {rsspage} (一个连接到当前页面Rss订阅的地址, 只能在页面中使用)
* {{<nowiki>{wikiversion}</nowiki>}} 将显示 {wikiversion} (Wiki引擎的当前版本)
* {{<nowiki>{mainurl}</nowiki>}} 将显示 {mainurl} (Wiki的地址)
* {{<nowiki>{pagecount}</nowiki>}} 将显示 {pagecount} (Wiki中包含的页面数量)
* {{<nowiki>{username}</nowiki>}} 将显示当前用户的用户名
* {{<nowiki>{cloud}</nowiki>}} 将显示分类的云图形式
* {{<nowiki>{searchbox}</nowiki>}} 将显示一个搜索框 (只有当搜索框可用时才能正常显示)
* {{<nowiki>{clear}</nowiki>}} 在需要将图片插入到页面底部时使用

===1.9 - 框===
如果你创建一个有实线的文本框，可以使用括号 {{<nowiki>(((</nowiki>}} 和 {{<nowiki>)))</nowiki>}}。 例如, {{<nowiki>(((My box)))</nowiki>}} 将显示 (((My box)))

===1.10 - 文本缩进===
在'''行首'''，可以使文本 ''缩进'' 一列或多列。

{{{{<nowiki>
: 一列缩进
:: 二列缩进
</nowiki>}}}}

将显示

: 一列缩进
:: 二列缩进

===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: {{&#0126;&#0126;&#0126;&#0126;}}. The result is the following:
§§(Dario Solera,2007/02/15 11:39:22)§§

===1.13 - Snippets and Page Transclusion===
To use the special features called ''Snippets'' and ''Page Transclusion'', please go to the dedicated pages:
* [Snippet|Snippets]
* [Transclusion|Page Transclusion]

===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''':

{{{{<nowiki>>>> [PageName]</nowiki>}}}}

or

{{{{<nowiki>>>> PageName</nowiki>}}}}

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 {{&lt;script&gt;}} that might be disabled by the administrators.{BR}
XHTML comments are also supported: {{<nowiki>&lt;!-- --&gt;</nowiki>}}.

If you want to insert a block of HTML or XML displaying the tags, you can use the {{&lt;esc&gt;&lt;/esc&gt; }} tag. This tags escapes all the angular brackes making them visible.

{{{{&lt;esc&gt;<esc><strong>Your tag</strong></esc>&lt;/esc&gt;}}}}

produces

<esc><strong>Your tag</strong></esc>

==2 - Format Toolbar==
In the editing page there is the toolbar reported in this picture:{BR}
[imageauto|Format Toolbar|{UP}HelpPictures%2fToolbar.png]
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 <sub>subscript</sub>
# Superscript: sets/unsets selected text as <sup>superscript</sup>
# Page link: allows to insert a link to a Wiki Page using a menu
# File link: allows to insert a link to an [FileManagement|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 {{<nowiki>(((...)))</nowiki>}}
# 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 {{&lt;nowiwi&gt;...&lt;/nowiwi&gt;}} tags
# Comment: wraps/unwraps selected text with XHTML comment tags
# Escape: wraps/unwraps selected text with ''escape'' tags
Meta Keywords:
Meta Description:
Change Comment:
Supesoft Wiki

导航条¶

链接¶

Wiki编辑语法
