RE: minimal forrest.properties (Was: r428188: main/fresh-site/main/template-sites/basic/ ...)

["Gav...." <br...@brightontown.com.au>]

> -----Original Message-----
> From: Thorsten Scherler [mailto:thorsten@apache.org]
> Sent: Thursday, 3 August 2006 2:58 PM
> To: dev@forrest.apache.org
> Subject: Re: minimal forrest.properties (Was: r428188: main/fresh-
> site/main/template-sites/basic/ ...)
> 
> El jue, 03-08-2006 a las 10:00 +1000, David Crossley escribió:
> > thorsten@apache.org wrote:
> > > Author: thorsten
> > > Date: Wed Aug  2 16:29:56 2006
> > > New Revision: 428188
> > >
> > > URL: http://svn.apache.org/viewvc?rev=428188&view=rev
> > > Log:
> > > FOR-799 - remove all references from the core to the dispatcher
> > > I removed all properties related to the dispatcher (or former
> versions) from the core.
> > > This includes cleaning
> > >  - basic (further switched to a minimal config) and fresh-site seed
> forrest.properties
> >
> > I previously tried to trim down the templates/basic/forrest.properties
> > and was asked to revert it:
> 
> http://marc.theaimsgroup.com/?l=forrest-dev&w=2&r=1&s=r366100&q=b
> I am still the same opinion as back then.
> 
> Further I created the basic seed to not have to senseless remove code
> that I do not need. The basic seed is a slim down and clean startup for
> projects from scratch.
> 
> Regarding Ross comment in
> http://marc.theaimsgroup.com/?l=forrest-dev&m=113647830724990&w=2
> "...These are used by users as a
> starting point and therefore extra documentation in there will reduce
> the number of questions we get on the mailing lists..."
> 
> The basic seed is for advanced user of forrest, that already played a
> round with the samples and want to start from scratch. I do not think
> that someone will ask regarding the basic seed.

I agree with the usage of this, however the title 'basic' does not in my
mind tie in with 'advanced'. To me , 'basic' would be the place I would head
for if I knew nothing. 'minimal' describes it well and newbies may well get
the message and steer clear from.

Gav...

> 
> salu2
> 
> >
> > ------------------------------------------------------------------------
> > r366423 | crossley | 2006-01-06 15:30:07 +1100 (Fri, 06 Jan 2006) | 3
> lines
> >
> > Add duplicate full forrest.properties to "basic" and "business" seeds.
> > Please keep these synchronised with the master copy in main/fresh-site
> >
> > ------------------------------------------------------------------------
> > r366100 | crossley | 2006-01-05 18:01:23 +1100 (Thu, 05 Jan 2006) | 2
> lines
> >
> > Use minimal forrest.properties files.
> > ------------------------------------------------------------------------
> >
> > -David
> >
> > >  - default-forrest.properties
> > >  - forrest-core.xconf
> > > Further adding of forrest.properties.xml to basic and fresh-site seed.
> > >
> > > Switching to the new properties system in all code of the dispatcher
> plugin where former core references have been.
> > >
> > >
> > > Added:
> > >     forrest/trunk/main/fresh-site/forrest.properties.xml   (with
> props)
> > >     forrest/trunk/main/template-sites/basic/forrest.properties.xml
> (with props)
> > >
> forrest/trunk/whiteboard/plugins/org.apache.forrest.plugin.internal.dispat
> cher/default.plugin.properties.xml   (with props)
> > > Modified:
> > >     forrest/trunk/main/template-sites/basic/forrest.properties
> > >     forrest/trunk/main/webapp/WEB-INF/xconf/forrest-core.xconf
> > >     forrest/trunk/main/webapp/default-forrest.properties
> > >
> forrest/trunk/whiteboard/plugins/org.apache.forrest.plugin.internal.dispat
> cher/forrest.properties
> > >
> forrest/trunk/whiteboard/plugins/org.apache.forrest.plugin.internal.dispat
> cher/locationmap.xml
> > >
> forrest/trunk/whiteboard/plugins/org.apache.forrest.plugin.internal.dispat
> cher/resources.xmap
> >
> > [ snip ]
> >
> > > Modified: forrest/trunk/main/template-sites/basic/forrest.properties
> > > URL: http://svn.apache.org/viewvc/forrest/trunk/main/template-
> sites/basic/forrest.properties?rev=428188&r1=428187&r2=428188&view=diff
> > >
> ==========================================================================
> ====
> > > --- forrest/trunk/main/template-sites/basic/forrest.properties
> (original)
> > > +++ forrest/trunk/main/template-sites/basic/forrest.properties Wed Aug
> 2 16:29:56 2006
> > > @@ -14,144 +14,12 @@
> > >  # limitations under the License.
> > >
> > >  ##############
> > > -# These are the defaults, un-comment them only if you need to change
> them.
> > > -#
> > > -# You can even have a completely empty file, to assist with
> maintenance.
> > > -# The file obtained from 'forrest seed-sample' shows the defaults.
> > > +# This is a minimal properties file.
> > > +# These are defaults, un-comment them only if you need to change
> them.
> > > +# See the full set of default properties in a 'forrest seed-sample'
> site.
> > > +# Copy properties from there as needed.
> > >  ##############
> > > -
> > > -# Prints out a summary of Forrest settings for this project
> > > -#forrest.echo=true
> > > -
> > > -# Project name (used to name .war file)
> > > -#project.name=my-project
> > > -
> > > -# Specifies name of Forrest skin to use
> > > -# See list at http://forrest.apache.org/docs/skins.html
> > > -#project.skin=pelt
> > > -
> > > -# codename: Dispatcher
> > > -# Dispatcher is using a fallback mechanism for theming.
> > > -# You can configure the theme name and its extension here
> > > -#project.theme-extension=.fv
> > > -#project.theme=pelt
> > > -
> > > -
> > > -# Descriptors for plugins and skins
> > > -# comma separated list, file:// is supported
> > > -
> #forrest.skins.descriptors=http://forrest.apache.org/skins/skins.xml,file:
> ///c:/myskins/skins.xml
> > > -
> #forrest.plugins.descriptors=http://forrest.apache.org/plugins/plugins.xml
> ,http://forrest.apache.org/plugins/whiteboard-plugins.xml
> > > -
> > > -##############
> > > -# behavioural properties
> > > -#project.menu-scheme=tab_attributes
> > > -#project.menu-scheme=directories
> > > -
> > > -##############
> > > -# layout properties
> > > -
> > > -# Properties that can be set to override the default locations
> > > -#
> > > -# Parent properties must be set. This usually means uncommenting
> > > -# project.content-dir if any other property using it is uncommented
> > > -
> > > -#project.status=status.xml
> > > -#project.content-dir=src/documentation
> > > -#project.raw-content-dir=${project.content-dir}/content
> > > -#project.conf-dir=${project.content-dir}/conf
> > > -#project.sitemap-dir=${project.content-dir}
> > > -#project.xdocs-dir=${project.content-dir}/content/xdocs
> > > -#project.resources-dir=${project.content-dir}/resources
> > > -#project.stylesheets-dir=${project.resources-dir}/stylesheets
> > > -#project.images-dir=${project.resources-dir}/images
> > > -#project.schema-dir=${project.resources-dir}/schema
> > > -#project.skins-dir=${project.content-dir}/skins
> > > -#project.skinconf=${project.content-dir}/skinconf.xml
> > > -#project.lib-dir=${project.content-dir}/lib
> > > -#project.classes-dir=${project.content-dir}/classes
> > > -#project.translations-dir=${project.content-dir}/translations
> > > -
> > > -#project.build-dir=${project.home}/build
> > > -#project.site=site
> > > -#project.site-dir=${project.build-dir}/${project.site}
> > > -#project.temp-dir=${project.build-dir}/tmp
> > > -
> > > -##############
> > > -# Cocoon catalog entity resolver properties
> > > -# A local OASIS catalog file to supplement the default Forrest
> catalog
> > > -#project.catalog=${project.schema-dir}/catalog.xcat
> > > -
> > > -##############
> > > -# validation properties
> > > -
> > > -# This set of properties determine if validation is performed
> > > -# Values are inherited unless overridden.
> > > -# e.g. if forrest.validate=false then all others are false unless set
> to true.
> > > -#forrest.validate=true
> > > -#forrest.validate.xdocs=${forrest.validate}
> > > -#forrest.validate.skinconf=${forrest.validate}
> > > -#forrest.validate.sitemap=${forrest.validate}
> > > -#forrest.validate.stylesheets=${forrest.validate}
> > > -#forrest.validate.skins=${forrest.validate}
> > > -#forrest.validate.skins.stylesheets=${forrest.validate.skins}
> > > -
> > > -# *.failonerror=(true|false) - stop when an XML file is invalid
> > > -#forrest.validate.failonerror=true
> > > -
> > > -# *.excludes=(pattern) - comma-separated list of path patterns to not
> validate
> > > -# Note: If you do add an "excludes" list then you need to specify
> site.xml too.
> > > -# e.g.
> > > -#forrest.validate.xdocs.excludes=site.xml, samples/subdir/**,
> samples/faq.xml
> > > -#forrest.validate.xdocs.excludes=site.xml
> > > -
> > > -
> > > -##############
> > > -# General Forrest properties
> > > -
> > > -# The URL to start crawling from
> > > -#project.start-uri=linkmap.html
> > > -
> > > -# Set logging level for messages printed to the console
> > > -# (DEBUG, INFO, WARN, ERROR, FATAL_ERROR)
> > > -#project.debuglevel=ERROR
> > > -
> > > -# Max memory to allocate to Java
> > > -#forrest.maxmemory=64m
> > > -
> > > -# Any other arguments to pass to the JVM. For example, to run on an
> X-less
> > > -# server, set to -Djava.awt.headless=true
> > > -#forrest.jvmargs=
> > > -
> > > -# The bugtracking URL - the issue number will be appended
> > > -# Projects would use their own issue tracker, of course.
> > > -#project.bugtracking-
> url=http://issues.apache.org/bugzilla/show_bug.cgi?id=
> > > -#project.bugtracking-url=http://issues.apache.org/jira/browse/
> > > -
> > > -# The issues list as rss
> > > -#project.issues-rss-url=
> > > -
> > > -#I18n Property. Based on the locale request for the browser.
> > > -#If you want to use it for static site then modify the JVM
> system.language
> > > -# and run once per language
> > > -#project.i18n=false
> > > -
> > > -# The names of plugins that are required to build the project
> > > -# comma separated list (no spaces)
> > > -# You can request a specific version by appending "-VERSION" to the
> end of
> > > -# the plugin name. If you exclude a version number, the latest
> released version
> > > -# will be used. However, be aware that this may be a development
> version. In
> > > -# a production environment it is recommended that you specify a known
> working
> > > -# version.
> > > -# Run "forrest available-plugins" for a list of plug-ins currently
> available.
> > >  project.required.plugins=org.apache.forrest.plugin.output.pdf
> > > -
> > >  # codename: Dispatcher
> > >  # Add the following plugins to project.required.plugins:
> > >
> #org.apache.forrest.plugin.internal.dispatcher,org.apache.forrest.themes.c
> ore
> > > -
> > > -# Proxy configuration
> > > -# - proxy.user and proxy.password are only needed if the proxy is an
> authenticated one...
> > > -# proxy.host=myproxy.myhost.com
> > > -# proxy.port=<ProxyPort, if not the default : 80>
> > > -# proxy.user=<login, if authenticated proxy>
> > > -# proxy.password=<password, if authenticated proxy>
> >
> > [ snip ]
> --
> thorsten
> 
> "Together we stand, divided we fall!"
> Hey you (Pink Floyd)
> 
> 
> 
> 
> --
> No virus found in this incoming message.
> Checked by AVG Free Edition.
> Version: 7.1.394 / Virus Database: 268.10.5/406 - Release Date: 8/2/2006