基本语法

pmwiki使用wiki语法,它强调创作及合作,而非仅仅简单的浏览查看。通常在页眉或页脚有Edit链接方便更新页面。 当然有些页面是需要密码的。

PmWiki没有所见即所得的可视化编辑器--但你可以使用markup text去编辑页面内容,另外它也支持markdown语法。markup语法的简短介绍:

  1. 空一行即为另起一段 详情.
  2. 创建列表,有序列表使用 # 号,无序列表使用 * 号 详情.
  3. 设置标题, 使用感叹号!标记为标题,一个为大标题(h1),两个为副标题(h2),以此类推 详情.
  4. 强调, 使用单引号。''em'' 为倾斜 '''strong''' 为加粗 详情.
  5. 添加站内链接, 使用两个方括号将页面名字括起来。像这样 [[PmWiki中文很给力]] 就添加进来了 详情.
  6. 添加站外链接,直接输入地址就可以了http://example.com 。如果你确实有必要插入邮箱的话,直接在前面加"mailto:"。 详情

初次使用,可以在沙盒中练习这里开始练习。想留下你的 大名 可以使用三个波浪号 ~~~ 代表自己签名。如果你用wiki聊天,这么干是个不错的主意。(你用wiki聊天这个主意除外)

常见标记语法示例

下面左侧为语法,右侧为显示结果。更详细的可以从text formatting rulesmarkup master index中查询.

段落和换行

输入

输出

今天天气真好,
挺风和日丽的,
我们一起去郊游划船,捉蚂蚁吧。

这是新的一段,叫另起一段。

今天天气真好, 挺风和日丽的, 我们一起去郊游划船,捉蚂蚁吧。

这是新的一段,叫另起一段。

末尾加两个反斜杠 \\
郁闷的换行了。

或者使用左书名号[[<<]] 来强制换行。

末尾加两个反斜杠
郁闷的换行了。

或者使用左书名号
来强制换行。

扩展阅读:

  • 文本格式规则关于br换行,缩进等更多信息。
  • wiki样式 关于,居中、居右及 "浮动" 文本(模型), 边框的更多内容。

列表

使用#号表示有序列表,使用*号表示无序列表:

* 饺子
* 面条
** 炸酱面
** 等等.
  • 饺子
  • 面条
    • 炸酱面
    • 等等.
# 第一部
# 第二部
## 第二部上
  1. 第一部
  2. 第二部
    1. 第二部上
# 有序列表一号
# 有序列表二号
** 有序列表中的混搭风,无序列表
  1. 有序列表一号
  2. 有序列表二号
    • 有序列表中的混搭风,无序列表

更多关于列表的内容 (包括列表的定义) 和 列表样式.

标题

使用感叹号表示标题,他们可以使你的页面结构清晰,而不仅仅是看起来很大。

输入

输出

!! 标题2
!!! 标题3
!!!! 标题4
!!!!! 标题5

标题2

标题3

标题4

标题5

语气强调

使用单引号括起来,来表示强调。

输入

输出

''倾斜'',
'''加粗''' , 
'''''倾斜并加粗''''' 

倾斜, 加粗 , 倾斜并加粗

链接

使用两个方括号括起来,来表示链接。

输入

输出

到[[wiki sandbox]]里练习下。

wiki sandbox里练习下。

注意,这个此在页面中会自动大小写转换为WikiSandbox这样。

添加文本链接需要在文本前加一竖(|)符号,:

到
[[WikiSandbox | 沙盒]]中练习一下

沙盒中练习一下

更有趣和“纠结”的写法:

[[wiki sandbox]]es.

[[(wiki) sandbox]].

wiki sandboxes.

sandbox.

当链接的页面在不同的 WikiGroup,前面是组名(Main),后面添加一个空格,再加上页面名字(Wiki Sandbox)就可以了:

[[Main.Wiki Sandbox]] 显示组名 + 页面名

[[Main/Wiki Sandbox]] 仅显示页面名

Main.Wiki Sandbox 显示组名 + 页面名

Wiki Sandbox 仅显示页面名

站外链接

直接贴上url地址:  http://example.com

文字连接: [[http://example.com|链接演示]]

直接贴上url地址: http://example.com

文字连接: 链接演示

涉及引用的外部链接

bare url: http://example.com

链接锚点: [[http://example.com|#]]

bare url: http://example.com

链接锚点: [1]

冒号可以创建一个InterMap,方便连接到其它wiki网站中:

我国的[[Wikipedia:大熊猫|大熊猫]]像包子一样可爱。

我国的大熊猫像包子一样可爱。

连接到一个nonexistent pages?(不存在的页面)链接,将会特别显示。可以用这种方式来写项目集合,比如一本书名的页面,上面充满了第一章,第二章,第三章这些预先设置好的内容,写起来很方便,不是吗?

PmWiki支持大量链接类型和显示样式,详见链接页面。

预先格式化的文本

输入预先格式化过的文本内容(pre)。 注意,很长的文本pre段会影响页面美观,因为它不会自动换行。

下面是一段pre格式化过的段落,每行开始都有一个空格:

 这行有个空格。
 这行也有个。
 用'''等宽'''字体显示.
 这行有个空格。
 这行也有个。
 用等宽字体显示.

插入大段格式化过的代码:如果你不希望自己的代码被markup处理,可以插入到[@ @]中间。

[@
<html>
<head>
<title>春光明媚</title>
</head>
<body>
<h1>祝您健康快乐。</h1>
</body>
</html>
@]
<html>
<head>
<title>春光明媚</title>
</head>
<body>
<h1>祝您健康快乐。</h1>
</body>
</html>

转义字符串

如果你希望markup不处理,但需要重新排列为一行,请使用[= =]。例如插入一句短的代码。

[=
markup 是 ''不处理这个''的
但会在一行中显示。
=]

markup 是 ''不处理这个''的 但会在一行中显示。

水平分割线

在一行用4个及以上的破折号就可以插入分隔符了。
----
上面是一个打酱油的分隔符。

在一行用4个及以上的破折号就可以插入分隔符了。


上面是一个打酱油的分隔符。

表格

用两个竖线来分割单元格:

|| border=1
||! 表头1 ||! 表头2 ||! 表头3 ||
|| 单元格1  ||  单元格2 ||  单元格3 ||
表头1表头2表头3
单元格1单元格2单元格3

详情请看Tables and Table Directives

图片

直接想插入链接那样插入一个图片地址就可以了。像这样[[[http://example.com|Attach:Groupname./image.jpeg]]] 详见:如何插入图片

字体样式

输入

输出

* @@Monospaced text@@
* 文字'^上标^'
* 文字'_下标_'
* {-删除-} 文字
* 增加{+下划线+}
* [+大+], [++更大++]的字
* [-小-], [--更小--]的字
  • Monospaced text
  • 文字上标
  • 文字下标
  • 删除 文字
  • 增加下划线
  • , 更大的字
  • , 更小的字

使用WikiStyles来改变字体样式,像这样 红字 蓝字 绿字 浅棕色字 .

页面标题

插入像“(:title 新的页面标题:)”一个内容,就可以重命名你的页面标题,使它看起来和你的url显示名不同。

(:Title 基础语法:)
这样页面URL可以是"BasicEditing",但标题就变为"{$Title}"了.

这样页面URL可以是"BasicEditing",但标题就变为"基本语法"了.

页面描述

  • 这样“(:这里是页面描述:)”,可以更改页面介绍,使其利于搜索显示。同时可以显示在page lists中。
(:这里是PmWiki基础语法中文版:)
这个介绍将会显示在“{$Description}”变量中。

(:这里是PmWiki基础语法中文版:) 这个介绍将会显示在“”变量中。

刚刚起步,哪里可以找到更多的教程?

Wiki Trails)以及Documentation Index都是不错的资料。

我如何向页面中插入版权符号(©)和TM符号 (® or ™)这些特殊符号?

详见special characters文档。

我如此从原始text文档中保持行段?

作者可以使用 (:linebreaks:) 来保持行段,管理员也可设置 config.php $HTMLPNewline = '<br/>'; 强制产生换行。

可以直接用HTML吗?

默认是不可以的,不过你可以通过这个Enable HTML插件开启页面的HTML支持。