##master-page:HelpOnLinking
##master-date:2006-02-27 10:50:00
#acl -All:write Default
#format wiki
#language zh-tw

{{{#!wiki caution

this page is outdated and needs to be fixed
}}}

= 快速參考 =
||'''超連結'''               ||'''語法'''                          ||'''說明'''                   ||
||站內 Wiki``Name 名稱頁面連結 ||`WikiName`                          ||Camel``Case 形式的頁面名稱    ||
||站內任意名稱頁面連結         ||`["Page"]` or `["free link"]`      ||此為可設定的功能               ||
||站內子頁面連結              ||`/SubPage` or `["/Sub page"]`      ||相對於上層的頁面               ||
||外部 URL 連結              ||`http://example.net`               ||                             ||
||自訂連結文字的站內連結       ||`[:HelpContents:Contents of the Help]`||                          ||
||自訂連結文字的外部連結       ||`[http://example.net example site]`||                             ||
||站內圖形 (附件)             ||`attachment:graphics.png`          ||圖形會直接顯示在頁面上         ||
||外部圖形                   ||`http://example.net/image.png`     ||圖形會直接顯示在頁面上          ||
||在 Wiki``Name 連結前後加字  ||{{{WikiName``s}}}                  ||                             ||
||抑制 Wiki``Name 連結       ||`!WikiName`                        ||此為可設定的功能               ||

= 解釋及範例 =

== 任意命名的頁面 ==

如果你用方括號和雙引號將一串字 {{{["像這樣"]}}} 包起來，這樣就可以建立一個連結到名稱為 '''像這樣'''
的頁面。這是系統可選擇的設定，將 `allow_extended_names` 設成 true 才可以為頁面任意命名，包含中文的頁面名稱。

== URL 和頁面內嵌圖片 ==
有很多方法可以建立外部連結<<FootNote(相對於外部連結的是站內連結，亦即連到同屬於一個 wiki 網站的頁面)>>：
 * 直接寫出 URL。如果 URL 有圖形的副檔名 ("{{{.gif}}}"、"{{{.jpg}}}" 或 "{{{.png}}}")，這個 URL 會轉成圖片標籤 (image tag)
 * 用方括號將 URL 括起來
 * Wiki 站際連結
 * Email 地址

有時輸入 URL 時會無法判斷出正確的結尾，此時可用下列方法解決：
 * 在 URL 的結尾多加一個空白
 * 使用 Wiki:SixSingleQuotes 所介紹的方法
 * 用雙引號將 URL 括起來
 * 用方括號將 URL 括起來

目前支援的 URL 種類為：`http`、`https`、`ftp`、`nntp`、`news`、`mailto`、`telnet`、`irc` 及 `file`。系統管理者可以設定 {{{url_schemas}}} 選項來增加 URL 的種類，詳見 HelpOnConfiguration。

除了以上所列種類之外，還有 !MoinMoin 專用的 `wiki`、`attachment`、`inline` 及 `drawing`。
"`wiki`" 用來表示 wiki 站際連結，如：`MoinMoin:FrontPage` 和 `wiki:MoinMoin:FrontPage`
是相同的。一般情況下，你應該用比較簡短的形式，但使用 [link label] 格式時，"`wiki:`" 就省不掉了。
另外三個種類與附件有關，在 [[HelpOnActions/AttachFile|說明/操作/附加]] 會有詳細介紹。

關於如何連結到子頁面，請參考 [[HelpOnEditing/SubPages|說明/編輯頁面/子頁面]]。

要在頁面中安插錨點，必須利用 ''Anchor'' [[HelpOnMacros|巨集]]：`<<Anchor(anchorname)>>`，其中 "anchorname" 是此錨點的名字。要連結到同頁面的錨點可以用 `[#anchorname]` 或 `[#anchorname 連結文字]`。要連結到其他頁面的錨點可以用 `[:PageName#anchorname]` 或 `[:PageName#anchorname:連結文字]`。

我們經常需要用自訂的連結文字連結到同一網站的頁面。雖然你可以用 `[wiki:Self....]` 來達成這個目的，但這種方式的連結前面會有站際連結的圖示，這會讓使用者誤以為這會連結到其他網站。使用 `[:WikiPage:連結文字]` 這種形式的連結，可以解決上述問題。

/!\ 某些 wiki 網站可能無法區分大小，因此 RecentChanges 和 [[recentchanges]] 可能會指到相同的頁面。
Windows 和 Mac OS X 作業系統都有這個特性。

<<FootNote>>

=== 抑制不想要的連結 ===

要避免類似 Page``Name 這種大小寫混合的字串 (Camel``Case) 自動變成連結，可以寫成 {{{Page``Name}}}、{{{Page''''''Name}}} 或 {{{!PageName}}}。你可以抑制第三種方法，只要把 `bang_meta` 設成 disable 即可。

要避免 URL 自動變成連結，可以寫成 {{{`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] 這是部分的 URL (省略 hostname)
 * InterWiki
  * Self:InterWiki
  * MeatBall:InterWiki
  * wiki:MeatBall/InterWiki
  * [wiki:MeatBall/InterWiki]
  * [wiki:MeatBall/InterWiki InterWiki page on MeatBall]
 * user@example.com
 * mailto:user@example.com?subject=test
 * [:InterWiki:本站的 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]] 這是部分的 URL (省略 hostname)
 * InterWiki
  * InterWiki
  * MeatBall:InterWiki
  * MeatBall:InterWiki
  * MeatBall:InterWiki
  * [[MeatBall:InterWiki|InterWiki page on MeatBall]]
 * user@example.com
 * mailto:user@example.com?subject=test
 * [[InterWiki|本站的 InterWiki 頁面]]
 * [[#anchorname|連結到本頁面的錨點]]
 * [[OtherPage#anchorname|連結到本站其他頁面的錨點]]
 * [[首頁]]
 * [[首頁|連結到本站首頁]]
