Welcome 访客, you are in: 登录

RoboticFan(机器人爱好者)-Wiki

RSS RSS

Navigation





Search the wiki
»

PoweredBy

简体中文 (Chinese Edition)

The English version of this page is available here.

维基网页(Wiki Page)的编辑非常简单。 你可以在文章中插入维基标签(WikiMarkup), 标准的XHTML标签 或使用格式辅助工具列(Format Helper Toolbar)。前述三种方式,都可以帮助你简单且快速地格式化文字及插入链结、图形和许多其他的物件。




1 - 维基标签

维基标签是一组特定的前置与后置标签,我们可以使用这些标签来格式化文字,及插入一些物件,如链结与图形。在这一小节当中,我们要学习如何使用维基标签.

1.1 基本文字格式化

  • '''粗体''' 文字前后皆插入三个单引号则显示为: 粗体
  • ''斜体italic'' 文字前后皆插入两个单引号则显示为: 斜体
  • __底线__ 文字前后皆插入两个底线符号则显示为: 斜体
  • --删除线-- 文字前后皆插入两个减号则显示为: 删除线
  • 你也可以使用上述四种格式化的组合,如 --删除线 '' '''粗体''' 及 斜体''--其结果如: 删除线 粗体 及 斜体

1.2 - 链结

链结是使用一组方括号[]来识别。
注意: 因为在1.0.10版中,链结是使用两个方括号,如[[Link]]
  • 目前撰写链结的方式是 [PageName],其结果为: PageName (如果链结的网页不存在,则链结会呈现不同的颜色)
  • 你也可以显示标题替代链结: [PageName|这是标题],其结果为: 这是标题
  • 系统可以自动辨识Email的链结,如: [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分类或所有的uncategorized Pages ([c:-|uncategorized Pages]).

1.2.3 - 附加档桉

你可以使用下列的语法在网页上 附加 一个文件:

[attachment:File.jpg]

附加的文件会列示在网页的下端。请注意,这个功能仍然相当简陋,而且附加的文件并非实际的附加,而只是链结到上传文件.



1.3 - 标题

你可以使用(=)来显示标题:
  • ==最大的标题 (H1)==
  • ===大标题 (H2)===
  • ====小标题 (H3)====
  • =====最小的标题 (H4)=====
  • 前三种是可以明显区隔,最后一种只是一个小标题(请谨慎使用)。
  • 不建议使用H1,因为这是作为网页的目录,在其他的地方使用可能导致溷淆。

注意:标头必须放在每行的前头。

1.3.1 - 水平线

你可以使用四个减号: ---- 绘製一条水平线。



1.4 - 图形

图形也是使用两个方括号[]来连接。
注意: 因为在1.0.10版,图形使用两个方括号,如: [[image|Title|Url]].
可以使用的图档类型有:
  • [image|标题|图档链结|大图档链结/超链结 (非必要的)]插入一个内涵图形没有边框或图例。
  • [imageleft|标题|图档链结|大图档链结/超链结 (非必要的)][imageright|标题|图档链结|大图档链结/超链结 (非必要的)] 插入图形,使之靠左或靠右,并显示边框及标题。
  • [imageauto|标题|图档链结|大图档链结/超链结 (非必要的)] 插入一个图形,其位置是自动调整,并显示边框及标题
  • 其中 大图档链结/超链结是非必要的,选择性的:如果你有指定,可以是连结至一个放大的图形或者是其他的网页。

注意:你可以使用『文件管理』先将图片上传,再将『图档链结』设为该图档名称,否则『图档链结』必须是连结至一个图档的URL。

1.4.1 - 注意

超链结及图形都是使用方括号,指示内部栏位的数量不同。



1.5 - 项目符号(编号)

在每一列文字(或项目)前加上项目符号或编号(*) 或 (#)。 你也可以同时使用两者建立巢状列表。


* 项目 1
* 项目 2


结果:

  • 项目 1
  • 项目 2



# 项目 1
# 项目 2


结果:

  1. 项目 1
  2. 项目 2



# 项目 1
# 项目 2
#* 项目 2.1
#* 项目 2.2
# 项目 3


结果:

  1. 项目 1
  2. 项目 2
    • 项目 2.1
    • 项目 2.2
  3. 项目 3



# 项目 1
# 项目 2
#* 项目 2.1
#*# 项目 2.1.1
#*#* 项目 2.1.1.1
# 项目 3


结果:

  1. 项目 1
  2. 项目 2
    • 项目 2.1
      1. 项目 2.1.1
        • 项目 2.1.1.1
  3. 项目 3



1.6 - 程式码及非Wiki标签

如果你要插入一段程式码,请使用{{}}包住程式码。例如:{{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或Wiki标签等程式码的内容,未避免XML或Wiki标签的作用,请用两个 @包住:

@ @
<xml>
   '''Bold'''
   <bla z="b" />
</xml>
@ @

@ 之间的空白移除,结果如下:

<xml>
   '''Bold'''
   <bla z="b" />
</xml>

1.7 - 换行

两行以上才需要换行,单一行时换行标签是无效的。如果你要加入单一的换行,可以使用XHTML标签:<br />Wiki标签{BR} (大小写皆可)。 强烈建议在单一行时勿使用换行标签,因为这可能造成网页的溷淆。

1.8 - 特殊标签

RoboticFan Wiki引擎提供一些特殊的标签,可以自动取代成特定的内容。这些标签都可以是大小写的。
  • {wikititle} 得到 RoboticFan(机器人爱好者)-Wiki (本网站的抬头)
  • {up} 得到 GetFile.aspx?File= (档桉上传的路径)
  • {top} 得到 顶部 (回到本页最上面)
  • {toc} 得到本页内容的列表,其中Hx headers作为抬头。
  • {themepath} 得到 Themes/Default/ (得到目前主题(theme)的路径)。
  • {rsspage} 得到 RSS (连接到目前网页的RSS,只有在网页中才能使用)。
  • {wikiversion} 得到 3.0.1.400 (目前Wiki引擎的版本)。
  • {mainurl} 得到 http://wiki.roboticfan.com/ (此Wiki的主要URL)。
  • {pagecount} 得到 96 (Wiki中总共的页数)。
  • 访客 得到目前使用者的名称。
  • {cloud}插入分类的显示
  • {searchbox} 插入一个搜寻盒(一次只能有一个搜寻盒)
  • {clear} 当于网页底部插入数个图档时使用此标签。

1.9 - 图文框

如果你要将某些内容包含于一个图文框中时,使用三个小括号 ((()))。例如: (((我的图文框))) 结果:
我的图文框

1.10 - 文字缩排

每一行文字可以使用数个冒号来缩排,如:

: 一个冒号
:: 两个冒号

结果如下:

一个冒号
两个冒号

1.11 - 列表

Wiki引擎也支援列表。此列表提供多种选项,详细内容请参阅Tables

1.12 - 使用者签名

使用者可以使用四个~符号显示签名: ~~~~。结果如下: Dario Solera, 2007/02/15 11:39

1.13 - 片段(Snippets)及 引用(Page Transclusion)

要瞭解及使用『片段』与『引用』的功能请参阅下列专属的说明:

1.14 - 转向

当使用者开启某页时,你也可以自动让他转向另一个网页。你只需要在网页最上头加入下列的指令码:

>>> [新网页名称]



>>> 新网页名称

当使用者开启一个含有转向标签的网页时,Wiki引擎会显示被指向的新网页,在新网页顶部,会显示一个讯息,其中显示原网页的链结,此链结将不再被转向。

1.15 - XHTML支援及跳脱

Wiki引擎也支援XHTML。你可以使用任何的标签,除了<script>,这可能被网站管理者限制住。
XHTML指令也支援跳脱(视为注解): <!-- -->.

如果你要插入一段HTML或XML,并显示其中的标签,你可以使用<esc></esc> 标签作为跳脱(使其标签无作用,直接显示)。

<esc><strong>你的标签</strong></esc>

结果如下

<strong>你的标签</strong>

2 - 格式工具列

在编辑页上有一个工具列,如图所示:
Format Toolbar

Format Toolbar

各按键相对应的功能说明如下:

  1. 粗体: 设定/取消所选的文字是否为粗体
  2. 斜体: 设定/取消所选的文字是否为斜体
  3. 底线: 设定/取消所选的文字是否加上 底线
  4. 删除线: 设定/取消所选的文字是否加上 删除线
  5. H1: 设定/取消所选的文字是否为『最大标题』 (不建议)
  6. H2: 设定/取消所选的文字是否为『大标题』
  7. H3: 设定/取消所选的文字是否为『小标题』
  8. H4: 设定/取消所选的文字是否为『最小标题』 (请谨慎使用)
  9. 下标字: 设定/取消所选的文字是否为 下标字
  10. 上标字: 设定/取消所选的文字是否为 上标字
  11. 网页链结: 使用选单的方式在网页中加入一个超链结。
  12. 档桉链结: 在档桉上传插入一个档桉的链结。
  13. 外部链结: 在一个外部档桉中插入一个链结。
  14. 图档: 使用一个简单的图档浏览器插入一个图档。
  15. 锚: 显示两个项目,第一个可以在文字中插入锚,第二个可以在锚中插入一个链结。
  16. 内涵程式码: 设定/取消所选的文字是否为 程式码
  17. 程式码区块: 设定/取消所选的文字是否为一段程式码。
  18. 图文框: 将所选的文字包裹(或取消)在 (((...)))当中。
  19. 换行: 在文字当中插入一个换行。
  20. 插入片段: 使用选单的方式插入一个片段(Snippet)。
  21. 特殊标签: 显示可用的特殊标签列表,点选后,在文字当中插入所选的特殊标签。
  22. 非Wiki: 将所选的文字包裹(或取消)在 <nowiwi>...</nowiwi> 标签当中。
  23. 指令: 将所选的文字包裹(或取消)在XHTML指令标签中。
  24. 跳脱: 将所选的文字包裹(或取消)在跳脱标签中。
    ==3 - 插件使用语法==

3.1 - Silverlight幻灯片演示插件

要在条目中插入一堆图片,可以使用Silverlight插件语法

{SlideShow:FolderName}

3.2 - 评价插件

要在条目中插入评价,可使用代码为:

{rating



{rating}

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