The source to the Incubator website lives at:
The top-level Incubator website is currently generated by Apache Jakarta Velocity Anakia. (Say that ten times fast!)
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
xdocs becomes site-author and docs becomes site-publish).
The source documents are kept in the "incubator" SVN repository at
"site-author". The status reports for each project are in
site-author/project/
The production documents are kept in the "incubator" SVN repository
at "site-publish". That directory is then checked-out on the server
to re-create the website.
People with commit access to the "incubator" SVN can edit the source
documents in the "site-author" directory. Anyone else can send
patches to those documents to the general mailing list.
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.
The source content is in Anakia xdoc format at "site-author"
directory.
Add new documents in the site-author directory, then do 'svn add'.
If your new documents need to be navigable from the menu add a new entry
to the site-author/stylesheets/project.xml file.
If you are
adding a new podling
add an entry to the site-author/projects/index.xml
The sources for the status reports are in
site-author/projects/*.xml
-
Copy from the template
site-author/projects/incubation-status-template.xml to
site-author/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 to the table at
site-author/projects/index.xml
-
Regenerate the documentation by running
ant
-
svn add the generated status report
site-publish/projects/${project}.xml
-
svn commit all the changes with a good message
-
Update the copy in the staging directory
/www/incubator.apache.org.
It may take a few hours before the live website is sync'd.
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, the "incubator/site-publish" SVN directory
is checked-out on the apache.org web server.
ssh people.apache.org
cd /www/incubator.apache.org
svn update
Make sure that your subversion client is properly
configured.
See other notes for maintenance of
apache.org project websites.
|
