this page is outdated and needs to be fixed
快速參考
超連結 |
語法 |
說明 |
站內 WikiName 名稱頁面連結 |
WikiName |
CamelCase 形式的頁面名稱 |
站內任意名稱頁面連結 |
["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 |
圖形會直接顯示在頁面上 |
在 WikiName 連結前後加字 |
WikiName``s |
|
抑制 WikiName 連結 |
!WikiName |
此為可設定的功能 |
解釋及範例
任意命名的頁面
如果你用方括號和雙引號將一串字 ["像這樣"] 包起來,這樣就可以建立一個連結到名稱為 像這樣 的頁面。這是系統可選擇的設定,將 allow_extended_names 設成 true 才可以為頁面任意命名,包含中文的頁面名稱。
URL 和頁面內嵌圖片
有很多方法可以建立外部連結1:
直接寫出 URL。如果 URL 有圖形的副檔名 (".gif"、".jpg" 或 ".png"),這個 URL 會轉成圖片標籤 (image tag)
- 用方括號將 URL 括起來
- Wiki 站際連結
- Email 地址
有時輸入 URL 時會無法判斷出正確的結尾,此時可用下列方法解決:
- 在 URL 的結尾多加一個空白
使用 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:" 就省不掉了。 另外三個種類與附件有關,在 說明/操作/附加 會有詳細介紹。
關於如何連結到子頁面,請參考 說明/編輯頁面/子頁面。
要在頁面中安插錨點,必須利用 Anchor 巨集:<<Anchor(anchorname)>>,其中 "anchorname" 是此錨點的名字。要連結到同頁面的錨點可以用 [#anchorname] 或 [#anchorname 連結文字]。要連結到其他頁面的錨點可以用 [:PageName#anchorname] 或 [:PageName#anchorname:連結文字]。
我們經常需要用自訂的連結文字連結到同一網站的頁面。雖然你可以用 [wiki:Self....] 來達成這個目的,但這種方式的連結前面會有站際連結的圖示,這會讓使用者誤以為這會連結到其他網站。使用 [:WikiPage:連結文字] 這種形式的連結,可以解決上述問題。
某些 wiki 網站可能無法區分大小,因此 RecentChanges 和 recentchanges 可能會指到相同的頁面。 Windows 和 Mac OS X 作業系統都有這個特性。
相對於外部連結的是站內連結,亦即連到同屬於一個 wiki 網站的頁面 (1)
抑制不想要的連結
要避免類似 PageName 這種大小寫混合的字串 (CamelCase) 自動變成連結,可以寫成 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] * [email protected] * mailto:[email protected]?subject=test * [:InterWiki:本站的 InterWiki 頁面] * [#anchorname 連結到本頁面的錨點] * [:OtherPage#anchorname:連結到本站其他頁面的錨點] * ["首頁"] * [:首頁:連結到本站首頁]
呈現結果
http:/wiki/common/moinmoin.png 這是部分的 URL (省略 hostname)