Basic Editing

authors (basic)

<< | Documentation Index | Creating new pages >>

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

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

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

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

範例

下面的表格列出一些常用的標記。左欄位顯示標記效果，右欄位說明如何使用這些標記。更詳細的標記說明在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` 預先格式的文字區塊	@@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 Basic Editing:)

區塊樣式

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

<< | Documentation Index | Creating new pages >>

The pages on this site are WikiWikiWeb pages, which means that pages can be created and edited by multiple authors. To edit a page, click the Edit link that exists somewhere on the page, usually in the header or footer. Some pages may be password-protected, depending on the system's security policies, but many systems allow open editing of pages.

When editing a page, you see the markup text that describes the content of the page. The basic rules for page markup are fairly simple:

Put a blank line between paragraphs
To make a list, start each line with # for numbered (ordered) lists or * for bulleted (unordered) lists.
To make a heading, start a line with two or more ! marks; !! is a subheading, and !!! is a sub-subheading.
To emphasize text, enclose it in 2 or 3 single quotes; ''text'' for italics or '''text''' for bold.
To make a link to another page, enclose the page's name in double brackets; for example [[basic editing]] links to this page. Links to nonexistent pages are displayed specially, to invite others to create the page.
To make a link to another site, type its address, such as http://www.example.com/ .

If you want to experiment with editing a page, try it on the WikiSandbox. You can edit the WikiSandbox without affecting anything important on this site. If you do edit other pages, it's courteous to sign your contribution; using ~~~ effectively 'signs' the name that you provide in the Author field on the Page Edit form.

Examples

The table below demonstrates many of the common markups used to format pages. The left column shows the effect of the markup, the right column shows what to write to achieve the effect. More details are available from the text formatting rules and other documentation pages. An exhaustive list of default markup is available as the markup master index

General Usage

What it looks like	What to type
An empty line starts a new paragraph.	An empty line starts a new paragraph.
A single newline usually doesn't affect the layout. Use two backslashes to break a line.	A single newline usually doesn't affect the layout. Use two backslashes\\ to break a line.
A single backslash joins the next line to the previous one.	A single backslash \ joins the next line \ to the previous one.
Use three backslashes for two line breaks.	Use three backslashes\\\ for two line breaks.
Lists are created by using asterisks More asterisks produce deeper lists The list is terminated by the first line that is not a list Numbered lists are also possible and lists can nest	* Lists are created by using asterisks More asterisks produce deeper lists * The list is terminated by the first line that is not a list # Numbered lists # are also possible ** and lists can nest
An arrow (->) indents content. Line up text to continue the indent. Longer arrows (-->) indent further. A reverse arrow (-<) creates a hanging indent, the first line is outdented and remaining lines are indented. Longer reverse arrows indent further.	-> An arrow (->) indents content. Line up text to continue the indent. -->Longer arrows (-->) indent further. -<A reverse arrow (-<) creates a \ hanging indent, the first line \ is outdented and remaining lines \ are indented. --< Longer reverse arrows indent \ further.
Definition list list of definitions item the item's definition another item that item's definition	: Definition list : list of definitions : item : the item's definition : another item : that 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.
This text is centered. This text is right justified.	%center% This text is centered. %right% This text is right justified.
Four or more dashes at the beginning of a line produce a horizontal line.	Four or more dashes at the beginning of a line ---- produce a horizontal line.

Links

What it looks like	What to type
Practice editing in the wiki sandbox. Text in double brackets become links to other pages. Words are automatically capitalized in page titles.	Practice editing in the [[wiki sandbox]].
Practice editing in the WikiSandbox. Which one? Oh, in the Main.WikiSandbox. When linking to a page in a different wikigroup, provide the group name, followed by a separator, and then the page name. If the separator you use is a slash, only the page name will appear. If the separator you use is a dot, the full string will appear.	Practice editing in the [[Main/WikiSandbox]]. Which one? Oh, in the [[Main.WikiSandbox]].
Practice editing in the practice area. Practice editing in the practice area. Practice editing in the practice area. Text after a pipe (\|) is used as the link text, or use the alternate (and perhaps more understandable) arrow (text -> link) notation.	Practice editing in the [[WikiSandbox \| practice area]]. Practice editing in the [[Main.WikiSandbox \| practice area]]. Practice editing in the [[practice area -> WikiSandbox]].
Practice editing in the wiki sandboxes. Practice editing in the sandbox. Endings become part of the link text. Parentheses hide parts of the link name.	Practice editing in the [[wiki sandbox]]es. Practice editing in the [[(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?
Links to external sources can be entered bare url: http://google.com link text: Google as reference: [2]	Links to external sources can be entered # bare url: http://google.com # link text: [[http://google.com \| Google]] # as reference: [[http://google.com \|#]]
Links can open in another window, as in http://www.pmwiki.org.	Links can open in another window, as in %newwin% http://www.pmwiki.org.

Character formatting

Emphasize, strongly, *very strongly*. These are all apostrophes (single-quote marks), not double-quotes.	''Emphasize'', '''strongly''', '''''very strongly'''''.
`Monospaced text` This is a preformatted text block	@@Monospaced text@@ [@This is a preformatted text block@]
Text with ^superscripts Text with _subscripts deleted ~~strikethrough~~ text inserted underline text big, bigger text small, smaller text	* Text with '^superscripts^' * Text with '_subscripts_' * deleted {-strikethrough-} text * inserted {+underline+} text * [+big+], [++bigger++] text * [-small-], [--smaller--] text
WikiStyles allow text to be different colors. Use lowercase letters for RGB colors (#ff7f00, not #FF7F00).	[[WikiStyles]] allow %red% text %blue% to %green% be %color=#ff7f00% different %%colors.

Headings and blocks

Major Subheading

Major Subheading With Smaller Text

Minor Subheading

And More

Subheadings

Headings are useful for creating a "well-structured" page. They're not just for making big text.

!! Major Subheading
!! [-Major Subheading With Smaller Text-]
!!! Minor Subheading
!!!! And More
!!!!! Subheadings

Page titles

Not shown

The (:title:) directive sets the page's title to something other than its name.

(:title Basic Editing:)

Block styles

All of the text in this block is purple.

Purple cows and purple flowers
Purple people eater
Now this list is red
and this text is centered
and this text is right justified
And this is normal

>>purple<<
All of the text in this block
is purple.
* Purple cows and purple flowers
* Purple people eater
>>red<<
* Now this list is red
>>center<<
* and this text is centered
>>right<<
* and this text is right justified
>><<
* And this is normal

<< | Documentation Index | Creating new pages >>

I'm new to PmWiki, where can I find some basic help for getting started?

This Basic Editing page is a good start. From there, you can just follow the navigational links at the bottom of the page (they are called WikiTrails) to the next pages, or to the Documentation Index page, which provides an outline style index of essential documentation pages, organized from basic to advanced.

How do I include special characters on my wiki pages?

Use character codes to insert special characters, such as Copyright (©) and Trademark (® or ™) symbols, that don't appear on your keyboard.