Differences between revisions 2 and 3
Revision 2 as of 2012-09-29 03:51:30
Size: 4829
Editor: shathaway
Comment:
Revision 3 as of 2012-09-29 04:02:30
Size: 5182
Editor: shathaway
Comment: maintenance tools description
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## Template for creating Xalan Wiki SubPages ## The Xalan Website Maintenance Page
Line 3: Line 3:
## Name: XalanWikiPage_Template
##
## The easiest way to create a new page is to
## create a copy of the template to a new page,
## then edit the new page copy.
## Name: WebsiteMaintance
Line 50: Line 46:
webpages is the (Xalan/Xalan.exe) program that is distributed with webpages is the ({{{Xalan/Xalan.exe}}}) program that is distributed with
Line 65: Line 61:
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.
Line 74: Line 74:
make-book.bat script found in: {{{make-book.bat}}} script found in:
Line 79: Line 79:
make-book.sh script found in: {{{make-book.sh}}} script found in:
Line 84: Line 84:
the make-apiDocs.sh script found in: the {{{make-apiDocs.sh}}} script found in:
Line 100: Line 100:

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.

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 if there are issues that need general attention and comment.

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)