Matrix Product Toolkit | PmWikiZhCn / 基本语法

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

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

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

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

常见标记语法示例

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

段落和换行

输入

输出

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

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

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

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

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

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

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

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

扩展阅读:

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

列表

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

* 饺子
* 面条
** 炸酱面
** 等等.

饺子
面条
- 炸酱面
- 等等.

# 第一部
# 第二部
## 第二部上

第一部
第二部
1. 第二部上

# 有序列表一号
# 有序列表二号
** 有序列表中的混搭风，无序列表

有序列表一号
有序列表二号
- 有序列表中的混搭风，无序列表

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

标题

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

输入

输出

!! 标题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都是不错的资料。

详见special characters文档。

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

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

可以直接用HTML吗?

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