皮肤可以更改PmWiki页面、页面组或整个wiki的外观。要查看此内容,请尝试使用下面的链接或皮肤部分PmWiki食谱。
皮肤是什么?
测试一些安装了pmwiki.org的皮肤:
如您所见,所有皮肤都显示相同的页面内容,但其他元素(如侧栏、页眉和页脚)已经更改。例如,不同的皮肤可能会在左侧、右侧显示侧边栏,甚至根本不显示。有些皮肤具有其他皮肤没有的动作链接和功能,特别是如果它们是为了利用特定的食谱.
因此,皮肤只是决定页面在PmWiki中显示方式的一组文件。皮肤存储为的子文件夹酒吧/皮肤/
。例如,您可以创建例子
皮肤进入pub/skins/示例/
。每个皮肤通常具有以下一种或多种文件:
- 模板文件,例如
皮肤.tmpl
或示例.tmpl
模板是用HTML或XHTML编写的,是皮肤的骨架。它包含特殊的标记,告诉PmWiki在哪里插入页面内容。 - CSS样式表文件,可以控制皮肤的外观,例如
pmwiki.css网站
或示例.css
. - 图像文件,用于用图像装饰页面。
- PHP文件,例如
皮肤.php
或示例.php
这些让皮肤提供了HTML和CSS无法提供的额外自定义设置或功能。 - 管理员的文档文件,通常名称如下
自述.txt
,安装.txt
或皮肤名称.txt
。这些通常会为您提供有关任何特殊安装步骤或皮肤具有的漂亮功能的信息。
我在哪里去皮?
皮肤可在皮肤收藏。集合中的皮肤由许多PmWiki管理员提供,供所有人使用,并且通常具有自己的一组自定义可能性。当你找到你喜欢的皮肤时,请按照链接下载皮肤包。你也可以做你自己的皮肤。
如何使用或安装皮肤?
大多数皮肤包都是.zip、.tgz或.tar.gz文件。您应该能够使用大多数存档软件将其解压缩。
- 打开皮肤包装
酒吧/皮肤/
在您的pmwiki文件夹中。大多数精心设计的皮肤包都会在酒吧/皮肤/
以皮肤命名。- 如果皮肤没有创建自己的文件夹,请创建一个文件夹并将皮肤文件移动到其中。
- 打开你的
本地/config.php
文件,并添加一行,如
$Skin=“示例”;
哪里例子
是皮肤文件夹的名称。
在浏览器中从wiki重新加载页面,您应该能够看到差异。
如果您想让站点的访问者从您安装的皮肤中选择一种皮肤,请查看皮肤变化配方。(这就是我们在上面的演示中使用的。)
如何修改现有蒙皮?
有很多方法可以进一步自定义皮肤的外观,包括
- 将语句添加到
/本地/config.php
与你选择的皮肤相容; - 将css文件添加到
/发布/css/
,例如本地.css
(对于整个wiki)和我的群.css
(对于MyGroup);和 - 直接编辑皮肤文件。
如果皮肤定期更新,您可能希望避免编辑皮肤文件夹中的文件。查看烹饪书中的皮肤页面以获取具体建议。
如果要修改pmwiki发行版中包含的默认pmwiki或打印皮肤,应复制pub/skins/pmwiki/
和酒吧/皮肤/印刷品/
目录设置为另一个名称,然后使用这些皮肤而不是默认皮肤。虽然皮肤.tmpl
和skin.css文件通常不重要,可选皮肤.php
文件必须与皮肤的名称匹配。
我怎么做皮肤?
制作第一个皮肤的最佳方法是修改PmWiki默认皮肤的副本。
- 制作文件夹的副本
pub/skins/pmwiki
不管你的新皮肤叫什么名字。 - 在您的
本地/config.php
文件,集合$皮肤
成为你新皮肤的名字。 - 修改模板和CSS文件以适合您。
- 测试你的新皮肤。
- 重复步骤3和4,直到你对结果满意为止。
我们建议从默认的PmWiki皮肤开始的原因是,它是一个非常简单的皮肤,比您在中找到的许多皮肤都要简单得多皮肤.起点是模板(.tmpl文件
)文件,它提供页面的总体布局。模板文件内部有许多特殊的替换和指令,为PmWiki插入与当前显示页面相关的数据提供了位置。皮肤模板更详细地描述了格式和指令。还有皮肤指南可在pmwiki.org上找到。
解释如何编写HTML(超文本标记语言)、XHTML(可扩展HTML,有点新)或CSS(级联样式表)超出了本页的范围,但网上有很多针对这三种语言的好教程。一个警告:如果你遇到一个HTML教程,解释如何使用<font>或<blink>标记或间隔gif,那么它已经过时很多年了,所以跳过它,再找一个。
你应该在各种浏览器上测试你的皮肤——最好是尽可能多地在不同的平台上测试——但至少你应该在当前版本的Edge、Firefox和Chrome上测试,因为它们是最常见的,并且有不同的bug,所以在Safari和移动浏览器上测试也很有用。不要忘记在测试期间调整窗口大小和更改文本大小。
您需要的工具
所有这些程序都有很好的免费示例。
HTML和CSS编辑器。有两种类型的编辑器:图形编辑器(所见即所得)和手工编码编辑器或程序员编辑器。图形编辑器对初学者来说没有那么可怕,但您不会学到那么多,也不会像使用手工编码编辑器那样熟悉您的代码。无论你选择哪一个,都要有一个语法高亮显示的代码,因为它可以帮助你发现错误。此外,在编写PmWiki皮肤时,实时预览功能并没有太大帮助,因为PmWiki会做实时预览所做不到的事情,比如用值替换变量和插入边栏内容。
测试wiki。当访问者可以看到你的网站时,你不想对你的皮肤造成破坏。最好在实际的Web服务器或自己的计算机上设置测试wiki。Linux或MacOS计算机所有者可能已经在其计算机上运行了Web服务器和PHP,但Windows用户通常不会。如果这能描述您的情况,那么您可能想看看食谱:独立菜谱,它运行PmWiki而不需要复杂的Web服务器,或者烹饪书:InstallOnIIS或者,您可以找到许多本地服务器包,它们安装了Web服务器、PHP和其他东西(例如MySQL),所有这些都配置为协同工作。试着获得一个与你的实时设置中使用的软件和版本相同的软件包,因为这样当网站上线时,出错的地方就会更少。
FTP客户端将文件传输到Web服务器。你可能已经吃过了。
颜色选择器。您的编辑器可能包含一个,或者您可以选择一个独立的应用程序。非常有助于创建和保存调色板。
打印皮肤
默认情况下,您的新皮肤将使用标准/酒吧/皮肤/印刷品/
皮肤。
要超越此限制,请将以下内容添加到本地/config.php
:
$ActionSkin['print']='yourprintskin';
这是说使用“你的打印皮肤”?action=打印
而不是默认值。
默认的打印皮肤覆盖指向其他现有wiki页面的链接,以便它们也在打印皮肤中打开。可以通过在local/config.php或其他组自定义脚本。
include_one(“$FarmD/scripts/prefs.php”);include_once(“$FarmD/scripts/skins.php”);$LinkPageExistsFmt=“<a class='wikilink'href='\$LinkUrl'title='\$1LinkAlt'>\$LinkText</a>”;
另请参见
常见问题
如何更改主页左上角的Wiki默认名称?
放置以下内容配置.php
$WikiTitle=“我的Wiki网站”;
这个docs/sample-config.php
文件中有一个更改标题的示例。
如何在网页中嵌入PmWiki页面?
通过PHP页面获取它们的源代码,或者将它们放在框架中。
如何更改编辑页面上提示块的字体或背景色?
将CSS样式添加到发布/css/local.css
:.quickref{背景:…;颜色:…}
。提示由现场。编辑快速参考页面,位于PmWiki或Site wikigroup中。编辑该页面,更改“bgcolor”或指定字体“color”以获得所需的对比度。