Rob Probin's Site | PmWikiZhTw / 基本編輯語法

這個網站上的頁面是 WikiWikiWeb 網頁，意味著（幾乎）任何人都可以任意建立和編輯頁面。想要編輯正在瀏覽的頁面，只需點一下頁首或頁尾的「編輯」的連結。有些頁面可能有密碼保護，端看網站管理員如何來設定系統，但是許多 WikiWikiWeb 系統允許任何人「開放共同編輯」所有的頁面。

進入編輯畫面後，會見到描述本頁面內容的「標記文字（markup test）」。編輯頁面的基本規則非常簡單︰

段落：使用空白的一行來表示一個新的段落 more
編輯清單︰#為有序列表，*為無序列表。
題標字體︰在行前面加上驚嘆號，一個表示主標題，兩個表示次標題…以此類推。
字體變化︰在文字前後加上一到數個單引號(single quotes)。兩個單引號為斜體，如''text''；三個單引號為粗體，如'''text''' 。
連結頁面︰在欲連結的頁面名稱前後加上兩個中括號(double brackets)，例如[[basic editing]]。連結到尚未建立的頁面時，其名稱末端會有^?出現，點入即開始編輯該頁，例如nonexistent pages ?。
連結其它網站：直接輸入其網址，記得加上http://。例如http://www.example.com/ 。

如果你想要熟悉 Wiki 的功能，請務必至WikiSandbox來試著練習編輯頁面。你可以任意編輯測試沙盒的頁面，而不會影響網站上任何重要的資訊。如果你編輯了其它頁面，加入~~~簽下你在作者欄所填入的名稱，用來對大家展現出該有的禮節。

範例

下面的表格列出一些常用的標記。左欄位顯示標記效果，右欄位說明如何使用這些標記。更詳細的標記說明在text formatting rules ?頁面中，以及其它說明文件裡都可以找到。完整的標記說明在markup master index ?頁面中。

常用排版標記

標記效果	使用方法
單一個斷行不會對版面造成任何影響。	單一個斷行不會對版面造成任何影響。
一位作者必須插入一個空行以產生出新的段落。在段落中要斷行的話，在行尾打上兩個反斜線。	一位作者必須插入一個空行以產生出新的段落。在段落中要斷行的話，\\ 在行尾打上兩個反斜線。
使用「星號（*）」製作清單「星號」的個數決定其所在層次清單列表結束此行不在清單中也可以使用有序清單有序清單有序清單與無序清單混用	* 使用「星號（）」製作清單 * 「星號」的個數決定其所在層次 * 清單列表結束此行不在清單中 # 也可以使用有序清單 # 有序清單有序清單與無序清單混用
行尾加上一個反斜線，將下一行接續到本行之後。行尾加上兩個反斜線會產生斷行。行尾加上三個反斜線會產生兩個斷行。	* 行尾加上一個 \ 反斜線，將下一行 \ 接續到本行之後。 * 行尾加上兩個反斜線 \\ 會產生斷行。 * 行尾加上三個反斜線\\\ 會產生兩個斷行。
一個箭頭 (->) 將使段落縮排。箭頭愈長縮排愈深反向的箭頭 (-<) 將造成段落首行凸排。同樣箭頭愈長愈凸。	->一個箭頭 (->) 將使段落縮排。 -->箭頭愈長縮排愈深 --<反向的箭頭 (-<) 將造成段落首行凸排 \ 。同樣箭頭愈長愈凸。
Definition list list of definitions item the item's definition another item another item's definition	: Definition list : list of definitions : item : the item's definition : another item : another item's definition
Lines that begin with a space are formatted exactly as typed, in a fixed-width font. Note that very long lines of preformatted text can cause the whole page to be wide.	Lines that begin with a space are formatted exactly as typed, in a fixed-width font.
文字置中文字靠右	%center% 文字置中 %right% 文字靠右
在行首輸入四個以上的橫線（-）來產生水平分隔線	在行首輸入四個以上的橫線（-） ---- 來產生水平分隔線

連結

標記效果	使用方法
到wiki sandbox去練習編輯技術吧！以雙中括號框住的文字將連結至其它頁面文字的首個字母將自動轉成大寫（對英文字而言）	到[[wiki sandbox]]去練習編輯技術吧！
到練習區去訓練編輯技術這樣子的連結會顯示管線（\|）後的文字	到[[WikiSandbox \| 練習區]]去訓練編輯技術
到wiki sandboxes去練習編輯技術吧！到 sandbox去練習編輯技術吧！ Endings become part of the link text. Parentheses hide parts of the link name.	到[[wiki sandbox]]es去練習編輯技術吧！到[[(wiki) sandbox]]去練習編輯技術吧！
What's an aardvark, anyway? Pmwiki can use InterMap prefixes ? that have specific meanings. Parentheses can hide those too.	%newwin%What's an [[(Wikipedia:)aardvark]], anyway?
連結到外部網頁純粹URL： http://www.google.com 結示連結文字：Google 當作參考文獻：[1]	連結到外部網頁 # 純粹URL： http://www.google.com # 結示連結文字：[[http://www.google.com \| Google]] # 當作參考文獻：[[http://www.google.com \|#]]
開啟新視窗顯示外部連結︰ http://www.pmwiki.org.	開啟新視窗顯示外部連結︰ %newwin% http://www.pmwiki.org.

文字格式

斜體, 粗體, *粗斜體*. 注意要用單引號（'）。	''斜體'', '''粗體''', '''''粗斜體'''''.
`Monospaced text` 預先格式的文字區塊	@@等寬字型@@ [@預先格式的文字區塊@]
上標字 ^superscripts 下標字 _subscripts 刪除線 ~~strikethrough~~ text 底線 underline text 放大, 放更大, 縮小, 縮更小 text	* 上標字 '^superscripts^' * 下標字 '_subscripts_' * 刪除線 {-strikethrough-} text * 底線 {+underline+} text * [+放大+], [++放更大++], [-縮小-], [--縮更小--] text
WikiStyles允許文字具有不同的顏色顏色碼記得使用小寫英文字母（例如#ff7f00，而不是 #FF7F00）。	[[WikiStyles]]允許%red%文字 %blue%具有%green%不同 %color=#ff7f00%的%%顏色

標題與區塊

標題二

標題三

!! 標題二

!!! 標題三

頁面標題

在此不顯示，請看瀏覽器上方。

(:title:) 指令將網頁標題設為指定字詞，而非使用頁面名稱。

(:title 基本編輯語法:)

區塊樣式

All of the text in this block is purple.

Purple cow
Purple people eater
Now this list is red
And this is normal

>>purple<<
All of the text in this block
is purple.
* Purple cow
* Purple people eater
>>red<<
* Now this list is red
>><<
* And this is normal

<< Introduction ? | Documentation Index | 新增頁面 >>

我是一位PmWiki的新使用者，我要在哪裡找到一些基本的幫助來開始我的使用呢？

在Basic Editing 頁面就是一個很好的開始。你可以遵照著頁首或頁尾的指引連結(這些連結又稱為 Wiki Trails ?))來學習不同的知識。或者，你可以到Documentation Index頁面，裡面提供了大綱式的文件列表，你可以在那裡找到從基礎到進階的知識。

請參見special characters ?，裡面有說明如何輸入一些特別的符號，是不在你鍵盤上的。

為什麼在編輯時分開的二行在顯示的時候，卻是以一行呈現的呢？

PmWiki 會將連續的文字視為一個段落來處理，並且將被自動拆行的文字合併成一個段落。基本上，大部份的Wiki系統也都遵照這樣的處理方式。而作者可以使用(:linebreaks:) 來直接加入一行空行(會呈現出來)。另外，網站的管理者也可以藉由設定 config.php $HTMLPNewline = '<br/>'; 來使整個網站，都有自動拆行的功能。

我可以直接輸入HTML語法嗎？

在預設的情況下，PmWiki是不支援HTML語法的(使用wiki語法是我們的設計理念)，其原因可以在PmWiki Philosophy 以及 Audiences頁面中找到。若是啟用HTML語法的話，在協同工作的環境中，會使得某些有意願的作者望而卻步(因為HTML語法是較複雜而困難的)。另外，啟用HTML語法將會造成許多在顯示上、安全性上的問題。然而，網站的管理者仍然可以藉由 Cookbook:Enable HTML 這個recipe來啟用HTML的語法元素。

我在哪裡可以找到更多的說明文件呢？

請參見documentation index 以及markup master index ? 頁面。