参考
链接形式 |
语法 |
备注 |
内部链接 |
WikiName |
CamelCase page name |
内部自由链接 |
["Page"] or ["free link"] |
可配置函数 |
内部子页面链接 |
/SubPage or ["/Sub page"] |
相对于上一级页面 |
外部链接 |
http://example.net |
|
内部命名链接 |
[:HelpContents:Contents of the Help] |
|
外部命名链接 |
[http://example.net example site] |
|
本地图片(附件) |
attachment:graphics.png |
图片内嵌显示 |
外部图片 |
http://example.net/image.png |
显示目标图片 |
外部和内部图片 |
[[ImageLink(image,target[,width=w[,height=h]][,alt=alt])]] |
显示的图片链接到URL或者维基页面 |
内部链接作用域 |
WikiName``s |
两个反引号 |
消除内部链接 |
!WikiName |
可配置函数 |
解释与示例
1. 任意格式名称
如果你["像这样"]用方括号括起任意的字符,那就会使它成为一个页面名称。该功能可以在 MoinMoin 中用于特殊用途(就好比列出某些物品的列表,例如:你收藏的CD辑,你可以使用它们本来的名称来创建页名),或者你需要创建非西方字符编码页名称的时候也会用到。(注: 可以使用这样的方式定义中文链接)
2. 超链接和内嵌图片
在文本中插入外部引用1有几种方法:
直接插入超链接;如果超链接以图像文件扩展名(".gif", ".jpg" or ".png")结束,该链接将被自动转化为图像标记。
- 方括号链接。
InterWiki 链接。
- 电子邮件地址。
如果你在普通的文本中键入超链接,探测什么是超链接的一部分和什么不是链接的组成不分是很困难的。有四种方法可以强制指明一个超链接的结尾:
- 在超链接的末尾加一个空格。
使用 SixSingleQuotes 特殊形式。
- 将超链接放入双引号之间。
- 使用方括号链接语法。
支持的链接类型为:http,https,ftp,nntp,news,mailto,telnet,irc以及file。您的wiki管理员可以通过扩展url_schemas变量来增加对其他类型链接的支持(参见帮助-系统设置)。
除了标准的链接类型,MoinMoin 还提供了一些特殊的链接类型:wiki,attachment,inline以及drawing。"wiki" 表示一个维基链(InterWiki),所以 MoinMoin:首页 和 wiki:MoinMoin:首页 是等价的;一般情况下你可以选择比较短的形式来书写,当使用方括号形式链接的时候 "wiki" 将变得比较重要,因为该方式需要明确链接的类型。另外三种类型是用于文件附件的,将在帮助-操作/附件中对它们进行解释。
关于更多标记形式,请参见帮助-编辑。关于如何链接子页面,请参见帮助-编辑/子网页。
如要在页面内插入锚点,需要使用宏Anchor: [[Anchor(anchorname)]],这里的"anchorname" 是锚点的标识。要在同一个维基网页上指向这个锚点,请使用[#anchorname]或者[#anchorname 显示文字]。要链接其他维基网页上的锚点,请使用[:PageName#anchorname]或者[:PageName#anchorname:显示文字],这里的"PageName"是其他页面的名字,"anchorname"是该页面上锚点的标识。
有时候希望指向维基内部的链接显示出不同的链接文字。如果你使用了InterWiki链接Self,那么链接之前会出现一个InterWiki图标,这会误导浏览者,因为这个链接根本没有离开当前的维基。你可以使用[:WikiPage:显示文字]来生成这样的链接,这不会产生InterWiki链接。
有些维基上,指向RecentChanges的链接和指向recentchanges的链接是相同的页面. Windows和Mac OS X 操作系统尤其如此,因为它们一般不对大小写敏感。
相对于外部链接,是内部的,自动生成的["维基链接名"]链接。 (1)
2.1. 避免自动链接
要避免类似于PageName的单词自动变成链接,请使用Page``Name。
你也可以在WikiName之前加入一个感叹号来消除链接,比如!WikiName。可以通过配置选项 bang_meta = False 取消这个功能。
要避免超链接自动形成链接形式,请使用`http://...` 或者 {{{http://...}}}。
2.2. 示例
* http://moinmoin.wikiwikiweb.de/ * [http://moinmoin.wikiwikiweb.de/] * [http://moinmoin.wikiwikiweb.de/ MoinMoin 的主页] * http://moinmoin.wikiwikiweb.de/wiki/common/moinmoin.png * [http://moinmoin.wikiwikiweb.de/wiki/common/moinmoin.png] * [http://moinmoin.wikiwikiweb.de/wiki/common/moinmoin.png moinmoin.png] * [http:/wiki/common/moinmoin.png] 部分链接 * InterWiki * Self:InterWiki * MeatBall:InterWiki * wiki:MeatBall/InterWiki * [wiki:MeatBall/InterWiki] * [wiki:MeatBall/InterWiki MeatBall上的维基链(InterWiki)页面] * user@example.com * mailto:user@example.com?subject=test * [:InterWiki:本维基的维基链页面] * [#anchorname 链接到本页面上的锚点] * [:OtherPage#anchorname:链接到本维基内其他页面上的锚点,显示不同文字]
2.3. 显示
此页的英文版本:HelpOnLinking