You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Rationale

There is a growing sense in the community that the Camel Web site needs some updating. The precipitating e-mail cited a few key areas to look at:

  1. a new logo
  2. refreshed look and feel for the site
  3. clearer navigation
  4. clearer organization of the documentation

In addition the idea of attempting to align the branding of Camel with ServiceMix, CXF, ActiveMQ, and Karaf was floated. The idea being that the projects are closely aligned and frequently used together.

A final consideration is that the Apache Infrastructure group is beginning the process of deprecating Confluence due to a lack of support for the static HTML export plug-in. They have outlined plans to have all projects host their Web sites from SVN. The infrastructure group is implementing a CMS system that is currently in use for the main Apache site. However, they are willing to support any tool chain that produces HTML for publication from SVN.

Recently the board produced a set of guidelines that all projects must implement early next year regarding branding and Web sites.

Proposed Solutions

The proposals cover two general areas:

  • site design
  • site generation

Site Design

Site Generation

The three current ideas for generating the site include:

  1. sticking with Confluence
  2. using the CMS under development by the Infrastructure team
  3. using Scalate

Sticking with Confluence is not a realistic long term solution given the Apache Foundation's expressed intent to deprecate Confluence for static sites.

The Infrastructure CMS is still an unknown entity and is intended to support a number of site generation plug-ins. Any solution we choose will need to work with the Infrastructure publishing system if not directly with the CMS.

Scalate is a powerful and flexible Web framework that allows for a number of mark-up languages, including Confluence mark-up, as well as number of dynamic Web capabilities. James Strachan has already started a port of the existing Camel site as a test bed for Scalate. The project is hosted at Github (https://github.com/jstrachan/camel-docs). To get and build the site do the following:

git clone https://github.com/jstrachan/camel-docs.git
cd camel-docs
mvn jetty:run

Issues

  • No labels