.NET 企业库 知识分享--知识产生力量,成功源于分享!
RSS

导航







专业.NET技术社区

专业.NET技术社区


快速搜索

高级搜索 »

ScrewTurn Wiki 页面编辑

修改时间: 2007/11/07 13:25 由 doriandeng - 编目为: ScrewTurn Wiki
注意:本文档为官方帮助文档的中文翻译版本,原英文版地址为 http://www.screwturn.eu/PageEditing.ashx

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


显示为

  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 - 换行符

两个换行符被处理为换行符,但单个换行符会被忽略。如果要插入单个的换行符,可以使用标准的 XHTML 标记 <br /> 或者它的 WikiMarkup 别名 {BR} (忽略字母的大小写)。 不推荐滥用单个换行符,因为它们趋向于在页面中制造混乱。

编辑

1.8 - 特殊标记

ScrewTurn Wiki 包含一些特殊标记,所有这些特殊标记都是不区分大小写的。
  • {wikititle} 将显示 .NET 藏经阁 - 知识分享 (Wiki的标题)
  • {up} 将显示 GetFile.aspx?File= (文档的上传路径)
  • {top} 将显示 顶部 (跳转到当前页面的顶部)
  • {toc} 将显示当前页面内容中使用Hx标题标记所产生的一个索引目录表
  • {themepath} 将显示 Themes/FlatEarth/ (当前主题路径)
  • {rsspage} 将显示 RSS (一个连接到当前页面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 - 格式工具栏

这是在编辑页面中的工具栏图片:
格式工具栏

格式工具栏

下面是按钮列表的报告。

  1. 粗体: 设置/取消所选文本为粗体
  2. 斜体: 设置/取消所选文本为斜体
  3. 下划线: 设置/取消所选文本的下划线
  4. 删除线: 设置/取消所选文本的删除线
  5. H1: 设置/取消所选文本为标题1(不推荐)
  6. H2: 设置/取消所选文本为标题2
  7. H3: 设置/取消所选文本为标题3
  8. H4: 设置/取消所选文本为标题4 (少使用)
  9. 下标: 设置/取消所选文本为 下标
  10. 上标: 设置/取消所选文本为 上标
  11. 页面链接: 允许使用菜单插入一个到 Wiki 页面的链接
  12. 文件链接: 允许插入一个到上传的文件的链接
  13. 外部链接: 允许插入一个到外部目的地的链接
  14. 图片: 允许使用简单的 图片浏览器 插入一张图片
  15. 锚: 显示二个条目,第一个允许在文本中插入锚点,第二个允许插入到文本中锚点的链接
  16. 内联代码: 设置/取消选择的文本为 代码
  17. 代码块: 设置/取消选择的文本为一个代码块
  18. Box: 使用(((...)))包围/取消包围所选择的文本
  19. 分行符:在文本中插入单个的分行符
  20. 插入摘录: 允许使用一个菜单插入 摘录
  21. 特殊标记:显示一个可用特殊标记的列表,每单击一次,就插入一个特殊标记到文本中
  22. NoWiki: 用<nowiwi>...</nowiwi> 标记包围/取消包围所选的文本
  23. 注释: 用 XHTML 注释标记包围/取消包围所选的文本
  24. 排除: 用 escape标记包围/取消包围所选的文本
.NET 藏经阁 | | 版权所有 ©2008 entlib.net.cn