This page last changed on Feb 26, 2007 by david.soul@atlassian.com.
In order to deploy your custom Confluence theme, you will have to have Ant installed. To learn how to install and use Ant, please follow the instructions on the projects website.
To deploy the theme, execute the following command from within the theme directory in your Confluence installation:
ant build -Dtheme=<specifynameoftheme>
For example to build a theme with the name dinosaur, you will have to type:
ant build -Dtheme=dinosaur
You will find the build jar of the dinosaur theme in you Confluence install directory under .../themes/dinosaur/dist_ directory.
Installing the theme
To install the theme you can simply drop the previously created .jar file into the .../confluence/WEB-INF/lib directory in your Confluence installation as described under Installing and Configuring Plugins.
As a second option, you can also call the following ant command instead of the one found above to install the theme and copy the jar automatically in the appropriate directory.
ant install -Dtheme=<specifynameoftheme>
Read more about plugins
To change the time and date formats,
- Go to the 'Administration Console' and click on 'General Configuration' in the left panel.
- Click 'Edit' at the bottom of the 'Options and Settings' screen.
- There are three time and date format settings:
- Time Format : determines the time format for when each news item is posted
- Date Time Format : determines date and time format for historical versions of pages.
- Date Format : determines date and time format for all new and modified content.
- Change the formats using the guidelines in this document.
- 'Save' your changes.
 
I had the problem, that one theme I wanted to compile in Java 1.5 had class files, which have previously been compiled with 1.4. So the built did not recompile these files and I ran into errors.
ant clean \-Dtheme=<specifynameoftheme>
before building is definitly a good idea.

Posted by christian.hansen@oenb.at at Aug 31, 2006 08:10
|
I'm still trying to figure out how to do this, so maybe I've got it wrong, but it appears that ant needs a build.xml file. Given that you are requiring that users use ant, how about providing some help, like a sample of build.xml contents?

Posted by simonoff at Feb 22, 2007 13:07
|
I'm looking around our confluence installation, and there's no confluence/themes directory. (The instructions above say to run ant in there.)

Posted by simonoff at Feb 22, 2007 14:00
|
I believe I've got a simple build.xml file that works. Here it is:
<project name="Plain theme" basedir=".">
<description>
build a theme
</description>
<target name="build">
<jar jarfile="plaintheme.jar" basedir= "." />
</target>
</project>
Assuming I've got this right, you put this in the directory with your new theme files, and then run ant like this:
ant build -Dtheme=plain
FYI, it also seems that the directions to "put this in the theme directory in your Confluence installation" isn't right--at least, we don't have a confluence/theme directory. I did this is a development directory, set up like this:
theme directory > build.xml
atlassian-plugin.xml
decorators > (subdir with the decorators I want installed)
BTW, the instructions to drop this into the WEB-INF direcotry are, I think, old--you can use the plugin manager now.

Posted by simonoff at Feb 22, 2007 14:26
|
This will be under in Confluence install directory under .../themes, eg c:\confluence-2.3.3-std\themes rather than under .../confluence. Sorry for the confusion, I've updated the document for clarity. Please let us know if you are still stuck.
Cheers,
David Soul

Posted by david.soul@atlassian.com at Feb 26, 2007 19:10
|
|