由于很忙,主要是在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来获取参数。
分享到:
相关推荐
在3DMAX中,卷曲修改器是实现复杂动态效果的重要工具,而Roller正是这样一款专为卷曲效果设计的插件。这款插件能够帮助用户轻松创建出卷曲形状的模型,不仅限于静态的造型,还能生成逼真的卷曲和展开的动画效果。 ...
标题中的"roller"很可能指的是Apache Roller,一个开源的博客服务器平台。这个平台允许用户创建、管理和发布多个博客,并且提供了丰富的API供开发者扩展其功能。接下来,我们将深入探讨与"roller"相关的技术知识点。...
《roller安装指南——深入探索源码与工具应用》 在IT行业中,经常需要处理各种开源项目,以便定制、学习或优化。"roller"是一个颇受欢迎的开源博客引擎,它为开发者提供了一个强大的平台来创建、管理和发布个人或...
6. **源码调试与开发**:对于开发者而言,可能会对博主如何使用IDE(如Eclipse或IntelliJ IDEA)进行源码调试,以及如何为Roller编写自定义插件或扩展感兴趣。这部分内容可以帮助开发者快速上手Roller的二次开发。 ...
1. **创建数据库**: 为 Roller 创建一个新的数据库。 2. **检查 JDBC 驱动**: 确认已正确配置 JDBC 驱动。 3. **特殊考虑**: - **MySQL**: 确保表空间足够大,并且字符集设置正确。 - **Oracle**: 需要额外配置...
Roller 是一个全功能的多用户博客平台,于2002年首发,采用Java语言开发,设计精巧,源代码是很好的学习资料。它支持weblogging应有的特性如:评论功能,所见即所得HTML编辑,TrackBack,提供页面模板,RSS ...
首先,Roller 5是一款开源的博客和内容管理系统,它提供了一整套完善的博客功能,包括文章撰写、评论管理、用户权限控制、主题定制等。而Tomcat作为Apache软件基金会的项目,是一个广泛使用的Java Servlet容器,支持...
### Apache Roller Weblogger 使用指南知识点概述 #### 一、概览 **Apache Roller** 是一个开源的Java博客系统,提供了一套完整的博客解决方案。本文档《roller-user-guide.pdf》为用户提供了一个全面的操作指南,...
Apache Roller是一个全功能,多用户和组博客服务器,适合大型和小型博客网站。它运行一个Java Web应用程序应该能够运行在任何Java EE服务器和关系数据库。目前,Apache Roller能很好的支持Tomcat和MySQL。 本人用...
在IT行业中,"roller"可能是指一个开源项目或者软件工具,但具体信息不足,我们只能根据常规的安装、用户和模板指南来理解这个主题。以下是对这些概念的详细解释: 一、roller install(roller安装指南) 在安装...
- **从 Roller 2.x 升级到 4.0**:为从旧版本升级到新版本的用户提供详细的指导。 - **备份**:强调了在升级前进行数据备份的重要性。 - **安装与启动**:指导用户如何安装和启动新的 Apache Roller 版本。 #### ...
- **插件系统**:Roller支持插件机制,允许开发者扩展其功能,如添加新的博客功能或集成第三方服务。 5. **安全与权限** - **身份验证与授权**:Roller内置了用户注册和登录功能,支持角色基
知识点:Apache Roller 4.0 Beginner's Guide 一、Apache Roller 4.0 简介 Apache Roller 是一个开源的博客平台,基于 Java 和 JavaServer Pages (JSP) 技术构建。它提供了一个全面的解决方案,用于创建、管理和...
本示例项目“Roller Madness.zip”提供了一个以过山车为主题的交互式体验,旨在帮助开发者学习和掌握Unity3D的基础知识和高级特性。 一、场景构建 “Roller Madness”项目中的主要场景可能包含一个精心设计的过山车...
apache-roller-srapaapache-roller-srcche-roller-srccapache-rolaapache-roller-srcpache-roller-srcler-srcapapache-roller-srcache-roller-srcapache-roller-src
Apache Roller是一款功能强大的开源博客系统,它由Apache软件基金会维护,是Java开发者学习和研究的绝佳实例。通过深入分析Roller的源代码,我们可以了解到Java Web应用开发的多个关键知识点,包括但不限于以下方面...