Matrix Product Toolkit | PmWikiZhCn / 主题风格

什么是主题风格？

主题风格可使你的Wiki看起来更加漂亮，不如试试下面的主题？

如你所见，一个不同的皮肤，虽然页面内容看起来一样，但是它的侧栏、页眉、页脚却都发生了改变。比如有些主题的侧栏在左，有些在右，有些甚至没有。在主题风格列表中的皮肤有一些动作链接和特点是独有的,特别是被精心设计过的这些主题。

皮肤文件默认在“pub/skins/”文件夹中。例如你要创建一个叫example'的主题，请把主题它们放在pub/skins/example/''。一个主题下面通常由一些文件构成：

一个模版文件。例如 skin.tmpl 或example.tmpl。这个文件由HTML或XHTML语言写成。这个文件可以告诉PmWiki，在那里插入那些内容。
用来控制页面外观（表现）的CSS文件。例如pmwiki.css或example.css。
一些页面中可能包含的图片文件。
PHP文件，例如skin.php 或example.php。它可以提供一些HTML 或CSS 无法胜任的定制能力。比如一个变量，一些函数功能。
一个叫做readme.txt、 install.txt 或skinname.txt的文档说明，你可以在其中写上你的大名、写上主题特点、介绍一下如何安装它们或者其它说明。

哪儿能得到它？

在主题风格列表中有很多主题。这些主题风格由PmWiki的使用者贡献，再次表示感谢。你可以寻找喜欢的主题下载。你也可以制作一份属于自己的主题。

如何安装使用它？

大多数主题都是一个类似 .zip, .tgz, or .tar.gz的压缩文件。你可以解压上传它们到对应的目录。

解压这些主题到“pub/skins/”目录 inside your pmwiki folder. 大多数友好主题，都自行创建了以自己主题名称命名的文件夹，直接长传到 “pub/skins/”就可以了。
- 如果主题压缩包没有创建自己的文件夹，你可以新建一个。
在“local/config.php”配置文件中，添加或编辑下面一行：

$Skin = 'example';

“example”请改为自己主题的文件夹名称。

F5刷新看看吧。

如果你想让你的Wiki访客自行选择主题风格，可以安装Skins:Skin Change插件 (该功能参见官方的主题demo页面。)

如何修改现有主题？

这里介绍一些改变现有主题的方法：

在 /local/config.php添加开启你的主题。
在/pub/css/中添加CSS文件。叫local.css (可以控制整个Wiki) 或叫做MyGroup.css 来控制单个组。
直接编辑主题文件。

如果你想修改默认的pmwiki主题或打印样式，建议你将主题文件夹直接复制一份，并重命名，只是也应该备份一下默认主题以备不时之需。这里的“skin.tmpl”和 “skin.css”文件名通常不重要，但“skin.php” 必须要和主题同名。

如何制作一款主题？

最好的方法就是复制一份PmWiki默认主题，并基于此主题修改。

复制“'pub/skins/pmwiki”文件夹并改成你的主题名。
在local/config.php配置文件中，设置$Skin变量为你的主题名称。
修改你的主题模版和CSS样式文件。
测试你的新主题。
重复3、4步，直到你满意为止。

下面本来是三大段内容，我将简化为3句。推荐从PmWiki默认主题文件开始学习制作--你的主题。

你可以使用HTML、XHTML和CSS，但别再用老旧的表格方式，同时注意HTML是内容，CSS是表现。

你应该尽可能的在各个常用浏览器测试你的主题，以保证其兼容性。

打印主题

默认的打印主题在“/pub/skins/print/”文件夹中。

在“local/config.php”配置文件中添加下面一行，就可以改变打印主题了：

$ActionSkin['print'] = 'yourprintskin';

现在，通过“?action=print”（打印功能），将会改为你设置的“yourprintskin”主题样式了。

你需要的工具

亲，这里介绍的工具都是免费的哦。

HTML和CSS编辑器 这里有两种类型的编辑器: graphical (可视化的，所见即所得), 和hand-coding或programmer's editors。 Graphical editors是初学者的选择，但是如果你会点代码，可以考虑hand-coding编辑器。不论选择那个，都将得到一堆邻人头疼的高亮代码，它将会帮你更容易的发现错误。

Test wiki（测试Wiki）。为了避免让访客看到你Wiki可能会发生的一些变动问题，强烈建议你使用本地的（ Cookbook:Standalone ）离线版PmWiki或在子测试Wiki中测试，完成后再在主Wiki上线使用。

FTP软件 来上传你的文件。

颜色拾取器。你或许需要一个颜色拾取器来设置页面颜色。

扩展阅读

我如何改wiki名字？

在“config.php”配置文件中，编辑下面这行

$WikiTitle = 'My Wiki Site';

如何改变页面提示块的CSS样式

添加像 .quickref {background:...; color:... }. 的CSS样式到“pub/css/local.css”中，提示块使用Site.EditQuickReference 页面，比如PmWiki和Site组，编辑并改变“bgcolor”或字体设置的其他“color”。