This document describes our site setup: what is where and how does it work.

Overview

Our website and documentation are kept in Confluence. Since the confluence instance at https://cwiki.apache.org/confluence/ isn't capable of handling a lot of incoming requests, all spaces are statically exported. The Autoexport plugin for Confluence is responsible for that. Once a page in Confluence changes, that page gets re-exported automatically. The Autoexport plugin is configured to export the pages to a directory on thor (the machine Confluence is running on). From there a cron job copies the exports to /www/confluence-exports on people.apache.org. On people.apache.org another cronjob copies the exported Tapestry space to ~uli/public_html/tapestry-site/ which is available as http://people.apache.org/~uli/tapestry-site/. Later, the same cronjob will copy our space to a directory that gets synched with the main webservers and makes the space available as http://tapestry.apache.org.

Website structure

The Index page includes the Banner and Key Features pages as well as the blog posts. All other pages are just plain pages and may or may not include other parts. In addition the Navigation, Small Banner and Footer pages exist. Our Autoexport template glues everything together. It adds the contents of the Navigation and Footer pages in the appropriate places and on all pages except the Index page it also adds the contents of the Small Banner page as well as the breadcrumbs navigation.

Because we include some pages in others it is sometimes necessary to reexport the whole space because the Autoexport plugin will only export the changed page, not the pages where the changed page is included. To do so you have to be a confluence administrator. You can then manually export our space via the Autoexport administrative console.