• Login
• 查看
• 编辑
• 记录
• 打印

我的PmWiki经验

这里记录一些自己在使用中发现的Wiki小经验，详细、全面的文档请查询PmWiki官方网站。常见的安装问题通常可以参考官方Troubleshooting。

• PmWiki界面的汉化方法见PmWiki2中文化的方法！

1.  完整的PmWiki支持的标记列表

参见：MarkupMasterIndex

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下面那个键），都会在保存后翻译为右面这样：

~~~

~~~~

6.  Wiki风格使用

可以使用WikiStyles来自定义内容的显示样式，也可以用来自定义新的标签，比如建立一个文本框的标签等等。可以将自定义的标签加到GroupHeader使一个页面组都可以使用，也可以根据CustomWikiStyles将自定义的标签作用于整个Wiki站点。

PmWiki自带的标签中， %comment% 标签很有用，可以用来标记不显示的注释。

另外我在config.php中添加了如下代码，提供了文本框功能（感谢官方邮件列表上Marc先生提供的指点）：

使用示例：

>>box<<
%boxtitle%文本框标题%%\\
文本框
>><<

在没有定义这个标签的其他Wiki站点上，文本框效果可以通过手写如下代码得到：

>>bgcolor=#eeeeff border="1px
dotted blue"<<
%bgcolor=#ccccff% 标题 %%\\
内容正文
>><<

以及在config.php中添加了如下代码，实现高亮显示特定文本的功能：

使用示例：

 被%key%强调%%的文本 

 被强调的文本 

7.  关于Wiki链接的一些技巧

参考Links页面的说明，大致有以下关于链接的技巧可以使用：

在创建一个链接的时候，可以写“ [[PageName|+]] ”这样的写法，使得链接在显示时直接引用对应页面的 (:title PageTitle :) 设定，比如用这种方式引用本页，就显示为我的PmWiki经验，可以省了使用链接时用竖线自己控制显示名称的功夫。

如何链接到某页面的特定位置？可以这样：

1. 首先在链接目的地的页面的所需位置，用“ [[#name]] ”这样的格式添加锚点；
2. 之后在本页想链接到这个位置，可直接写“ [[#name|link text]] ”；
3. 如果在其他页面想链接到这个位置，可以写“ [[PageName#name]] ”或“ [[PageName#name|link text]] ”这样的形式。