Basic Editing

<< | PmWikiZhCn | >>

下面内容是英文原版的编辑指南,需要做的就是大家有空的时候就翻译一些,保存一下,建议翻译一点之后就保存,免得和别人翻译的冲突了。

参与(basic)

这里的网页都是采用WikiWikiWeb网页, 特点是可以被很多人参与创建、编辑、维护. 编辑一个页面只需要点页面上的 Edit(编辑) 连接(通常在一个页面的顶部或底部). 系统将允许开放编辑大多数页面, 介于系统安全规则,有的页面可能被 password?(密码)-保护.

当大家在编辑页面的时候,会看到标记文本(markup text)描述了此页面的内容。标记文本的基本规则十分简单:

  1. 在每两个段落之间加一个空行;
  2. 写列表时,每行以 # 开始则显示数字(有序),以 * 开始则显示小圆点(无序);
  3. 要写标题,以 ! 开始一行,!! 是小标题,!!! 是小小标题;
  4. 要强调一段文字,用两个或以上单引号括起,''某某某''是斜体,'''某某某'''是粗体,''''某某某''''粗斜体;
  5. 要链接到另一个页面,用两对方括号括起那个页面的名字。比如 [[Editing]] 链接到此页面,而到 不存在的页面? 的链接将会有特别的显示,以邀请他人来创造此页;
  6. 要链接到另一个站点,写上它的地址,就如 http://www.example.com/
  7. 取别名用'|'。如有个标题是[ [Main/Home|首页] ]将链接到'Main/Home',而显示的名称却不是'Home'而是'首页'见样例首页?
  8. 对齐方式:'% center %','% left %','% right %'。左突出标题'% sidehead %',如果你想原样显示命令文本,请在中间加上空格如将'% center %'写成''% center %'

注意:所有标记(诸如 ! 或 ' ),要在英文状态下输入,而不是中文输入法下的中文符号。

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

A single newline usually doesn't affect the layout. But it does ''(unfortunately) affect'' mark up.

A single newline
usually doesn't affect the layout.  
But it does ''(unfortunately)
affect'' mark up.

An author must

place an empty line in the markup to start a new paragraph. For a break
in the paragraph, use two backslashes.

An author must

place an empty line in the markup to
start a new paragraph. For a break\\
in the paragraph, use two backslashes.
  • Lists are created by using asterisks
    • More asterisks result in deeper lists
      • The list is terminated

by the first line that is not a list

  1. Numbered lists
  2. are also possible
    • and lists can nest
* Lists are created by using asterisks
** More asterisks result in deeper lists
*** The list is terminated
by the first line that is not a list

# Numbered lists
# are also possible
** and lists can nest
  • A backslash at the end of a line joins the next line to the previous one.
  • Two backslashes create
    a line break.
  • Three backslashes generate

    two line breaks.
* A backslash at the \
end of a line joins the \
next line to the previous one.
* Two backslashes create \\
a line break.
* Three backslashes generate\\\
two line breaks.
An arrow (->) indents an entire paragraph.
Longer arrows (-->) indent an entire paragraph more.
A reverse arrow (-<) creates a hanging indent, the first line is outdented and remaining lines are indented.
Again, longer reverse arrows (--<) indent an entire paragraph more.
->An arrow (->) indents an entire paragraph.
-->Longer arrows (-->) indent an entire paragraph more.

-<A reverse arrow (-<) creates a \
hanging indent, the first line \
is outdented and remaining lines \
are indented.
--< Again, longer reverse arrows (--<) \
indent an entire paragraph more.
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.

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.

  • Text after a pipe (|) is used as the link text
Practice editing in the
[[WikiSandbox | practice area]].

Practice editing in the
[[Main.WikiSandbox | practice area]].

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

  1. bare url: http://www.google.com
  2. link text: Google
  3. as reference: [1]
Links to external sources can be entered
# bare url:  http://www.google.com
# link text: [[http://www.google.com | Google]]
# as reference: [[http://www.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, small, smaller text
* Text with '^superscripts^'
* Text with '_subscripts_'
* deleted {-strikethrough-} text
* inserted {+underline+} text
* [+big+], [++bigger++], [-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

Minor subheading

And more

Subheadings
!! Major subheading
!!! 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