On this page... (hide)
- 1. 完整的PmWiki支持的标记列表
- 2. SourceBlock 功能如何不切断有序列表标号
- 3. 官方特殊解决方案测试
- 4. 图片和正文混排的方法
- 5. 快捷引用自己签名和系统时间方法
- 6. Wiki风格使用
- 6.1 注释风格（系统自带）
- 6.2 文本框风格
- 6.3 文本高亮风格
- 6.4 文本强调风格
- 6.5 如何创建在新窗口打开的链接
- 7. 关于Wiki链接的一些技巧
这里记录一些自己在使用中发现的Wiki小经验，详细、全面的文档请查询PmWiki官方网站。常见的安装问题通常可以参考官方Troubleshooting。
- PmWiki界面的汉化方法见PmWiki2中文化的方法！
注：包括本页在内的本站绝大多数页面允许公开编辑，没有使用 PmWiki 的权限控制机制进行限制。但请只做有实际价值的修改，试用 Wiki 编辑请到 WikiSandbox 页面，谢谢！
1. 完整的PmWiki支持的标记列表
2. SourceBlock 功能如何不切断有序列表标号
我们一般用 # 号表明有序列表，这样Wiki会自动处理序号，但Source Block模块的 (:source:) 标签会切断自动生成的序号，也就是会这样：
# 列表第一项； (:source:) [= 示例代码内容 =] # 列表第二项却没有正常显示为2号； |
示例代码内容
|
出现这种情况的原因是两个 # 号之间在 (:source:) 标签开头有一个换行，就是这个换行切断了有序列表的标号。因此我们可以这么写来绕过这个问题：
# 列表第一项 (:source:) [= 示例代码内容 =] # 列表第二项正常生成了序号 |
|
3. 官方特殊解决方案测试
- 在SourceForge的项目空间上安装PmWiki：已经安装测试成功，该说明很清晰。已完成的项目主页地址是http://coralftp.sourceforge.net
- 独立运行PmWiki的方法：用最小的环境要求来运行PmWiki的方法，具体地讲，就是不需要Apache、不需要IIS，只要有PHP就可以的使用方法。用来做非公开的个人Wiki引擎或是测试PmWiki新功能的话非常方便。
4. 图片和正文混排的方法
类似写
5. 快捷引用自己签名和系统时间方法
在页面任何位置写左侧的代码（三个或四个弯，Shift＋键盘Esc下面那个键），都会在保存后翻译为右面这样：
[[~Elias]] |
[[~Elias]] 2013 年 04 月 19 日, 06:03 下午 | Elias 2013 年 04 月 19 日, 06:03 下午 |
6. Wiki风格使用
可以使用WikiStyles来自定义内容的显示样式，也可以用来自定义新的标签，比如建立一个文本框的标签等等。可以将自定义的标签加到GroupHeader使一个页面组都可以使用，也可以根据CustomWikiStyles将自定义的标签作用于整个Wiki站点。
6.1 注释风格（系统自带）
PmWiki自带的标签中， %comment% 标签很有用，可以用来标记不显示的注释。
6.2 文本框风格
另外我在config.php中添加了如下代码，提供了文本框功能（感谢官方邮件列表上Marc先生提供的指点）：
$WikiStyle['box']['background-color'] = '#eeeeff';
$WikiStyle['box']['border'] = '2px dotted blue';
$WikiStyle['boxtitle']['background-color'] = '#ccccff';
使用示例：
>>box<< %boxtitle%文本框标题%%\\ 文本框 >><< | 文本框标题 |
在没有定义这个标签的其他Wiki站点上，文本框效果可以通过手写如下代码得到：
>>bgcolor=#eeeeff border="1px dotted blue"<< %bgcolor=#ccccff% 标题 %%\\ 内容正文 >><< | 标题 |
6.3 文本高亮风格
以及在config.php中添加了如下代码，实现高亮显示特定文本的功能：
$WikiStyle['key']['color'] = 'blue';
使用示例：
被%key%强调%%的文本 | 被强调的文本
|
6.4 文本强调风格
以及在config.php中添加了如下代码，实现比高亮显示更强烈的视觉强调：
$WikiStyle['note']['color'] = 'red';
$WikiStyle['note']['font-size'] = '120%';
$WikiStyle['note']['font-weight'] = 'bold';
使用示例：
被%note%强调%%的文本 | 被强调的文本
|
6.5 如何创建在新窗口打开的链接
参考Links页面中关于“Links that open a new browser window”的说明，也即需要使用 %newwin%...%% 标记。
%newwin% http://pmichaud.com %% %newwin% [[http://google.com/ | Google]] %% %newwin% [[Main.WikiSandbox]] %% |
7. 关于Wiki链接的一些技巧
参考Links页面的说明，大致有以下关于链接的技巧可以使用：
在创建一个链接的时候，可以写“ [[PageName|+]] ”这样的写法，使得链接在显示时直接引用对应页面的 (:title PageTitle :) 设定，比如用这种方式引用本页，就显示为我的PmWiki经验，可以省了使用链接时用竖线自己控制显示名称的功夫。
如何链接到某页面的特定位置？可以这样：
- 首先在链接目的地的页面的所需位置，用“ [[#name]] ”这样的格式添加锚点；
- 之后在本页想链接到这个位置，可直接写“ [[#name|link text]] ”；
- 如果在其他页面想链接到这个位置，可以写“ [[PageName#name]] ”或“ [[PageName#name|link text]] ”这样的形式。