Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

(proposals should start with name Proposal)

StatusProposal under development

Accepted and in progress

Target Release

4.0

Original Authors

Allen Gilliland

Abstract

This is a proposal to have all themes to provide create an xml based descriptor file for weblog themes starting in Roller 4.0.

Why a theme descriptor? A theme descriptor simply provides a more structured way of describing information about a packaged theme so we don't have to rely on implied conventions or hacks such as the use of Weblog.vm to represent the main weblog template. A theme descriptor also provides the additional ability to support some features of themes which currently are not possible, such as defining a custom template page with a specific link value.

...

No Format
<!-- weblog theme, name is required -->
<weblogtheme name="Theme Name"><weblogtheme>
        <id>brushedmetal</id>
        <name>Brushed Metal</name>
        <author>Bryan Bell</author>

	<!-- theme preview image, required -->
	<preview-image path="theme-preview.jpg" />

	<!-- 1 or more templates, "weblog" is required -->
	<template action="weblog|custom">
		<name></name>
		<description></description>
		<link></link>
		<navbar>true/false</navbar>
		<hidden>true/false</hidden>
		<templateLanguage>velocity</templateLanguage>
                <contentType>text/html</contentType>
		<contentsFile>foo.vm</contentsFile>
	</template>

	<!-- 0 or more resources -->
	<resource path="my-image.jpg" />
	<resource path="styles/foo.css" />

</weblogtheme>

...