PmWikiZhCn / 主题风格

什么是主题风格?

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

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

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

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

哪儿能得到它?

主题风格列表中有很多主题。 这些主题风格由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页面。)

如何修改现有主题?

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

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

如果你想修改默认的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”。