Welcome 访客, you are in: 登录

Supesoft Wiki

RSS

导航条

首页
随机选择页
创建新页面
所有页面
文档分类
系统管理员
文件管理
登陆/退出
语言选择

链接

Supesoft
ASP.NET权限管理系统(FrameWork)
广告统计分析系统(ADCount)
官方论坛

快速搜索
»
高级搜索 »

PoweredBy

Wiki编辑语法

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

使用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 |联系我们] 将显示
  • 外部链接将会附带一个特定的图标: [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


显示为

  1. Element 1
  2. Element 2



# Element 1
# Element 2
#* Element 2.1
#* Element 2.2
# Element 3


显示为

  1. Element 1
  2. Element 2
    • Element 2.1
    • Element 2.2
  3. Element 3



# Element 1
# Element 2
#* Element 2.1
#*# Element 2.1.1
#*#* Element 2.1.1.1
# Element 3


显示为

  1. Element 1
  2. Element 2
    • Element 2.1
      1. Element 2.1.1
        • Element 2.1.1.1
  3. 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 (一个连接到当前页面Rss订阅的地址, 只能在页面中使用)
  • {wikiversion} 将显示 3.0.2.509 (Wiki引擎的当前版本)
  • {mainurl} 将显示 http://wiki.supesoft.com/ (Wiki的地址)
  • {pagecount} 将显示 30 (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:39

1.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

Format Toolbar

The list of the buttons is reported below.

  1. Bold: sets/unsets selected text as bold
  2. Italic: sets/unsets selected text as italic
  3. Underlined: sets/unsets selected text as underlined
  4. Striked: sets/unsets selected text as striked
  5. H1: sets/unsets selected text as Header Level 1 (unrecommended)
  6. H2: sets/unsets selected text as Header Level 2
  7. H3: sets/unsets selected text as Header Level 3
  8. H4: sets/unsets selected text as Header Level 4 (use sparingly)
  9. Subscript: sets/unsets selected text as subscript
  10. Superscript: sets/unsets selected text as superscript
  11. Page link: allows to insert a link to a Wiki Page using a menu
  12. File link: allows to insert a link to an uploaded file
  13. External: allows to insert a link to an external destination
  14. Image: allows to insert an image using a simple Image Browser
  15. Anchors: shows two items, the first allows to inserts anchors in the text, the second allows to insert links to anchors in the text
  16. Inline Code: sets/unsets selected text as code
  17. Block Code: sets/unsets selected text as a block of code
  18. Box: wraps/unwraps selected text with (((...)))
  19. Line Break: inserts a single line break in the text
  20. Insert Snippet: allows to insert a Snippet using a menu
  21. Special Tags: shows a list of available special tags which, once clicked, insert a specific special tag in the text
  22. NoWiki: wraps/unwraps selected text with <nowiwi>...</nowiwi> tags
  23. Comment: wraps/unwraps selected text with XHTML comment tags
  24. Escape: wraps/unwraps selected text with escape tags

ScrewTurn Wiki version 3.0.2.509. Some of the icons created by FamFamFam.