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样式 关于,居中、居右及 "浮动" 文本(模型), 边框的更多内容。
列表
使用#号表示有序列表,使用*号表示无序列表:
# 第一部
# 第二部
## 第二部上
| - 第一部
- 第二部
- 第二部上
|
# 有序列表一号
# 有序列表二号
** 有序列表中的混搭风,无序列表
| - 有序列表一号
- 有序列表二号
|
更多关于列表的内容 (包括列表的定义) 和 列表样式.
标题
使用感叹号表示标题,他们可以使你的页面结构清晰,而不仅仅是看起来很大。
!! 标题2
!!! 标题3
!!!! 标题4
!!!!! 标题5
| 标题2
标题3
标题4
标题5
|
语气强调
使用单引号括起来,来表示强调。
''倾斜'',
'''加粗''' ,
'''''倾斜并加粗'''''
| 倾斜,
加粗 ,
倾斜并加粗
|
链接
使用两个方括号括起来,来表示链接。
注意,这个此在页面中会自动大小写转换为WikiSandbox这样。
添加文本链接需要在文本前加一竖(|)符号,:
到
[[WikiSandbox | 沙盒]]中练习一下
| 到
沙盒中练习一下
|
更有趣和“纠结”的写法:
当链接的页面在不同的 WikiGroup,前面是组名(Main),后面添加一个空格,再加上页面名字(Wiki Sandbox)就可以了:
站外链接
涉及引用的外部链接
冒号可以创建一个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 ||
|
|
详情请看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基础语法中文版:)
这个介绍将会显示在“”变量中。
|