Differences between revisions 3 and 4
Revision 3 as of 2012-09-29 04:02:30
Size: 5182
Editor: shathaway
Comment: maintenance tools description
Revision 4 as of 2012-09-29 04:07:47
Size: 5237
Editor: shathaway
Comment: Update committer's review note - Xalan-C
Deletions are marked like this. Additions are marked like this.
Line 91: Line 91:
to copy the files to a committer's webpage for review if there
are issues that need general attention and comment.
to copy the files to a committer's webpage for review,
especially
if there are issues that need general attention and
comment before official publishing to the world.

http://xalan.apache.org/resources/Xalan-Logo-tm.png This is the official Wiki of the Apache Xalan Project.


Xalan Website Maintenance

The Xalan PMC website is registered with the Apache Infrastructure (INFRA). The INFRA "svnpubsub" publishing capability uses a registered subversion directory for publishing websites. As of December 31, 2012 all Apache websites should be "svnpubsub" compliant. Some webpage construction tools have "svnpubsub" behind the scenes. Our Xalan website construction builds files that should be committed to the registered "svnpubsub" directory to actually update our web presence.

Our Xalan TLP and project websites "svnpubsub" repository is located at:

  • (svn)/xalan/site/docs/xalan/

The Xalan-C/C++ project website is published in the subversion repository located at:

  • (svn)/xalan/site/docs/xalan/xalan-c/

The Xalan-Java project website is published in the subversion repository located at:

  • (svn)/xalan/site/docs/xalan/xalan-j/

We use a slightly modified Apache Stylebook XML markup language to construct our website pages. We have vacated the use of the Java Stylebook program and now use a standard XSLT stylesheet that can be processed by standard XSLT transformation processor programs.

The XSLT transformation processor currently used to construct the webpages is the (Xalan/Xalan.exe) program that is distributed with the Xalan-C/C++ project.

The website documentation build scripts can be edited to use the command-line requirements of most XSLT transformation processors.

Xalan Top-Level Page

The sources for the Xalan PMC top-level website pages are located in the subversion repository located at:

  • (svn)/xalan/site/docs/xdocs/

The builds currently require a Windows installation of Xalan-C. Plans are in place to allow a Linux/UNIX installation of Xalan-C for website maintenance.

Xalan C/C++ Website

The sources for the Xalan-C/C++ project website pages are located in the subversion repository located at:

  • (svn)/xalan/c/trunk/xdocs/

The website can be built on Windows platforms by running the make-book.bat script found in:

  • (svn)/xalan/c/trunk/xdocs/sources/

The website can be built on UNIX platforms by running the make-book.sh script found in:

  • (svn)/xalan/c/trunk/xdocs/sources/

The apiDocs page can be built on UNIX platforms by running the make-apiDocs.sh script found in:

  • (svn)/xalan/c/trunk/xdocs/

The assembled webpages are put into a (build)/docs/ working area on your local machine. It can then be reviewed with your local browser to find, identify, and fix problems. I like to copy the files to a committer's webpage for review, especially if there are issues that need general attention and comment before official publishing to the world.

Apache XML Project Retired

Since the parent Apache XML Project has been retired, the old website has been moved to the "svnpubsub" directory at:

  • (svn)/xalan/site/docs/xalan/old/xalan-c/

The builds currently require a Windows installation of Xalan-C. Plans are in place to allow a Linux/UNIX installation of Xalan-C for website maintenance. When the next patch release of Xalan-Java is available, the build scripts will also accommodate the Java Xalan command-line program to build the web pages.

The old website pages have been edited in-place to redirect the significant links to useful places.

Xalan Java Website

The sources for the Xalan-Java project website pages are located in the subversion repository located at:

  • (svn)/xalan/java/trunk/xdocs/

The prototype Xalan-Java website is being integrated from sources located in the following subversion branch:

  • (svn)/xalan/c/branches/XalanDocs/xalan/java/trunk/xdocs/

Snapshots have been made into the Xalan-Java branches for version 2.7.1 allowing convenient access to old documentation and facilitate patch maintenance.

The current documentation in the Xalan-Java trunk is for version 2.7.D2 in preparation of the version 2.7.2 patch release.

Apache XML Project Retired

Since the parent Apache XML Project has been retired, the old website has been moved to the "svnpubsub" directory at:

  • (svn)/xalan/site/docs/xalan/old/xalan-j/

The old website pages have been edited in-place to redirect the significant links to useful places.

Website Reconfigure Project

The Xalan PMC website reconfiguration effort was done by Steven Hathaway in the subversion directory:

  • (svn)/xalan/c/branches/XalanDocs

Work performed in this development branch is being merged into the various documentation source directories.

Steven Hathaway has prototyped the PMC website for review. This website is located at:

WebsiteMaintance (last edited 2012-09-29 04:07:47 by shathaway)