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

注:包括本页在内的本站绝大多数页面允许公开编辑,没有使用 PmWiki 的权限控制机制进行限制。但请只做有实际价值的修改,试用 Wiki 编辑请到 WikiSandbox 页面,谢谢!

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

参见:MarkupMasterIndex

2.  SourceBlock 功能如何不切断有序列表标号

我们一般用 # 号表明有序列表,这样Wiki会自动处理序号,但Source Block模块的 (:source:) 标签会切断自动生成的序号,也就是会这样:

# 列表第一项;
(:source:) [= 示例代码内容 =]
# 列表第二项却没有正常显示为2号;
  1. 列表第一项;
示例代码内容
  1. 列表第二项却没有正常显示为2号;

出现这种情况的原因是两个 # 号之间在 (:source:) 标签开头有一个换行,就是这个换行切断了有序列表的标号。因此我们可以这么写来绕过这个问题:

# 列表第一项 (:source:) [=
示例代码内容 =]
# 列表第二项正常生成了序号
  1. 列表第一项
    示例代码内容
  2. 列表第二项正常生成了序号

3.  官方特殊解决方案测试

4.  图片和正文混排的方法

类似写

%rfloat padding=10px% Attach:pic.jpg
这样的代码,并且独占一行,就可以不影响正文的格式。否则如果直接写Attach命令,则图片会只被当做一行文字与文字一起对齐。

5.  快捷引用自己签名和系统时间方法

在页面任何位置写左侧的代码(三个或四个弯,Shift+键盘Esc下面那个键),都会在保存后翻译为右面这样:


[[~Elias]]

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先生提供的指点):

# Enable custom style >>box<< and %boxtitle%:
$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中添加了如下代码,实现高亮显示特定文本的功能:

# Enable custom style %key% for emphasis:
$WikiStyle['key']['color'] = 'blue';

使用示例:

被%key%强调%%的文本
强调的文本 

6.4  文本强调风格

以及在config.php中添加了如下代码,实现比高亮显示更强烈的视觉强调:

# Enable custom style %note% for really big emphasis:
$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]] %%

http://pmichaud.com

Google

Main.WikiSandbox

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

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

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

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

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