开发文档

PmWikiZhCn: 主题风格

目录

什么是主题风格?

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

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

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

哪儿能得到它?

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

如何安装使用它?

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

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

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

F5刷新看看吧。

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

如何修改现有主题?

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

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

如何制作一款主题?

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

  1. 复制“'pub/skins/pmwiki”文件夹并改成你的主题名。
  2. 在local/config.php配置文件中,设置$Skin变量为你的主题名称。
  3. 修改你的主题模版和CSS样式文件。
  4. 测试你的新主题。
  5. 重复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”。

来源地址:https://open.kisdee.com/wiki/index.php?n=PmWikiZhCn.Skins
本页面最后修订于:2012年-11月-11日