如何为roller增加新的主题?(重发,je编辑器太烂0!)

由于很忙,主要是在roller上做二次开发,一直没有时间总结一下心得。有很多内容想记录下来,但感觉太多,太乱,没有很好的组织,一直就放着。今天简单说一下吧,希望对别人有点帮助。

 

如果你用roller做个博客网站,那么原来的主题模板肯定是不够用的,而且给你的业务没有关系,用起来那是相当的别扭。那么,如何为roller增加新的主题呢?下面就step-by-step吧。

 

这里说的是增加roller的共享主题,其他的就不说了。

 

1  在拷贝已有的主题上修改。

不知道别人是怎么用roller的,我是放到ide里开发的,自己做了一些目录结构上的变更。在roller源代码rar包里apache-roller-src-4.0.1\apps\weblogger\web\themes目录下,拷贝一个子目录重命名(保证部署后war里面有这个命名后的目录)。比如我们拷贝sotto目录,重名为abc

 

abc目录先把文件名带有sotto的改为abc,文件内容也是。这样就可以增加一个共享主题啦。但跟原来的sotto是一样的,有什么意义呢?你需要做的工作还是很多。比如修改样式、换个图片等等,这些都是比较简单的工作。比较难一点的请看第二步。

 

2  增加一个新的展现页面

你的博客业务本来跟roller就不一样,如果一样就不需要继续看了。那么有什么不同呢?比如你的博客需要加一个关于博主介绍的页面,就是加个aboutme的连接。这个页面内容、展现方式和其他页面都不一样,这时你需要一个单独的网页模板来展现。

 

abc目录下拷贝permalink.vm重命名为aboutme.vm,其中permalink.vm是展现一篇日志的页面模板。你认为aboutme有什么内容和展现方式就自己修改aboutme.vm吧。

 

 

 

仅有模板是不够的,还要让roller理解你这个http://xxxx.com/zhangsan/aboutme/这个连接,它才能根据你的指示来展现aboutme.vm.。那么怎么做呢?

 

3、修改theme.xml文件

   拷贝permalink节点修改

<template action="aboutme">
        <name> aboutme </name>
        <description> aboutme </description>
	<link></link>
        <navbar>false</navbar>
        <hidden>true</hidden>
        <templateLanguage>velocity</templateLanguage>
        <contentType>text/html</contentType>
        <contentsFile> aboutme.vm</contentsFile>
    </template>

 

 

4  修改java文件

修改那些文件我会列出来,但为什么修改就不做解释了。自己去看源代码,或者看我之前写的博客,o(∩_∩)o…

 

A、修改ThemeTemplate接口,增加一个页面名字action常量。

 

public static final String ACTION_MEMBERS = "aboutme";

public static final String[] ACTIONS = {
        ACTION_WEBLOG, 
        ACTION_PERMALINK, 
        ACTION_SEARCH, 
        ACTION_TAGSINDEX,
        ACTION_ABOUTME
    };

 

 

 

B、修改WeblogPageRequest类,增加一个分支判断让其不要抛出异常

 

 

                } else if ("aboutme".equals(this.context)) {
                	/** 增加一个页面  */
                } else {
                    throw new InvalidRequestException("context "+this.context+
                            "not supported, "+request.getRequestURL());
                }

 

 

 

C修改PageServlet类,增加一个判断,使得通过页面名字获取模板

 

 

 

 

        } else if (pageRequest.getWeblogAnchor() != null) {
            try {
                page = weblog.getTheme().getTemplateByAction(ThemeTemplate.ACTION_PERMALINK);
            } catch (Exception e) {
                log.error("Error getting weblog page for action 'permalink'", e);
            }
        /** 增加一个页面  */
        else if ("aboutme".equals(pageRequest.getContext())) {
            try {
                page = weblog.getTheme().getTemplateByAction(ThemeTemplate.ACTION_ABOUTME);
            } catch (Exception e) {
                log.error("Error getting weblog page for action 'permalink'", e);
            }
        }

 

 

 D、修改WeblogPageCache类的generateKey方法,目的是使得roller能为新的页面模板生成唯一的key,以便缓存后能定位到。

 

/** 增加一个页面  */
            if("aboutme".equals(pageRequest.getContext())) {
            	key.append("/aboutme/");
            }

 

 

通过这个过程就可以创建一个共享主题模板了。

另外由于WeblogPageRequest的构造函数代码的原因,连接最好是http://xxxx.com/zhangsan/aboutme/xx否则将抛出异常,因为roller要通过url来获取参数。

 

你可能感兴趣的:(浏览器,搜索引擎,velocity,百度,Google)