PmWikiZhCn

Basic Editing

英文原文Basic Editing? 这个网站上的页面是WikiWikiWeb网页,意味着(几乎)任何人都可以任意建立和编辑页面。 想要编辑正在浏览的页面,只需点一下页首或页尾的「编辑」的连结。 有些页面可能有password?密码保护,网站管理员如何来设定系统,但是许多 WikiWikiWeb 系统允许任何人「开放共同编辑」所有的页面。

进入编辑画面後,会见到描述本页面内容的 markup text。编辑页面的基本规则非常简单:

  1. 段落之间以空行分隔.
  2. 编辑列表:#为有序列表,*为无序列表.
  3. 标题字体:在行前面加上惊叹号,一个表示主标题,两个表示次标题…以此类推.
  4. 字体变化:在文字前後加上单引号。两个单引号为斜体,如''text'';三个单引号为粗体,如'''text'''
  5. 链接页面︰在欲连结的页面名称前後加上两个中括号,例如[[basic editing]]。连结到尚未建立的页面时,其名称末端会有?出现,点入即开始编辑该页,例如nonexistent pages?
  6. 连结其它网站:直接输入其网址,记得加上http://。例如http://www.example.com/.

如果你想要熟悉 Wiki 的功能,请务必至WikiSandbox来试着练习编辑页面。你可以任意编辑 测试沙箱 的页面,而不会影响网站上任何重要的资讯。如果你编辑了其它页面,使用~~~签下你在作者栏所填入的名称,用来对大家展现出该有的礼节。

Examples

下面的表格列出一些常用的标记。左栏位显示标记效果,右栏位说明如何使用这些标记。更详细的标记说明在text formatting rules页面中,以及其它说明文件里都可以找到。完整的标记说明在markup master index?页面中。

General Usage

效果

语法

一行空行

开始一个新的段落

一行空行

开始一个新的段落

一个新行 通常不影响效果 使用俩个反斜线
来分割新行

一个新行
通常不影响效果
使用俩个反斜线\\
来分割新行

一个单独的反斜线 连接下一行连接 到前一行

一个单独的反斜线 \
连接下一行连接 \
到前一行

使用三个反斜线

来打断俩行

使用三个反斜线\\\
来打断俩行
  • 列表用星号标示
    • 更多的星号是更深层次的列表
      • 列表的终止符

由第一个不是列表的行还终止

  1. 编号列表
  2. 之下也可以
    • 使用列表嵌套
* 列表用星号标示
** 更多的星号是更深层次的列表
*** 列表的终止符
由第一个不是列表的行还终止

# 编号列表
# 之下也可以
** 使用列表嵌套
一个箭头 (->) 产生缩进.
排列文本来继续缩进
更长的箭头 (-->) 产生更多的缩进.
一个反向的箭头 (-<) 建立一个悬挂的缩进, 这一行没有缩进,但是后面的行仍然缩进
更长的反箭头,缩进更多.
-> 一个箭头 (->) 产生缩进.

   排列文本来继续缩进

-->更长的箭头 (-->) 产生更多的缩进.

-<一个反向的箭头 (-<) 建立一个\
悬挂的缩进, 这一行\
没有缩进,但是后面的行\
仍然缩进
--< 更长的反箭头,\
缩进更多.
定义列表
定义的清单
项目
项目定义
其他项目
其他项目定义
: 定义列表 : 定义的清单
: 项目 : 项目定义
: 其他项目 : 其他项目定义
 以空格开始的行被格式化为等宽字体
 fixed-width font.

注意如果行非常长,可能超过页宽

 以空格开始的行被格式化为等宽字体
 fixed-width font.

文本居中.

文本右对齐.

%center% 文本居中.

%right% 文本右对齐.

以四个破折号 开始的行


被处理成水平线

以四个破折号
开始的行
----
被处理成水平线

Links?

效果

语法

wiki sandbox? 中练习编辑

  • 在俩个方括号中的文本被连接到新的页
  • 方括号的文本自动的成为页标题
在[[wiki sandbox]]
中练习编辑

WikiSandbox 中练习编辑

哪一个? 在Main.WikiSandbox

  • 当连接到不同的wiki组时,提供组名,跟着一个分割符,然后是页名
  • 如果使用除号作为分隔符,只显示页名
  • 如果分隔符是点号,会显示完整的名称
在[[Main/WikiSandbox]]
中练习编辑

哪一个?
在[[Main.WikiSandbox]]中

practice area? 中练习编辑

practice area 中练习编辑

practice area? 中练习编辑

  • (|)管道符号后面的文本作为链接文本或者使用箭头(更容易理解)来表示(text -> link)
在[[WikiSandbox | practice area]]
中练习编辑

在[[Main.WikiSandbox | practice area]]
中练习编辑

在[[practice area -> WikiSandbox]]
中练习编辑

wiki sandboxes? 中练习编辑

sandbox? 中练习编辑

  • 后缀成为链接文本的一部分
  • 小括号隐藏部分链接文本
在[[wiki sandbox]]es
中练习编辑

在[[(wiki) sandbox]]
中练习编辑

什么是aardvark

什么是[[(Wikipedia:)aardvark]]

到外部的链接可以这样

  1. 显示完整URL: http://google.com
  2. 显示链接文本: Google
  3. 作为参照: [1]
到外部的链接可以这样
# 显示完整URL:  http://google.com
# 显示链接文本: [[http://google.com | Google]]
# 作为参照: [[http://google.com |#]]

链接可以在新窗口中打开 就像这样, http://www.pmwiki.org.

链接可以在新窗口中打开
就像这样, %newwin% http://www.pmwiki.org.

Character formatting

斜体, 加粗, 斜体加粗.

  • 这里都是单引号,不是双引号
''斜体'', '''加粗''', 
'''''斜体加粗'''''. 

Monospaced text

这里是
  预格式化
    文本块
@@Monospaced text@@ 
 
[@这里是
  预格式化
    文本块@]
  • 文本上标
  • 文本下标
  • 删除删除线文本
  • 插入下划线文本
  • 大字体, 更大字体 文本
  • 小字体, 更小字体 文本
* 文本'^上标^'
* 文本'_下标_'
* 删除{-删除线-}文本
* 插入{+下划线+}文本
* [+大字体+], [++更大字体++] 文本
* [-小字体-], [--更小字体--] 文本

WikiStyles 允许 红色 蓝色 绿色 特定颜色 等不同颜色.

  • 使用小写字母来表示RGB颜色(#ff7f00, 而不是 #FF7F00).
[[WikiStyles]] 允许 %red% 红色
%blue% 蓝色 %green% 绿色
%color=#ff7f00% 特定颜色 %%等不同颜色.

Headings and blocks

标题二

标题二的更小字体

标题三

更多的

子标题
  • Headings are useful for creating a "well-structured" page. They're not just for making big text.
!! 标题二
!! [-标题二的更小字体-]
!!! 标题三
!!!! 更多的
!!!!! 子标题
页面标题

在此不显示,请看浏览器上方

  • The (:title:) 指令将网页标题设为指定字词,而非使用页面名称.
(: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? | >>

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

The 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.

Why are separate lines of text in the markup combined into a single line on output?

PmWiki normally treats consecutive lines of text as being a paragraph, and merges and wraps lines together on output. This is consistent with most other wiki packages. However, an author can use the (:linebreaks:) directive to cause separate lines of markup text to be kept as separate lines in the output. ...