基础语法
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中查询.
段落和换行
输入 |
输出 |
今天天气真好, 挺风和日丽的, 我们一起去郊游划船,捉蚂蚁吧。 这是新的一段,叫另起一段。 | 今天天气真好, 挺风和日丽的, 我们一起去郊游划船,捉蚂蚁吧。 这是新的一段,叫另起一段。 |
末尾加两个反斜杠 \\ 郁闷的换行了。 或者使用左书名号[[<<]] 来强制换行。 | 末尾加两个反斜杠 或者使用左书名号 |
扩展阅读:
列表
使用#号表示有序列表,使用*号表示无序列表:
* 饺子 * 面条 ** 炸酱面 ** 等等. |
|
# 第一部 # 第二部 ## 第二部上 |
|
# 有序列表一号 # 有序列表二号 ** 有序列表中的混搭风,无序列表 |
|
标题
使用感叹号表示标题,他们可以使你的页面结构清晰,而不仅仅是看起来很大。
输入 |
输出 |
!! 标题2 !!! 标题3 !!!! 标题4 !!!!! 标题5 | 标题2标题3标题4标题5 |
语气强调
使用单引号括起来,来表示强调。
输入 |
输出 |
''倾斜'', '''加粗''' , '''''倾斜并加粗''''' | 倾斜, 加粗 , 倾斜并加粗 |
链接
使用两个方括号括起来,来表示链接。
输入 |
输出 |
到[[wiki sandbox]]里练习下。 | 到wiki sandbox里练习下。 |
注意,这个此在页面中会自动大小写转换为WikiSandbox这样。
添加文本链接需要在文本前加一竖(|)符号,:
到 [[WikiSandbox | 沙盒]]中练习一下 | 到 沙盒中练习一下 |
更有趣和“纠结”的写法:
[[wiki sandbox]]es. [[(wiki) 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 || |
|
详情请看Tables and Table Directives。
图片
直接想插入链接那样插入一个图片地址就可以了。像这样[[[http://example.com|Attach:Groupname./image.jpeg]]
]
详见:如何插入图片。
字体样式
输入 |
输出 |
* @@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支持。