MoinMoin有一个主题插件系统可以很容易的更改界面样式,而无须触及核心代码。您可以通过修改层叠样式表来自定义颜色,或者提过用Python写一个新的主题插件来创造新的用户界面。当您升级MoinMoin时,您的主题没有被触及 - 它仍然可以在新版本下工作,或者由于主题API的更改而需要作少量的变化。

一个主题"THEMENAME"由这些部分组成:

层叠样式表

'classic'主题是基于CSS系统。所以对于简单的更改(比如更改颜色或字体,moving around stuff),您可能只需要更改CSS(就像starshine主题只是变黑一样)。

图片

当您创建一个新的主题时,把classic中所有的图片拷贝到您的img目录并修改需要修改的。如果您修改了一个图片,不要忘记更新主题代码中的图标字典(icon dict) - 为了更快地渲染,图片的几何属性保存在那里。

Python 模块

The theme code is called by moinmoin with (more or less) abstract data in a dictionary usually called d. The code then uses items in that dictionary to generate HTML (also heavily relying on CSS). The new theme system in 1.3 avoid using the data dictionary when possible, and instead call different moin parts to get the needed data.

当您想创建一个新主题的时候,首先复制一个您喜欢的主题,然后尝试编辑样式表来获得您想要的。如果仅仅使用CSS不能制作出您想要的,override some functions in your theme code.

All themes are sub classes of MoinMoin.theme.ThemeBase which define the primitive user interface elements, 像Logo、用户名、标题、搜索表格,编辑栏动作菜单等。您应该重新使用这些部分,除非您需要去更改那些您无法直接利用的已有的部分而去修改它们的内容或者创建新的元素。主题API目前还不稳定,所以在将来可能会有所更改。

安装

要安装主题,将压缩包解压,把它复制到顶层目录(比如 leftsidebar2)到维基htdocs目录,比如“/usr/share/moin/mywiki/htdocs”。You should end up with the following subdirectories: css/, img/.

在您完成这个以后,复制“THEMENAME.py”文件(比如“leftsidebar2.py”)到您的维基的“data/plugin/theme”目录。

设置默认主题

一旦您创建了所有必须的主题元素并按照上面的方法保存,那么就可以通过改变“wikiconfig.py”中的“theme_default”来将它设置为默认主题(参照 ["帮助-系统设置"])。

创建您的主题

如果您创建了一个漂亮的主题(当然得符合HTML和CSS标准),按下面的方法打包并把它加入到MoinMoin:ThemeMarket. Please put it under GPL license, if possible.

# <THEMENAME>-<VERSION>.tar.gz (or .zip), containing:
<THEMENAME>/<THEMENAME>.py
<THEMENAME>/img/*.png
<THEMENAME>/css/*.css

如果您不想去创建一个主题

“page_header1”、“page_header2”、“page_footer1”和“page_footer2”现在可以be callables and will be called with the "request" object as a single argument (note that you should accept any keyword arguments in order to be compatible to future changes).

此页的英文版本:HelpOnThemes