基本语法
(redirected from PmWikiZhCn.Editing)
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支持。