The source to the Incubator website lives at:
The top-level Incubator website is currently generated by
Apache Velocity Anakia
This is the same setup as used by the main www.apache.org site. You
may find the main apache.org site help page and site README of use. Note that there are some minor differences
between the main apache.org site and the incubator site (namely that
the build system differs and the incubator is based on xml documents
instead of markdown docs).
The source documents are kept in the "incubator" SVN repository at
"content". The status reports for each project are in
content/project/
The production documents are kept in the "infra" SVN repository
at https://svn.apache.org/repos/infra/websites/production/incubator.
That directory is then managed by svnpubsub on the server
to re-create the live website.
People with commit access to the "incubator" SVN can edit the source
documents in the "content" directory. That is any ASF Member and
any committer on a current podling in incubation. So you can all help to
keep your project's Status page up-to-date, and if you find problems with
the "guidelines" docs then can immediately fix them.
If unsure, then discuss changes on the general mailing list.
Note that the "policy" documents need special treatment.
Anyone else can send patches to those documents to the INCUBATOR issue tracker.
Checkout the Incubator SVN site
svn co http://svn.apache.org/repos/asf/incubator/public/trunk incubator
cd incubator
If you are a committer and intending to commit your changes,
please ensure you use https instead of http.
Edit the source documents
The source content is in Anakia xdoc format at the "content"
directory.
Add a new document
Add new documents in the content directories, then do 'svn add'.
If your new documents need to be navigable from the left-hand side menu, then
add a new entry to the content/stylesheets/project.xml file in the "projects" element (yes, sorry, it is a hangover from an old configuration).
If you are adding a new podling, then see the steps in the following section.
Edit your project status page
The sources for the status pages are in
content/projects/*.xml
Create Status Page
-
Copy from the template
content/projects/incubation-status-template.xml to
content/projects/${project}.xml then 'svn add'
-
The copied template contains customization instructions. Follow them.
-
Go through the template actions. Delete any which are not
relevant and mark as completed any actions which are already
done.
-
Add an entry with status "current" to the podlings summary file at
content/podlings.xml and ensure that the
list of mentors is up-to-date.
-
Add an entry to the right-hand menu at
content/stylesheets/project.xml in the "menu" element.
-
Do
'svn update' to be sure you are up-to-date.
-
Regenerate the documentation by running
'ant' or 'build' from the top-level.
See more detail about this process in the following section. Note that
there will be many output changes because a new entry has been added to
the right-hand menu which is replicated on every page. The results wil
be built to the site-publish directory by default- please look them over,
but do not add this directory nor its contents to svn!
-
svn commit all the changes with a good message
-
Wait a minute or two for the CMS to build your changes, then publish them
by visiting the Publish site
page.
See other notes
about this step.
This status page is to be kept up to date regularly. This is NOT the same as the 'status report' which is a
board report entry in the incubator wiki. You still need to follow your monthly/quarterly status reports
Please generate the website yourself and check in the changes.
If you have any problems, ask for help on the Incubator's
general list.
In the top-level "incubator" SVN directory, do 'ant'
to render the HTML files into the "site-publish" directory.
(If you don't have ant installed, you can run build.sh or build.bat
instead.) If the site built without errors, then do the usual
SVN stuff: 'svn status' 'svn add' 'svn diff' 'svn commit'.
To update the website, visit Publish site
and fill out the form. Don't forget to give the CMS build system time to build your changes!
Make sure that your subversion client is properly
configured.
See other notes for maintenance of
apache.org project websites.
If you are still having trouble committing, then perhaps the Subversion
authorization is not yet properly
configured
to enable your group's access.
Overview of the Incubator site