## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##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|連結到本站其他頁面的錨點]]
* [[首頁]]
* [[首頁|連結到本站首頁]]