Themes are simply alternate templates and style sheets that tell blojsom how to render a different presentation. Themes are useful for the HTML flavor where visitors to your blog will be using a web browser. Creating new themes is quick, easy and fun.
The following steps describe changing themes from the command-line. If you have downloaded and setup blojsom on your server, the Theme Switcher plugin should already be enabled. This allows you to switch themes from blojsom's web administration console.
Installing blojsom themes
There are a number of themes that ship with blojsom. They are located in a directory called themes off of the location where you installed blojsom.
To install a new template simply follow these steps. The following assumes that Velocity templates are used. These template files end in in a .vm extension.
- Copy all the Velocity template files from the /themes/(theme-name)/templates directory to your individual /WEB-INF/(blog-id)/templates directory.
- Copy any resources from the /themes/(theme-name)/resources directory to the /BLOJSOM_INSTALLATION_DIRECTORY/resources/(blog-id)/ directory.
All that is left to do is tell blojsom to use the new template.
Configuring the active theme from the command-line
All you need to do to enable your template is to edit an individual /WEB-INF/(blog-id)/flavor.properties file and edit the value for the html flavor.
As an example, for the Vempire theme the line should read:
That's it, your blog has a brand new look!
I would like to point out that symlink'n these does not work.
They show up in the admin interface, but cannot be located by the dispatcher, at least not by the JSPDispatcher in my experiments.