##master-page:HelpOnLinking
##master-date:2006-08-05 11:15:54
#acl -All:write Default
#format wiki
#language zh

{{{#!wiki caution

this page is outdated and needs to be fixed

}}}

= 参考 =
||'''链接形式'''          ||'''语法'''                         ||'''备注'''                      ||
|| 内部链接               ||`WikiName`                         ||Camel``Case 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`                        ||可配置函数                      ||

= 解释与示例 =
== 任意格式名称 ==
如果你{{{["像这样"]}}}用方括号括起任意的字符，那就会使它成为一个页面名称。该功能可以在 MoinMoin 中用于特殊用途（就好比列出某些物品的列表，例如：你收藏的CD辑，你可以使用它们本来的名称来创建页名），或者你需要创建非西方字符编码页名称的时候也会用到。(注: 可以使用这样的方式定义中文链接)

## /!\ '''此功能是通过 `allow_extended_names` 来启动的可选功能，所以它可能无法正常工作（未启用）！'''

== 超链接和内嵌图片 ==
在文本中插入外部引用<<FootNote(相对于外部链接，是内部的，自动生成的["维基链接名"]链接。)>>有几种方法：
 * 直接插入超链接；如果超链接以图像文件扩展名（"{{{.gif}}}", "{{{.jpg}}}" or "{{{.png}}}"）结束，该链接将被自动转化为图像标记。
 * 方括号链接。
 * InterWiki 链接。
 * 电子邮件地址。

如果你在普通的文本中键入超链接，探测什么是超链接的一部分和什么不是链接的组成不分是很困难的。有四种方法可以强制指明一个超链接的结尾：
 * 在超链接的末尾加一个空格。
 * 使用 Wiki: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:显示文字]`，这里的"Page``Name"是其他页面的名字，"anchorname"是该页面上锚点的标识。

有时候希望指向维基内部的链接显示出不同的链接文字。如果你使用了InterWiki链接``Self``，那么链接之前会出现一个InterWiki图标，这会误导浏览者，因为这个链接根本没有离开当前的维基。你可以使用`[:WikiPage:显示文字]`来生成这样的链接，这不会产生InterWiki链接。

/!\ 有些维基上，指向RecentChanges的链接和指向[[recentchanges]]的链接是相同的页面. Windows和Mac OS X 操作系统尤其如此，因为它们一般不对大小写敏感。

<<FootNote>>

=== 避免自动链接 ===

要避免类似于Page``Name的单词自动变成链接，请使用{{{Page``Name}}}。

你也可以在WikiName之前加入一个感叹号来消除链接，比如`!WikiName`。可以通过配置选项 `bang_meta = False` 取消这个功能。

要避免超链接自动形成链接形式，请使用{{{`http://...`}}} 或者 `{{{http://...}}}`。


=== 示例 ===
{{{
 * 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:链接到本维基内其他页面上的锚点，显示不同文字]
}}} 

=== 显示 ===

 * 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
  * InterWiki
  * MeatBall:InterWiki
  * MeatBall:InterWiki
  * MeatBall:InterWiki
  * [[MeatBall:InterWiki|MeatBall上的维基链（InterWiki）页面]]
 * user@example.com
 * mailto:user@example.com?subject=test
 * [[InterWiki|本维基的维基链页面]]
 * [[#anchorname|链接到本页面上的锚点]]
 * [[OtherPage#anchorname|链接到本维基内其他页面上的锚点，显示不同文字]]


此页的英文版本：HelpOnLinking
