To support additional (especially legal/IPR/help) issues, this template requires additional wiki pages than those used in the default 2.2.28 template (on which the design of Configurable Template was based) . Other templates may require even different pages.

This confounded a problem we already had, i.e. that the default set of pages is probably great for JSPWiki developers, but terrible for future content authors. The latter would like to have a relatively clean Wiki when they start to own it. One of our measures was to rename as many pages as possible and prefixing them with "Wiki...". Intuitively recognized pages have been excluded, see ConfigurableTemplateDefaultPages. However, this measure conflicts with the hard-coded nature of page names in current JSPWiki 2.2.28 default template.

We tried to address this problem in a similar way to the configuration options of the template, by defining variables for Page names as part of the template.

Since a single template may be used by different content webs (in a multi-wiki setup), the page names are not a feature of customizing the configurable template, but a feature of the Wiki content as defined in the .properties file. However, if no page name is defined, a default value is provided.

Example for the newly created section in JSPWiki.properties:

############################################################################
#
#  Template Pages.
#
#  Some pages have a special function in some templates. If the Wiki content uses different
#    page names than those expected by the template, the differing names can be set here.
#    The ConfigurableTemplate is the first to use this feature.
#  Note that specialPage can not be used for this purpose, it creates names as part of a 
#    URL. This work with short url constructors, but not with "wiki.jsp&page=" syntax.
#
# EXAMPLE:
# jspwiki.templateSetting.PAGE_ABOUT = About

Because of the default values, the template will work even with unmodified JSPWiki.properties. However, some template default names differ from current default page names on jspwiki.org, so a change in the template settings file is necessary. The file containing the page name code is "i_InitPageNames.2.4.jsp".

Note that although Wiki webs in different languages are one reason why page names differ, the template is not yet designed to be truly language independent. Most message strings are not externalized but remain directly in the template.

-- Gregor Hagedorn, 2005-09-07


Return to Configurable Template

Add new attachment

Only authorized users are allowed to upload new attachments.
« This page (revision-4) was last changed on 08-Sep-2005 13:06 by GregorHagedorn