You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xalan.apache.org by sh...@apache.org on 2012/09/28 23:26:07 UTC
svn commit: r1391665 [1/4] - in /xalan/c/branches/GSoC-2012/xdocs: ./
sources/ sources/xalan/ style/dtd/ style/stylesheets/
Author: shathaway
Date: Fri Sep 28 21:26:05 2012
New Revision: 1391665
URL: http://svn.apache.org/viewvc?rev=1391665&view=rev
Log:
Update GSoC-2012 documentation sources
Added:
xalan/c/branches/GSoC-2012/xdocs/README.txt
xalan/c/branches/GSoC-2012/xdocs/Stylebook-Changes.txt
xalan/c/branches/GSoC-2012/xdocs/make-apiDocs.sh (with props)
xalan/c/branches/GSoC-2012/xdocs/sources/make-book.bat (with props)
xalan/c/branches/GSoC-2012/xdocs/sources/make-book.sh (with props)
xalan/c/branches/GSoC-2012/xdocs/sources/make-xalan.bat (with props)
xalan/c/branches/GSoC-2012/xdocs/sources/make-xalan.sh (with props)
xalan/c/branches/GSoC-2012/xdocs/sources/stylebook.xslt
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/builddocs.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/buildlibs.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/license.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/releasenotes.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/secureweb.xml
xalan/c/branches/GSoC-2012/xdocs/style/dtd/
xalan/c/branches/GSoC-2012/xdocs/style/dtd/blocks.ent
xalan/c/branches/GSoC-2012/xdocs/style/dtd/book.dtd
xalan/c/branches/GSoC-2012/xdocs/style/dtd/changes.dtd
xalan/c/branches/GSoC-2012/xdocs/style/dtd/characters.ent
xalan/c/branches/GSoC-2012/xdocs/style/dtd/document.dtd
xalan/c/branches/GSoC-2012/xdocs/style/dtd/faqs.dtd
xalan/c/branches/GSoC-2012/xdocs/style/dtd/links.ent
xalan/c/branches/GSoC-2012/xdocs/style/dtd/markup.ent
Removed:
xalan/c/branches/GSoC-2012/xdocs/style/stylesheets/
Modified:
xalan/c/branches/GSoC-2012/xdocs/sources/entities.ent
xalan/c/branches/GSoC-2012/xdocs/sources/xalan.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/build_instruct.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/download.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/faq.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/getstarted.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/history.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/index.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/install.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/overview.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/programming.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/readme.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/resources.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/samples.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/usagepatterns.xml
xalan/c/branches/GSoC-2012/xdocs/sources/xalan/whatsnew.xml
Added: xalan/c/branches/GSoC-2012/xdocs/README.txt
URL: http://svn.apache.org/viewvc/xalan/c/branches/GSoC-2012/xdocs/README.txt?rev=1391665&view=auto
==============================================================================
--- xalan/c/branches/GSoC-2012/xdocs/README.txt (added)
+++ xalan/c/branches/GSoC-2012/xdocs/README.txt Fri Sep 28 21:26:05 2012
@@ -0,0 +1,146 @@
+
+ XALAN-C++ USER GUIDE DEVELOPER NOTES
+Edited: 2012-09-16
+
+UNIX platforms can make both the xalan-c API document and the xalan-c website.
+
+WINDOWS platforms can only make the xalan-c website without the xalan-C apiDocs.
+
+Java and the Apache StyleBook program are no longer reuired.
+The XML transformations are now done using a standard XSLT
+command-line stylesheet transformation utility. The Apache Xalan
+program or Xalan.exe program is used for this transformation.
+The resulting web pages have static content without any javascript
+or other scripting requirements.
+
+The resulting web pages scale well with a wide variety of web browsers.
+The browsers should support xhtml version 1.0. Even thou the pages
+are rendered as strict, the productions accommodate most browsers that
+only render the loose or transitional implementation.
+
+Download the source package from repository or subversion
+
+ http://www.apache.org/dyn/closer/xalan/xalan-c
+ http://svn.apache.org/repos/asf/xalan/c/trunk
+
+The documentation products will be built to the target directories
+
+ c/trunk/build/docs/apiDocs
+ c/trunk/build/docs/xalan-c
+
+UNIX Build xalan-c apiDocs
+
+ Prerequisite: The Doxygen package must be installed (doxygen) program.
+ Prerequisite: The GraphViz package must be installed (dot) program.
+
+ cd {c/trunk/xdocs}
+ Edit the "make-apiDocs.sh" script
+
+ Run the "make-apiDocs.sh" script
+
+UNIX Build xalan-c website pages
+
+ Prerequisite: The "Xalan" command-line executable must be available
+
+ cd {c/trunk/xdocs/sources}
+ Run the "make-book.sh" script
+
+WINDOWS Build the xalan-c website pages
+
+ Prerequisite: The "xalan.exe" command-line executable must be available
+
+ cd {c/trunk/xdocs/sources}
+ Run the "make-book.bat" script
+
+-------------------------------------------------------------------
+The "sbk:" prefix is non-standard and was recognized by the deprecated
+Apache Stylebook Java program. The "sbk:" prefix has now been replaced
+with relative URLs for use with a standard XSLT stylesheet processor.
+
+MANIFEST
+
+ {xalan/c/trunk}
+
+ bin/
+ Placeholder for Xalan.exe and DLL files for Windows Binary executables.
+
+ build/
+ Placeholder where products are constructed.
+
+ build/docs/appDocs/
+ Placeholder for construction of xalan-c apiDocs.
+
+ build/docs/xalan-c/
+ Placeholder for construction of xalan-c webpages.
+
+ src/
+ Source tree of C/C++ sources for making the xalan library and
+ Xalan command-line processor. The *.hpp source files contain
+ the structured components from which the apiDocs document is
+ constructed.
+
+ xdocs/
+ Directory tree of documentation sources and build scripts.
+
+ xdocs/DoxyfileXalan The configuration file for doxygen program.
+
+* xdocs/make-apiDocs.sh The Bourne shell script to build apiDocs.
+
+ xdocs/html/apiDocs/
+ Directory of doxygen include files and Apache feather logo
+ for apiDocs pages.
+
+ xdocs/style/dtd/ The Stylebook validation DTD files.
+
+ xdocs/sources/
+ Directory tree of sources and scripts to build the xalan-c
+ webpages or User Guide.
+
+ xdocs/sources/entities.ent
+ Some included DTD entity definitions.
+
+ xdocs/sources/xalan-xml
+ The Stylebook XML page navigation source.
+
+ xdocs/sources/stylebook.xslt
+ The standardized Xalan stylebook transformation stylesheet.
+
+ xdocs/sources/xalan/
+ Directory of Stylebook XML page sources for xalan-c User Guide.
+
+ xdocs/sources/xalan-graphic/
+ Special graphics required by some xdocs/sources/xalan/ sources.
+ These files are copied to build/docs/xalan-c/
+
+ xdocs/sources/xslt-resources/
+ The Xalan LOGOs and css stylesheets for rendering web pages.
+ These files are copied to build/docs/xalan-c/resources/
+
+* xdocs/sources/make-book.sh
+ The UNIX Bourne shell script to build the xalan-c web pages.
+
+* xdocs/sources/make-book.bat
+ The Windows command script to build the xalan-c web pages.
+
+-------------------------------------------------------------------
+The Xalan-C website is published to "svnpubsub" by copying
+
+ build/docs/xalan-c/*
+
+to the "svnpubsub" repository tree
+
+ {svn}/xalan/site/docs/xalan/xalan-c/
+
+then perform a repository subversion check-in.
+-------------------------------------------------------------------
+
+These notes are provided by Steven J. Hathaway for the
+Xalan Documentation Project.
+
+Current information is available on the Xalan website
+http://xalan.apache.org/xalan-c
+
+
+
+
+
Added: xalan/c/branches/GSoC-2012/xdocs/Stylebook-Changes.txt
URL: http://svn.apache.org/viewvc/xalan/c/branches/GSoC-2012/xdocs/Stylebook-Changes.txt?rev=1391665&view=auto
==============================================================================
--- xalan/c/branches/GSoC-2012/xdocs/Stylebook-Changes.txt (added)
+++ xalan/c/branches/GSoC-2012/xdocs/Stylebook-Changes.txt Fri Sep 28 21:26:05 2012
@@ -0,0 +1,29 @@
+
+RECOMMENDED StyleBook Changes::
+
+The stylesheets for Xalan-C/++ do not support the Stylebook <group>.
+Especially since the child element <entry> does not support a label.
+
+I was going to display the <group> label with enhanced font, and treat
+the <entry> similar to a <document> <faq>, ... etc. The <entry>
+element in Stylebook currently does not support a "label" attribute.
+
+Change to the StyleBook DTD is required.
+
+The <group> element should support the following children of <book>
+
+ document
+ hidden
+ faqs
+ changes
+ external
+
+The <group> element should not support the following children.
+
+ group
+ separator
+ entry
+
+This change of <group> is a significant departure from the Apache
+StyleBook Java Engine.
+
Added: xalan/c/branches/GSoC-2012/xdocs/make-apiDocs.sh
URL: http://svn.apache.org/viewvc/xalan/c/branches/GSoC-2012/xdocs/make-apiDocs.sh?rev=1391665&view=auto
==============================================================================
--- xalan/c/branches/GSoC-2012/xdocs/make-apiDocs.sh (added)
+++ xalan/c/branches/GSoC-2012/xdocs/make-apiDocs.sh Fri Sep 28 21:26:05 2012
@@ -0,0 +1,74 @@
+#!/bin/sh
+#
+# Script file to create Xalan-C apiDocs
+#
+# This script requires current versions of "Doxygen" and
+# "GraphViz (dot)" programs to be installed on your UNIX.
+#
+
+# Various OS's have different ways of specifying the library path
+#
+# Solaris and Linux
+ LD_LIBRARY_PATH=/usr/local/lib
+#
+# HP-UX
+# SHLIB_PATH=/usr/local/lib
+#
+# AIX and BSD
+# LIBPATH=/usr/local/lib
+#
+# Mac OS X
+# DYLD_LIBRARY_PATH=/usr/local/lib
+#
+# Cygwin and MinGW
+# PATH=
+#
+
+# Add the current directory to the PATH for nested scripts
+
+PATH=$PATH:.
+
+# Add the PATH for the Xalan program
+
+export PATH=/usr/local/bin:$PATH
+
+# Make the necessary target paths
+
+if [ ! -d ../build/docs/apiDocs ] ; then
+ mkdir -p ../build/docs/apiDocs
+fi
+if [ ! -d ../build/docs/xalan-c ] ; then
+ mkdir -p ../build/docs/xalan-c
+fi
+
+# Create the xalan-c apiDocs using (doxygen) and (dot).
+
+doxygen DoxyfileXalan
+
+# We may not want the many *.md5 files
+
+rm ../build/docs/apiDocs/html/*.md5
+
+# Copy the Apache Trademark Graphic
+
+cp html/apiDocs/asf_logo_wide.gif ../build/docs/apiDocs/html
+
+# Move the apiDocs to the xalan-c website tree
+
+if [ -e ../build/docs/xalan-c/apiDocs ] ; then
+ rm -rf ../build/docs/xalan-c/apiDocs
+fi
+mv ../build/docs/apiDocs/html ../build/docs/xalan-c/apiDocs
+
+#
+# Done with xalan-c apiDocs build
+#
+
+#
+# Chain to sources to create xalan-c website pages
+#
+
+cd sources
+make-book.sh
+cd ..
+
Propchange: xalan/c/branches/GSoC-2012/xdocs/make-apiDocs.sh
------------------------------------------------------------------------------
svn:executable = *
Modified: xalan/c/branches/GSoC-2012/xdocs/sources/entities.ent
URL: http://svn.apache.org/viewvc/xalan/c/branches/GSoC-2012/xdocs/sources/entities.ent?rev=1391665&r1=1391664&r2=1391665&view=diff
==============================================================================
--- xalan/c/branches/GSoC-2012/xdocs/sources/entities.ent (original)
+++ xalan/c/branches/GSoC-2012/xdocs/sources/entities.ent Fri Sep 28 21:26:05 2012
@@ -1,6 +1,6 @@
<?xml encoding="US-ASCII"?>
<!--
- * Copyright 1999-2004 The Apache Software Foundation.
+ * Copyright 1999-2011 The Apache Software Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
@@ -16,17 +16,17 @@
-->
<!ENTITY xslt4c "Xalan-C++">
-<!ENTITY xslt4c-dist "Xalan-C_1_10_0">
-<!ENTITY xslt4c-current "Xalan-C++ version 1.10">
-<!ENTITY xslt4c-windll "Xalan-C_1_10.dll">
-<!ENTITY xslt4c-linuxlib "libxalan-c.so.110">
-<!ENTITY xslt4c-aixlib "libxalan-c110.so">
-<!ENTITY xslt4c-hplib "libxalan-c.sl.110.0">
-<!ENTITY xslt4c-solarislib "libxalan-c1_10.so">
-<!ENTITY xslt4c-msgdll "XalanMessages_1_10.dll">
-<!ENTITY xslt4c-msglib "XalanMessages_1_10.lib">
-<!ENTITY xslt4c-msgsho "libxalanMsg110.so">
-<!ENTITY xslt4c-msgcat "xalanMsg1_10.cat">
+<!ENTITY xslt4c-dist "Xalan-C_1_11_0">
+<!ENTITY xslt4c-current "Xalan-C++ Version 1.11">
+<!ENTITY xslt4c-windll "Xalan-C_1_11.dll">
+<!ENTITY xslt4c-linuxlib "libxalan-c.so.111">
+<!ENTITY xslt4c-aixlib "libxalan-c111.so">
+<!ENTITY xslt4c-hplib "libxalan-c.sl.111.0">
+<!ENTITY xslt4c-solarislib "libxalan-c1_11.so">
+<!ENTITY xslt4c-msgdll "XalanMessages_1_11.dll">
+<!ENTITY xslt4c-msglib "XalanMessages_1_11.lib">
+<!ENTITY xslt4c-msgsho "libxalanMsg111.so">
+<!ENTITY xslt4c-msgcat "xalanMsg1_11.cat">
<!ENTITY xslt4c-win_root "xml-xalan\c">
<!ENTITY xslt4c-unix_root "xml-xalan/c">
@@ -84,14 +84,14 @@
<!ENTITY xslt4c-docs_dist_targz "&xslt4c-dist;-docs&unix_ext;">
<!ENTITY xml4c "Xerces-C++">
-<!ENTITY xml4c-used "Xerces-C++ version 2.7.0">
-<!ENTITY xml4c-dist "xerces-c2_7_0">
-<!ENTITY xml4c-windll "xerces-c_2_7_0.dll">
-<!ENTITY xml4c-winlib "xerces-c_2.lib">
-<!ENTITY xml4c-linuxlib "libxerces-c.so.27.0">
-<!ENTITY xml4c-aixlib "libxerces-c27.0.a">
-<!ENTITY xml4c-hplib "libxerces-c.sl.27.0">
-<!ENTITY xml4c-solarislib "libxerces-c.so.27.0">
+<!ENTITY xml4c-used "Xerces-C++ version 3.1.1">
+<!ENTITY xml4c-dist "xerces-c-3.1.1">
+<!ENTITY xml4c-windll "xerces-c_3_1.dll">
+<!ENTITY xml4c-winlib "xerces-c_3.lib">
+<!ENTITY xml4c-linuxlib "libxerces-c.so.31">
+<!ENTITY xml4c-aixlib "libxerces-c31">
+<!ENTITY xml4c-hplib "libxerces-c.sl.31">
+<!ENTITY xml4c-solarislib "libxerces-c.so.31">
<!ENTITY xml4c-aix43v5-dist "&xml4c-dist;&aix43v5-dist;&unix_ext;">
<!ENTITY xml4c-aix51v5-dist "&xml4c-dist;&aix51v5-dist;&unix_ext;">
@@ -118,6 +118,8 @@
<!ENTITY icu-current "International Components for Unicode(ICU) version 3.2">
<!ENTITY icu-windlls "icui32n.dll, icuuc.dll">
<!ENTITY icubridge-win "ICUBridge.dll">
-<!ENTITY done SYSTEM "xalan/DONE">
+
+<!ENTITY license SYSTEM "xalan/License">
<!ENTITY status SYSTEM "xalan/STATUS">
<!ENTITY bugs SYSTEM "xalan/BUGS">
+
Added: xalan/c/branches/GSoC-2012/xdocs/sources/make-book.bat
URL: http://svn.apache.org/viewvc/xalan/c/branches/GSoC-2012/xdocs/sources/make-book.bat?rev=1391665&view=auto
==============================================================================
--- xalan/c/branches/GSoC-2012/xdocs/sources/make-book.bat (added)
+++ xalan/c/branches/GSoC-2012/xdocs/sources/make-book.bat Fri Sep 28 21:26:05 2012
@@ -0,0 +1,36 @@
+:: Volume in drive I is LEDS-USB
+:: Volume Serial Number is 27B6-025E
+::
+
+
+mkdir ..\..\build\docs\xalan-c\resources
+
+call make-xalan usagepatterns
+call make-xalan samples
+call make-xalan resources
+:: call make-xalan build_instruct
+call make-xalan install
+call make-xalan download
+call make-xalan overview
+call make-xalan charter
+:: call make-xalan history
+call make-xalan whatsnew
+call make-xalan extensionslib
+call make-xalan commandline
+call make-xalan readme
+call make-xalan releasenotes
+call make-xalan programming
+call make-xalan getstarted
+call make-xalan index
+call make-xalan extensions
+call make-xalan faq
+:: call make-xalan test-faqs
+call make-xalan license
+
+call make-xalan buildlibs
+call make-xalan secureweb
+call make-xalan builddocs
+
+copy xalan-graphic\*.* ..\..\build\docs\xalan-c
+copy xslt-resources\*.* ..\..\build\docs\xalan-c\resources
+
Propchange: xalan/c/branches/GSoC-2012/xdocs/sources/make-book.bat
------------------------------------------------------------------------------
svn:executable = *
Added: xalan/c/branches/GSoC-2012/xdocs/sources/make-book.sh
URL: http://svn.apache.org/viewvc/xalan/c/branches/GSoC-2012/xdocs/sources/make-book.sh?rev=1391665&view=auto
==============================================================================
--- xalan/c/branches/GSoC-2012/xdocs/sources/make-book.sh (added)
+++ xalan/c/branches/GSoC-2012/xdocs/sources/make-book.sh Fri Sep 28 21:26:05 2012
@@ -0,0 +1,54 @@
+#!/bin/sh
+#
+# Bourne shell script to create Xalan-C documentation pages
+#
+# SET THE LIBRARY PATH FOR YOUR OPERATING SYSTEM, REQUIRED BY "Xalan" PROGRAM
+#
+# SOLARIS AND LINUX
+ export LD_LIBRARY_PATH=/usr/local/lib
+#
+# AIX AND BSD
+# export LIBPATH=/usr/local/lib
+#
+# HPUX
+# export SHLIB_PATH=/usr/local/lib
+#
+# MAC OS/X
+# export DYLD_LIBRARY_PATH=/usr/local/lib
+#
+# CYGWIN AND MINGW
+# export PATH=$PATH;/usr/local/lib
+#
+
+umask 0002
+mkdir -p ../../build/docs/xalan-c/resources
+
+make-xalan.sh usagepatterns
+make-xalan.sh samples
+make-xalan.sh resources
+# make-xalan.sh build_instruct
+make-xalan.sh install
+make-xalan.sh download
+make-xalan.sh overview
+make-xalan.sh charter
+# make-xalan.sh history
+make-xalan.sh whatsnew
+make-xalan.sh extensionslib
+make-xalan.sh commandline
+make-xalan.sh readme
+make-xalan.sh releasenotes
+make-xalan.sh programming
+make-xalan.sh getstarted
+make-xalan.sh index
+make-xalan.sh extensions
+make-xalan.sh faq
+# make-xalan.sh test-faqs
+make-xalan.sh license
+
+make-xalan.sh buildlibs
+make-xalan.sh secureweb
+make-xalan.sh builddocs
+
+cp xalan-graphic/*.* ../../build/docs/xalan-c
+cp xslt-resources/*.* ../../build/docs/xalan-c/resources
+
Propchange: xalan/c/branches/GSoC-2012/xdocs/sources/make-book.sh
------------------------------------------------------------------------------
svn:executable = *
Added: xalan/c/branches/GSoC-2012/xdocs/sources/make-xalan.bat
URL: http://svn.apache.org/viewvc/xalan/c/branches/GSoC-2012/xdocs/sources/make-xalan.bat?rev=1391665&view=auto
==============================================================================
--- xalan/c/branches/GSoC-2012/xdocs/sources/make-xalan.bat (added)
+++ xalan/c/branches/GSoC-2012/xdocs/sources/make-xalan.bat Fri Sep 28 21:26:05 2012
@@ -0,0 +1,82 @@
+::
+:: Set the current path to include a stylesheet transformation utility
+::
+:: %1 The document filename (without extension) to transform
+::
+:: -- The Environment Variables for this script --
+::
+:: %XALANBOOKXML% The <book> navigation file for this project
+::
+:: %XALANCMD% The Xalan command-line XSLT transformation utility
+::
+:: %XALANSTYLE% The XSLT stylesheet to
+::
+:: %XALANSRCDIR% Source directory of STYLEBOOK markup XML documents
+::
+:: %XALANOUTDIR% Target directory of XHTML web page documents
+::
+:: %XALANLOGOIMG% Web Page Logo
+::
+:: %XALANLOGOWIDTH% Web Page Logo Width
+::
+:: %XALANLOGOHEIGHT% Web Page Logo Height
+::
+:: %XALANLOGOLINK% Active Link for Web Page Logo
+::
+:: %XALANTITLELINK% Active Link for Web Page Title
+::
+:: %WEBCREATED% Web Page Creation Date
+::
+:: -- The XSLT Stylesheet Top-Level Parameters
+::
+:: sectionid Top-level stylesheet parameter (document file id)
+::
+:: createdate Top-level stylesheet parameter (web page creation date)
+::
+:: logoimage Apache Trademark Logo Image
+::
+:: logolink Logo Image - hot link
+::
+:: bookxml The <book>.xml file for navigation
+::
+:: booklink The Hot-Link for Book Title in Header
+::
+
+SET XALANBOOKXML=xalan.xml
+
+SET XALANCMD=..\..\bin\xalan.exe
+
+SET XALANSTYLE=stylebook.xslt
+
+SET XALANSRCDIR=xalan
+
+SET XALANOUTDIR=..\..\build\docs\xalan-c
+
+SET XALANLOGOIMG=resources/XalanC-Logo-tm.png
+
+SET XALANLOGOWIDTH=190
+
+SET XALANLOGOHEIGHT=90
+
+SET XALANLOGOLINK=../index.html
+
+SET XALANTITLELINK=index.html
+
+SET WEBCREATED=%DATE%
+
+::
+:: Create Target Directories
+::
+
+IF EXIST "%XALANOUTDIR%" GOTO NEXT1
+MKDIR "%XALANOUTDIR%"
+:NEXT1
+IF EXIST "%XALANOUTDIR%\resources" GOTO NEXT2
+MKDIR "%XALANOUTDIR%\resources"
+:NEXT2
+
+::
+:: Now create the specific web page from StyleBook XML
+::
+
+"%XALANCMD%" -p sectionid "'%1'" -p xmlsources "'%XALANSRCDIR%'" -p createdate "'%WEBCREATED%'" -p logoimage "'%XALANLOGOIMG%'" -p logowidth "'%XALANLOGOWIDTH%'" -p logoheight "'%XALANLOGOHEIGHT%'" -p logolink "'%XALANLOGOLINK%'" -p bookxml "'%XALANBOOKXML%'" -p booklink "'%XALANTITLELINK%'" %XALANSRCDIR%\%1.xml %XALANSTYLE% >%XALANOUTDIR%\%1.html
Propchange: xalan/c/branches/GSoC-2012/xdocs/sources/make-xalan.bat
------------------------------------------------------------------------------
svn:executable = *
Added: xalan/c/branches/GSoC-2012/xdocs/sources/make-xalan.sh
URL: http://svn.apache.org/viewvc/xalan/c/branches/GSoC-2012/xdocs/sources/make-xalan.sh?rev=1391665&view=auto
==============================================================================
--- xalan/c/branches/GSoC-2012/xdocs/sources/make-xalan.sh (added)
+++ xalan/c/branches/GSoC-2012/xdocs/sources/make-xalan.sh Fri Sep 28 21:26:05 2012
@@ -0,0 +1,128 @@
+#!/bin/sh
+#
+# Bourne shell script to create a single xalan-c webpage
+# Parameter $1 is the basename of the page to generate.
+#
+#-------------------------------------------------------------
+#
+# Set the current path to include the "Xalan" stylesheet transformation utility
+#
+# $1 The document filename (without extension) to transform
+#
+# -- The Environment Variables for this script --
+#
+# ${XALANBOOKXML} The <book> navigation file for this project
+#
+# ${XALANCMD} The Xalan command-line XSLT transformation utility
+#
+# ${XALANSTYLE} The XSLT stylesheet to
+#
+# ${XALANSRCDIR} Source directory of STYLEBOOK markup XML documents
+#
+# ${XALANOUTDIR} Target directory of XHTML web page documents
+#
+# ${XALANLOGOIMG} Web Page Logo
+#
+# ${XALANLOGOWIDTH} Web Page Logo Width
+#
+# ${XALANLOGOHEIGHT} Web Page Logo Height
+#
+# ${XALANLOGOLINK} Active Link for Web Page Logo
+#
+# ${XALANTITLELINK} Active Link for Web Page Title
+#
+# ${WEBCREATED} Web Page Creation Date
+#
+# -- The XSLT Stylesheet Top-Level Parameters
+#
+# sectionid Top-level stylesheet parameter (document file id)
+#
+# createdate Top-level stylesheet parameter (web page creation date)
+#
+# logoimage Apache Trademark Logo Image
+#
+# logolink Logo Image - hot link
+#
+# bookxml The <book>.xml file for navigation
+#
+# booklink The Hot-Link for Book Title in Header
+#
+
+# Set some environment variables
+
+XALANBOOKXML=xalan.xml
+
+XALANCMD=Xalan
+
+XALANSTYLE=stylebook.xslt
+
+XALANSRCDIR=xalan
+
+XALANOUTDIR=../../build/docs/xalan-c
+
+XALANLOGOIMG=resources/XalanC-Logo-tm.png
+
+XALANLOGOWIDTH=190
+
+XALANLOGOHEIGHT=90
+
+XALANLOGOLINK=../index.html
+
+XALANTITLELINK=index.html
+
+WEBCREATED=`date +"%a %F"`
+
+## DEBUG BEGIN
+
+#echo INPUT PARAM = $1
+#echo XALANBOOKXML = ${XALANBOOKXML}
+#echo XALANCMD = ${XALANCMD}
+#echo XALANSTYLE = ${XALANSTYLE}
+#echo XALANSRCDIR = ${XALANSRCDIR}
+#echo XALANOUTDIR = ${XALANOUTDIR}
+#echo XALANLOGOIMG = ${XALANLOGOIMG}
+#echo XALANLOGOWIDTH = ${XALANLOGOWIDTH}
+#echo XALANLOGOHEIGHT = ${XALANLOGOHEIGHT}
+#echo XALANLOGOLINK = ${XALANLOGOLINK}
+#echo XALANTITLELINK = ${XALANTITLELINK}
+#echo WEBCREATED = ${WEBCREATED}
+#exit
+
+## DEBUG END
+
+
+#
+# Create Target Directories
+#
+
+if [ ! -d "${XALANOUTDIR}" ]; then
+ mkdir -p "${XALANOUTDIR}"
+fi
+
+#IF EXIST "%XALANOUTDIR%" GOTO NEXT1
+#MKDIR "%XALANOUTDIR%"
+#:NEXT1
+
+if [ ! -d "${XALANOUTDIR}/resources" ] ; then
+ mkdir -p "${XALANOUTDIR}/resources"
+fi
+
+#IF EXIST "%XALANOUTDIR%/resources" GOTO NEXT2
+#MKDIR "%XALANOUTDIR%/resources"
+#:NEXT2
+
+#
+# Now create the specific web page from StyleBook XML
+#
+
+"${XALANCMD}" \
+ -p sectionid "'$1'" \
+ -p xmlsources "'${XALANSRCDIR}'" \
+ -p createdate "'${WEBCREATED}'" \
+ -p logoimage "'${XALANLOGOIMG}'" \
+ -p logowidth "'${XALANLOGOWIDTH}'" \
+ -p logoheight "'${XALANLOGOHEIGHT}'" \
+ -p logolink "'${XALANLOGOLINK}'" \
+ -p bookxml "'${XALANBOOKXML}'" \
+ -p booklink "'${XALANTITLELINK}'" \
+ "${XALANSRCDIR}/$1.xml" "${XALANSTYLE}" >"${XALANOUTDIR}/$1.html"
Propchange: xalan/c/branches/GSoC-2012/xdocs/sources/make-xalan.sh
------------------------------------------------------------------------------
svn:executable = *
Added: xalan/c/branches/GSoC-2012/xdocs/sources/stylebook.xslt
URL: http://svn.apache.org/viewvc/xalan/c/branches/GSoC-2012/xdocs/sources/stylebook.xslt?rev=1391665&view=auto
==============================================================================
--- xalan/c/branches/GSoC-2012/xdocs/sources/stylebook.xslt (added)
+++ xalan/c/branches/GSoC-2012/xdocs/sources/stylebook.xslt Fri Sep 28 21:26:05 2012
@@ -0,0 +1,988 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
+<!--
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+-->
+
+<!--
+* <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+* "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+-->
+
+<xsl:output method="xml" version="1.0" indent="yes"
+ doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN"
+ doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"
+ omit-xml-declaration="no"
+ encoding="UTF-8"
+ standalone="no"
+/>
+
+<!-- THE TOP-LEVEL PARAMETERS
+
+ logoimage = resource image for active logo (resources/asf_logo.png)
+ logolink = logo active hyperlink (http://xalan.apache.org)
+ logowidth = width of trademark logo in pixels
+ logoheight = height of tracemark logo in pixels
+
+ bookxml = path to the book.xml for navigation and book title
+ booklink = path to the index.html for the book
+
+ sectionid = basename of the source xml file without the (.xml) extension.
+ createdate = date that this stylesheet is used.
+
+ xmlsources = directory where project sources reside
+
+ ===============
+
+ Building a documentation web page using a commandline XSLTt transformation program
+
+ EXSLT -p sectionid='getstarted' -p createdate='Aug 7, 2011'
+ -p logoimage='resources/xalan-logo.png'
+ -p logolink='http://xalan.apache.org'
+ -p logowidth='144'
+ -p logoheight='75'
+ -p bookxml='xalan.xml'
+ -p booklink='index.html'
+ xalan\documentfile.xml xalan-manual.xslt ..\html\documentfile.html
+-->
+
+<xsl:param name="logoimage">resources/asf_logo.png</xsl:param>
+<xsl:param name="logolink">http://www.apache.org</xsl:param>
+<xsl:param name="logowidth">144</xsl:param>
+<xsl:param name="logoheight">75</xsl:param>
+
+<xsl:param name="bookxml">xalan.xml</xsl:param>
+<xsl:param name="booklink">index.html</xsl:param>
+
+<xsl:param name="sectionid">index</xsl:param>
+<xsl:param name="createdate"/>
+
+<xsl:param name="xmlsources">xalan</xsl:param>
+
+
+<!-- THE ROOT TEMPLATE TO BUILD ASF STYLEBOOK WEB PAGE -->
+
+<xsl:template match="/">
+
+<!-- CONSTRUCT A BOOK TITLE FROM THE REFERENCED BOOK XML -->
+
+ <xsl:variable name="booktitle">
+ <xsl:value-of select='document($bookxml)/book/@title'/>
+ </xsl:variable>
+
+
+<!-- CONSTRUCT A BOOK SUBTITLE TITLE FROM SOURCE XML PROPERTIES -->
+
+ <xsl:variable name="xalantitle">
+ <xsl:choose>
+ <xsl:when test="s1/@title">
+ <xsl:value-of select="s1/@title"/>
+ </xsl:when>
+ <xsl:when test="s2/@title">
+ <xsl:value-of select="s2/@title"/>
+ </xsl:when>
+ <xsl:when test="s3/@title">
+ <xsl:value-of select="s3/@title"/>
+ </xsl:when>
+ <xsl:when test="faqs">
+ <xsl:choose>
+ <xsl:when test="faqs/@title">
+ <xsl:value-of select="faqs/@title"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:text>Frequently Asked Questions</xsl:text>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:when>
+ <xsl:when test="resources">
+ <xsl:text>Resources</xsl:text>
+ </xsl:when>
+ <xsl:when test="changes/@title">
+ <xsl:value-of select="changes/@title"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:text>DEBUG - xalantitle not found</xsl:text>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+
+<xsl:element name='html'>
+ <xsl:element name='head'>
+ <xsl:element name='title'>
+ <xsl:value-of select="concat('ASF: ',$xalantitle)"/>
+ </xsl:element><!--/title-->
+ <meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
+ <meta http-equiv="Content-Style-Type" content="text/css"/>
+ <link rel="stylesheet" type="text/css" href="resources/apache-xalan.css"/>
+ </xsl:element><!--/head-->
+
+<!-- PUT IN THE APACHE SOFTWARE FOUNDATION LICENSING STATEMENT -->
+ <xsl:comment>
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ </xsl:comment>
+
+ <body>
+ <!-- THE TITLE SECTION -->
+
+ <xsl:call-template name="doTitle">
+ <xsl:with-param name="headtitle">
+ <xsl:value-of select="$booktitle"/>
+ </xsl:with-param>
+ <xsl:with-param name="headtitlelink">
+ <xsl:value-of select="$booklink"/>
+ </xsl:with-param>
+ <xsl:with-param name="headsubtitle">
+ <xsl:value-of select="$xalantitle"/>
+ </xsl:with-param>
+ <xsl:with-param name="headlogoimg">
+ <xsl:value-of select="$logoimage"/>
+ </xsl:with-param>
+ <xsl:with-param name="headlogolink">
+ <xsl:value-of select="$logolink"/>
+ </xsl:with-param>
+ <xsl:with-param name="headlogoheight">
+ <xsl:value-of select="$logoheight"/>
+ </xsl:with-param>
+ <xsl:with-param name="headlogowidth">
+ <xsl:value-of select="$logowidth"/>
+ </xsl:with-param>
+ </xsl:call-template>
+
+ <!-- THE NAVIGATION SECTION -->
+
+ <xsl:call-template name="doLeftNav">
+ <xsl:with-param name="sectparm">
+ <xsl:value-of select="$sectionid"/>
+ </xsl:with-param>
+ </xsl:call-template>
+
+ <!-- THE MAIN CONTENT SECTION -->
+
+ <xsl:call-template name="doContent">
+ <xsl:with-param name="mysectionid">
+ <xsl:value-of select="$sectionid"/>
+ </xsl:with-param>
+ </xsl:call-template>
+
+ <!-- THE COPYRIGHT FOOTER -->
+
+ <xsl:call-template name="doFooter">
+ <xsl:with-param name="releaseinfo">
+ <xsl:text>Web Page created on - </xsl:text>
+ <xsl:value-of select="$createdate"/>
+ </xsl:with-param>
+ </xsl:call-template>
+ </body>
+</xsl:element><!--html-->
+</xsl:template>
+
+
+<!-- DEBUG TEMPLATE -->
+<xsl:template name="DEBUG">
+ <xsl:param name="theText"/>
+ <xsl:param name="theNode"/>
+ <xsl:element name="DEBUG">
+ <xsl:element name="DEBUGTEXT">
+ <xsl:value-of select="$theText"/>
+ </xsl:element>
+ <xsl:if test="$theNode">
+ <xsl:element name="DEBUGNODES">
+ <xsl:copy-of select="$theNode"/>
+ </xsl:element>
+ </xsl:if>
+ </xsl:element>
+</xsl:template>
+
+
+<xsl:template name="doTitle">
+ <xsl:param name="headtitle">XML StyleBook Example</xsl:param>
+ <xsl:param name="headtitlelink">index.html</xsl:param>
+ <xsl:param name="headsubtitle">Documentation Test Example</xsl:param>
+ <xsl:param name="headlogoimg">resources/asf_logo.png</xsl:param>
+ <xsl:param name="headlogolink">http://www.apache.org</xsl:param>
+ <xsl:param name="headlogoheight"><xsl:value-of select="$logoheight"/></xsl:param>
+ <xsl:param name="headlogowidth"><xsl:value-of select="$logowidth"/></xsl:param>
+ <xsl:element name="div">
+ <xsl:attribute name="id">
+ <xsl:text>title</xsl:text>
+ </xsl:attribute>
+ <table class="HdrTitle">
+ <tbody>
+ <tr>
+ <th rowspan="2">
+ <xsl:element name='a'>
+ <xsl:attribute name='href'><xsl:value-of select='$headlogolink'/></xsl:attribute>
+ <xsl:element name='img'>
+ <xsl:attribute name='alt'><xsl:text>Trademark Logo</xsl:text></xsl:attribute>
+ <xsl:attribute name='src'><xsl:value-of select="$headlogoimg"/></xsl:attribute>
+ <xsl:attribute name='width'><xsl:value-of select="$headlogowidth"/></xsl:attribute>
+ <xsl:attribute name='height'><xsl:value-of select="$headlogoheight"/></xsl:attribute>
+ </xsl:element><!-- img -->
+ </xsl:element><!-- a -->
+ </th>
+ <th text-align="center" width="75%">
+ <xsl:element name='a'>
+ <xsl:attribute name='href'>
+ <xsl:value-of select="$headtitlelink"/>
+ </xsl:attribute>
+ <xsl:value-of select="$headtitle"/>
+ </xsl:element><!-- a -->
+ </th>
+ </tr>
+ <tr>
+ <td valign="middle"><xsl:value-of select="$headsubtitle"/></td>
+ </tr>
+ </tbody>
+ </table>
+
+<!-- </xsl:element> -->
+
+<!-- Useful Emulation of Project Header Buttons -->
+
+<!-- <table class="HdrButtons"> -->
+
+ <table class="HdrButtons" align="center" border="1">
+ <tbody>
+ <tr>
+ <td><a href="http://www.apache.org">Apache Foundation</a></td>
+ <td><a href="http://xalan.apache.org">Xalan Project</a></td>
+ <td><a href="http://xerces.apache.org">Xerces Project</a></td>
+ <td><a href="http://www.w3.org/TR">Web Consortium</a></td>
+ <td><a href="http://www.oasis-open.org/standards">Oasis Open</a></td>
+ </tr>
+ </tbody>
+ </table>
+ </xsl:element>
+<!-- -->
+
+</xsl:template>
+
+
+<xsl:template name="doLeftNav">
+<xsl:param name="sectparm" select="''"/>
+<xsl:element name="div">
+ <xsl:attribute name="id">navLeft</xsl:attribute>
+ <ul>
+ <xsl:for-each select="document($bookxml)/book/*">
+ <xsl:if test="name(.)!='hidden'">
+ <xsl:choose>
+ <xsl:when test="name(.)='external'">
+ <li>
+ <xsl:element name="a">
+ <xsl:attribute name="href">
+ <xsl:value-of select="@href"/>
+ </xsl:attribute>
+ <xsl:value-of select="@label"/>
+ </xsl:element>
+ </li>
+ </xsl:when>
+ <xsl:when test="name(.)='resources'">
+ <li>
+ <xsl:choose>
+ <xsl:when test="$sectparm != 'resources'">
+ <a href="resources.html">Resources</a><br/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:text>Resources</xsl:text><br/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </li>
+ </xsl:when>
+ <xsl:when test="name(.)='changes'">
+ <li>
+ <xsl:choose>
+ <xsl:when test="$sectparm != 'changes'">
+ <a href="changes.html">Changes</a><br/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:text>Changes</xsl:text>
+ </xsl:otherwise>
+ </xsl:choose>
+ </li>
+ </xsl:when>
+ <xsl:when test="name(.)='separator'"> <!-- </ul> <hr/> <ul> -->
+ <xsl:text disable-output-escaping="yes"></ul><hr /><ul></xsl:text>
+ </xsl:when>
+ <xsl:when test="(name(.)='document') or (name(.)='faqs')">
+ <li>
+ <xsl:choose>
+ <xsl:when test="$sectparm != string(@id)">
+ <xsl:element name="a">
+ <xsl:attribute name="href">
+ <xsl:value-of select="concat(@id,'.html')"/>
+ </xsl:attribute>
+ <xsl:value-of select="@label"/>
+ </xsl:element>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:value-of select="@label"/><br/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </li>
+ </xsl:when>
+
+
+ <xsl:when test="name(.)='group'">
+ <xsl:text disable-output-escaping="yes"></ul></xsl:text>
+ <xsl:element name="p">
+ <xsl:attribute name="class">navGroup</xsl:attribute>
+ <em><xsl:value-of select="@label"/></em>
+ </xsl:element>
+ <xsl:text disable-output-escaping="yes"><ul></xsl:text>
+
+ <xsl:for-each select="./*">
+ <xsl:choose>
+
+ <xsl:when test="name(.)='external'">
+ <li>
+ <xsl:element name="a">
+ <xsl:attribute name="href">
+ <xsl:value-of select="@href"/>
+ </xsl:attribute>
+ <xsl:value-of select="@label"/>
+ </xsl:element>
+ </li>
+ </xsl:when>
+ <xsl:when test="name(.)='resources'">
+ <li>
+ <xsl:choose>
+ <xsl:when test="$sectparm != 'resources'">
+ <a href="resources.html">Resources</a><br/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:text>Resources</xsl:text><br/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </li>
+ </xsl:when>
+ <xsl:when test="name(.)='changes'">
+ <li>
+ <xsl:choose>
+ <xsl:when test="$sectparm != 'changes'">
+ <a href="changes.html">Changes</a><br/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:text>Changes</xsl:text>
+ </xsl:otherwise>
+ </xsl:choose>
+ </li>
+ </xsl:when>
+ <xsl:when test="(name(.)='document') or (name(.)='faqs')">
+ <li>
+ <xsl:choose>
+ <xsl:when test="$sectparm != string(@id)">
+ <xsl:element name="a">
+ <xsl:attribute name="href">
+ <xsl:value-of select="concat(@id,'.html')"/>
+ </xsl:attribute>
+ <xsl:value-of select="@label"/>
+ </xsl:element>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:value-of select="@label"/><br/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </li>
+ </xsl:when>
+
+
+ <xsl:otherwise>
+<!--
+ ! Unrecognized child of Navigation <group> element -->
+-->
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:for-each>
+ </xsl:when>
+ <xsl:otherwise>
+<!--
+ ! Unrecognized child of Navigation <book> element -->
+-->
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:if> <!-- not hidden -->
+ </xsl:for-each>
+ </ul>
+</xsl:element>
+</xsl:template>
+
+
+<xsl:template name="doContent">
+ <xsl:element name="div">
+ <xsl:attribute name="id">content</xsl:attribute>
+ <xsl:choose>
+ <xsl:when test="faqs">
+ <xsl:for-each select="faqs">
+ <xsl:call-template name="doFaqDocument"/>
+ </xsl:for-each>
+ </xsl:when>
+ <xsl:when test="resources">
+ <xsl:for-each select="resources">
+ <xsl:call-template name="doResDocument"/>
+ </xsl:for-each>
+ </xsl:when>
+ <xsl:when test="changes">
+ <xsl:for-each select="changes">
+ <xsl:call-template name="doChangesDoc"/>
+ </xsl:for-each>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:apply-templates/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:element>
+</xsl:template>
+
+
+<xsl:template name="doFooter">
+ <xsl:param name="releaseinfo"/>
+ <xsl:element name="div">
+ <xsl:attribute name="id">footer</xsl:attribute>
+ <!-- copyright byline information -->
+ <!-- © is the (c) copyright symbol -->
+ <xsl:text>Copyright © 1999-2012 The Apache Software Foundation</xsl:text><br/>
+ <xsl:text>Apache, Xalan, and the Feather logo are trademarks of The Apache Software Foundation</xsl:text>
+ <xsl:element name="div">
+ <xsl:attribute name="class">small</xsl:attribute>
+ <xsl:value-of select="$releaseinfo"/>
+ </xsl:element>
+ </xsl:element>
+</xsl:template>
+
+
+<!--
+ getPrevFaqCount returns the number of <faq> elements found in the previous <group>s
+ Used to create sequential ID numbers across <faq> groups for titles and anchors.
+-->
+
+<xsl:template name="getPrevFaqCount">
+ <xsl:param name="mygroup">1</xsl:param>
+ <xsl:variable name="faqcount">
+ <xsl:choose>
+ <xsl:when test="$mygroup <= 1">0</xsl:when>
+ <xsl:otherwise>
+ <xsl:variable name="subcount">
+ <xsl:call-template name="getPrevFaqCount">
+ <xsl:with-param name="mygroup" select="$mygroup - 1"/>
+ </xsl:call-template>
+ </xsl:variable>
+ <xsl:value-of select="$subcount + count(./group[position()= ($mygroup - 1)]/faq)"/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <xsl:value-of select="$faqcount"/>
+</xsl:template>
+
+<!-- Recursive - Generate the grouped faq Questions section -->
+
+<xsl:template name="groupFaqQuestions">
+ <xsl:param name="mygroup">1</xsl:param>
+ <xsl:if test="./group[position()=$mygroup]">
+ <h3><xsl:value-of select="./group[position()=$mygroup]/@title"/></h3>
+ <xsl:variable name="prevfaqs">
+ <xsl:call-template name="getPrevFaqCount">
+ <xsl:with-param name="mygroup"><xsl:value-of select="$mygroup"/></xsl:with-param>
+ </xsl:call-template>
+ </xsl:variable>
+ <xsl:for-each select="./group[position()=$mygroup]">
+
+<!-- list must have at least one faq -->
+ <xsl:if test="./faq[position()=1]">
+ <xsl:element name="ol">
+ <xsl:attribute name="start">
+ <xsl:value-of select="$prevfaqs + 1"/>
+ </xsl:attribute>
+ <xsl:call-template name="doFaqTitles">
+ <xsl:with-param name="faqNbr"><xsl:value-of select="$prevfaqs + 1"/></xsl:with-param>
+ </xsl:call-template>
+ </xsl:element>
+ </xsl:if>
+ </xsl:for-each>
+ <xsl:call-template name="groupFaqQuestions">
+ <xsl:with-param name="mygroup"><xsl:value-of select="$mygroup + 1"/></xsl:with-param>
+ </xsl:call-template>
+ </xsl:if>
+</xsl:template>
+
+<!-- Recursive - Generate the grouped faq Answers section -->
+
+<xsl:template name="groupFaqAnswers">
+ <xsl:param name="mygroup">1</xsl:param>
+ <xsl:if test="./group[position()=$mygroup]">
+ <xsl:variable name="prevfaqs">
+ <xsl:call-template name="getPrevFaqCount">
+ <xsl:with-param name="mygroup"><xsl:value-of select="$mygroup"/></xsl:with-param>
+ </xsl:call-template>
+ </xsl:variable>
+ <xsl:for-each select="./group[position()=$mygroup]">
+ <xsl:if test="./faq[position()=1]">
+ <xsl:call-template name="doFaqContent">
+ <xsl:with-param name="faqNbr" select="$prevfaqs + 1"/>
+ </xsl:call-template>
+ </xsl:if>
+ </xsl:for-each>
+ <xsl:call-template name="groupFaqAnswers">
+ <xsl:with-param name="mygroup" select="$mygroup + 1"/>
+ </xsl:call-template>
+ </xsl:if>
+</xsl:template>
+
+
+<!-- Updated to accommodate faq groups for XALAN-J -->
+
+<xsl:template name="doFaqDocument">
+ <h2 class="faqSubHead">Questions</h2>
+ <xsl:choose>
+ <xsl:when test="./group[position()=1]">
+ <xsl:call-template name="groupFaqQuestions"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:if test="./faq[position()=1]">
+ <ol start="1">
+ <xsl:call-template name="doFaqTitles"/>
+ </ol>
+ </xsl:if>
+ </xsl:otherwise>
+ </xsl:choose>
+ <h2 class="faqSubHead">Answers</h2>
+ <xsl:choose>
+ <xsl:when test="./group[position()=1]">
+ <xsl:call-template name="groupFaqAnswers"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:call-template name="doFaqContent"/>
+ </xsl:otherwise>
+ </xsl:choose>
+</xsl:template>
+
+
+<xsl:template name="doFaqTitles">
+ <xsl:param name="faqNbr">1</xsl:param>
+ <xsl:param name="myNbr">1</xsl:param>
+ <xsl:if test="faq[position()=$myNbr]">
+ <!-- output the title reference -->
+ <li>
+ <xsl:element name="a">
+ <xsl:attribute name="href">
+ <xsl:value-of select="concat('#faq-', $faqNbr)"/>
+ </xsl:attribute>
+ <xsl:value-of select="faq[position()=$myNbr]/@title"/>
+ </xsl:element>
+ </li>
+ <!-- get the next faq if any -->
+ <xsl:call-template name="doFaqTitles">
+ <xsl:with-param name="faqNbr" select="number($faqNbr + 1)"/>
+ <xsl:with-param name="myNbr" select="number($myNbr + 1)"/>
+ </xsl:call-template>
+ </xsl:if>
+</xsl:template>
+
+
+<xsl:template name="doFaqContent">
+ <xsl:param name="faqNbr">1</xsl:param>
+ <xsl:param name="myNbr">1</xsl:param>
+
+ <xsl:if test="faq[position()=$myNbr]"> <!-- output content of this element only -->
+
+<!-- <h3><xsl:value-of select="faq[position()=$myNbr]/@title"/></h3> -->
+
+ <xsl:element name="h3">
+ <xsl:attribute name="id">
+ <xsl:value-of select="concat('faq-', $faqNbr)"/>
+ </xsl:attribute>
+ <xsl:attribute name="class">
+ <xsl:text>faqTitle</xsl:text>
+ </xsl:attribute>
+ <xsl:value-of select="concat($faqNbr, '. ', faq[position()=$myNbr]/@title)"/>
+ </xsl:element>
+
+<!-- The FAQ Text Part -->
+ <xsl:for-each select="faq[position()=$myNbr]/*"> <!-- children of 'faq' -->
+ <xsl:choose>
+ <xsl:when test="name(.)='q'"> <!-- The Question Text -->
+ <div class="faqQuestion">
+ <xsl:apply-templates/> <!-- children of 'q' -->
+ </div>
+ </xsl:when>
+ <xsl:when test="name(.)='a'"> <!-- The Answer Text -->
+ <br/>
+ <hr/>
+ <div class="faqAnswer">
+ <xsl:apply-templates/> <!-- children of 'a' -->
+ </div>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:apply-templates/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:for-each>
+
+ <xsl:call-template name="goToTop"/>
+
+<!-- Recurse for next faq item -->
+ <xsl:call-template name="doFaqContent">
+ <xsl:with-param name="faqNbr" select="number($faqNbr + 1)"/>
+ <xsl:with-param name="myNbr" select="number($myNbr + 1)"/>
+ </xsl:call-template>
+ </xsl:if>
+</xsl:template>
+
+
+<xsl:template name="goToTop">
+ <p align="right" size="2">
+ <a href="#content">(top)</a>
+ </p>
+</xsl:template>
+
+
+<xsl:template name="doResDocument">
+ <xsl:for-each select="resource|human-resource">
+ <xsl:choose>
+ <xsl:when test="name(.)='resource'">
+<!-- <h4 class="resourcetitle"><strong><xsl:value-of select="@title"/></strong><h4> -->
+ <xsl:element name="h4">
+ <xsl:attribute name="class">resourcetitle</xsl:attribute>
+ <strong><xsl:value-of select="@title"/></strong>
+ </xsl:element>
+ <p>id = [<xsl:value-of select="@id"/>]<br/>
+ <xsl:element name="a">
+ <xsl:attribute name="href">
+ <xsl:value-of select="@location"/>
+ </xsl:attribute>
+ <xsl:value-of select="@location"/>
+ </xsl:element><br/></p>
+ </xsl:when>
+ <xsl:when test="name(.)='human-resource'">
+<!-- <h4 class="resourcetitle"><strong><xsl:value-of select="@name"/></strong><h4> -->
+ <xsl:element name="h4">
+ <xsl:attribute name="class">resourcetitle</xsl:attribute>
+ <strong><xsl:value-of select="@name"/></strong>
+ </xsl:element>
+ <p>id = [<xsl:value-of select="@id"/>]<br/>
+ <xsl:element name="a">
+ <xsl:attribute name="href">
+ <xsl:value-of select="concat('mailto:',@mailto)"/>
+ </xsl:attribute>
+ <xsl:value-of select="concat('mailto:',@mailto)"/>
+ </xsl:element><br/></p>
+ </xsl:when>
+ </xsl:choose>
+ </xsl:for-each>
+</xsl:template>
+
+<xsl:template name="doChangesDoc">
+ <!-- context is <changes> element -->
+ <xsl:for-each select="release">
+ <h3 class="chgRelease">
+ <xsl:value-of select="concat('Release ',@version,' (',@date,')')"/>
+ </h3>
+ <xsl:if test="features">
+ <h4 class="chgFeatures"><xsl:text>Features</xsl:text></h4>
+ <xsl:for-each select="features">
+ <ul>
+ <xsl:for-each select="feat">
+ <li><xsl:apply-templates/></li>
+ </xsl:for-each>
+ </ul>
+ <hr/>
+ </xsl:for-each>
+ </xsl:if>
+ <xsl:if test="fixes">
+ <h4 class="chgFixes"><xsl:text>Bug Fixes</xsl:text></h4>
+ <xsl:for-each select="fixes">
+ <ul>
+ <xsl:for-each select="fix">
+ <li><xsl:apply-templates/></li>
+ </xsl:for-each>
+ </ul>
+ <hr/>
+ </xsl:for-each>
+ </xsl:if>
+ <xsl:call-template name="goToTop"/>
+ </xsl:for-each>
+</xsl:template>
+
+<!-- THE MATCHING TEMPLATE RULES -->
+
+<xsl:template match="s1">
+ <h2><xsl:value-of select="@title"/></h2>
+ <xsl:apply-templates/>
+ <xsl:call-template name="goToTop"/>
+</xsl:template>
+
+<xsl:template match="s2">
+ <xsl:call-template name="goToTop"/>
+ <h3><xsl:value-of select="@title"/></h3>
+ <xsl:apply-templates/>
+</xsl:template>
+
+<xsl:template match="s3">
+ <xsl:call-template name="goToTop"/>
+ <h4><xsl:value-of select="@title"/></h4>
+ <xsl:apply-templates/>
+</xsl:template>
+
+<xsl:template match="s4">
+ <h5><xsl:value-of select="@title"/></h5>
+ <xsl:apply-templates/>
+</xsl:template>
+
+<!--<!ENTITY % blocks "p|note|ul|ol|gloss|table|source|anchor">-->
+
+<xsl:template match="p">
+ <p><xsl:apply-templates/></p>
+</xsl:template>
+
+<xsl:template match="ul">
+ <ul><xsl:apply-templates/></ul>
+</xsl:template>
+
+<xsl:template match="ol">
+ <ol><xsl:apply-templates/></ol>
+</xsl:template>
+
+<xsl:template match="li">
+ <li><xsl:apply-templates/></li>
+</xsl:template>
+
+<xsl:template match="table">
+ <table border="1"><xsl:apply-templates/></table>
+</xsl:template>
+
+<xsl:template match="tr">
+ <tr><xsl:apply-templates/></tr>
+</xsl:template>
+
+<xsl:template match="tn">
+ <td class="empty"/><!-- empty table element -->
+</xsl:template>
+
+<xsl:template match="th">
+ <xsl:element name="th">
+ <xsl:attribute name="class">content</xsl:attribute>
+ <xsl:if test="@rowspan">
+ <xsl:attribute name="rowspan">
+ <xsl:value-of select="@rowspan"/>
+ </xsl:attribute>
+ </xsl:if>
+ <xsl:if test="@colspan">
+ <xsl:attribute name="colspan">
+ <xsl:value-of select="@colspan"/>
+ </xsl:attribute>
+ </xsl:if>
+ <xsl:apply-templates/>
+ </xsl:element>
+</xsl:template>
+
+<xsl:template match="td">
+ <xsl:element name="td">
+ <xsl:attribute name="class">content</xsl:attribute>
+ <xsl:if test="@rowspan">
+ <xsl:attribute name="rowspan">
+ <xsl:value-of select="@rowspan"/>
+ </xsl:attribute>
+ </xsl:if>
+ <xsl:if test="@colspan">
+ <xsl:attribute name="colspan">
+ <xsl:value-of select="@colspan"/>
+ </xsl:attribute>
+ </xsl:if>
+ <xsl:apply-templates/>
+ </xsl:element>
+</xsl:template>
+
+<!--
+<xsl:template match="note">
+ <blockquote class="note"><xsl:apply-templates/></blockquote>
+</xsl:template>
+-->
+
+<xsl:template match="note">
+ <xsl:element name="table">
+ <xsl:attribute name="class">note</xsl:attribute>
+ <tr>
+ <xsl:element name="td">
+ <xsl:attribute name="class">noteImg</xsl:attribute>
+ <xsl:element name="img">
+ <xsl:attribute name="src">resources/note.gif</xsl:attribute>
+ <xsl:attribute name="alt">note</xsl:attribute>
+ </xsl:element>
+ </xsl:element>
+ <xsl:element name="td">
+ <xsl:attribute name="class">noteTxt</xsl:attribute>
+ <xsl:apply-templates/>
+ </xsl:element>
+ </tr>
+ </xsl:element>
+</xsl:template>
+
+<xsl:template match="source">
+ <blockquote class="source"><pre><xsl:value-of select="."/></pre></blockquote>
+</xsl:template>
+
+<xsl:template match="hidden">
+<!-- content is hidden -->
+</xsl:template>
+
+<!--<!ENTITY % markup "em|ref|code|br">-->
+
+<xsl:template match="br">
+ <br/>
+</xsl:template>
+
+<xsl:template match="em">
+ <b><xsl:apply-templates/></b>
+</xsl:template>
+
+<xsl:template match="code">
+ <code><xsl:apply-templates/></code>
+</xsl:template>
+
+<xsl:template match="ref">
+ <b><i><xsl:apply-templates/></i></b>
+</xsl:template>
+
+<!-- Glossary Items <label> <item> -->
+
+<xsl:template match="label">
+ <p class="label"><xsl:apply-templates/></p>
+</xsl:template>
+
+<xsl:template match="item">
+ <p class="item"><xsl:apply-templates/></p>
+</xsl:template>
+
+<!--<!ENTITY % links "link|anchor|jump|img|resource-ref|human-resource-ref">-->
+
+<xsl:template match="anchor">
+ <xsl:element name="a">
+ <xsl:attribute name="name">
+ <xsl:value-of select="@name"/>
+ </xsl:attribute>
+ <xsl:text>‌</xsl:text> <!-- (zero-width non-join) character -->
+ </xsl:element>
+</xsl:template>
+
+<xsl:template match="img">
+ <xsl:copy-of select="."/>
+</xsl:template>
+
+<!-- Glossary elements "gloss (label|item)* -->
+
+<xsl:template match="gloss">
+ <xsl:element name="div">
+ <xsl:attribute name="class">glossary</xsl:attribute>
+ <xsl:apply-templates/>
+ </xsl:element>
+</xsl:template>
+
+<xsl:template match="label">
+ <p class="label"><em>
+ <xsl:apply-templates/>
+ </em></p>
+</xsl:template>
+
+<xsl:template match="item">
+ <xsl:element name="blockquote">
+ <xsl:attribute name="class">item</xsl:attribute>
+ <xsl:apply-templates/>
+ </xsl:element>
+</xsl:template>
+
+<!-- ********
+<!ELEMENT link (#PCDATA|img)*>
+<!ATTLIST link idref NMTOKEN #IMPLIED
+ anchor CDATA #IMPLIED>
+
+<!ELEMENT jump (#PCDATA|img)*>
+<!ATTLIST jump href CDATA #REQUIRED>
+*************
+-->
+
+<xsl:template match="link">
+ <xsl:element name="a">
+ <xsl:attribute name="href">
+ <xsl:if test="@idref">
+ <xsl:value-of select="concat(@idref, '.html')"/>
+ </xsl:if>
+ <xsl:if test="@anchor">
+ <xsl:value-of select="concat('#', @anchor)"/>
+ </xsl:if>
+ </xsl:attribute>
+ <xsl:apply-templates/>
+ </xsl:element>
+</xsl:template>
+
+<xsl:template match="jump">
+ <xsl:element name="a">
+ <xsl:attribute name="href">
+ <xsl:value-of select="@href"/>
+ </xsl:attribute>
+ <xsl:apply-templates/>
+ </xsl:element>
+</xsl:template>
+
+<!-- cross-reference resource elements -->
+
+<!--
+ Resolve Resource References through "resources.xml" document
+-->
+<xsl:template match="resource-ref">
+ <xsl:variable name="idval" select="@idref"/>
+ <xsl:variable name="resref"
+ select="document(concat($xmlsources,'/resources.xml'))//resource[@id=$idval]"/>
+ <xsl:element name="a">
+ <xsl:attribute name="href">
+ <xsl:value-of select="$resref/@location"/>
+ </xsl:attribute>
+ <xsl:value-of select="$resref/@title"/>
+ </xsl:element>
+</xsl:template>
+
+<!--
+ Resolve Mailbox References through "resources.xml" document
+-->
+
+<xsl:template match="human-resource-ref">
+ <xsl:variable name="idval" select="@idref"/>
+ <xsl:variable name="resref"
+ select="document(concat($xmlsources,'/resources.xml'))//human-resource[@id=$idval]"/>
+ <xsl:element name="a">
+ <xsl:attribute name="href">
+ <xsl:value-of select="concat('mailto:',$resref/@mailto)"/>
+ </xsl:attribute>
+ <xsl:value-of select="$resref/@name"/>
+ </xsl:element>
+</xsl:template>
+
+
+</xsl:stylesheet>
Modified: xalan/c/branches/GSoC-2012/xdocs/sources/xalan.xml
URL: http://svn.apache.org/viewvc/xalan/c/branches/GSoC-2012/xdocs/sources/xalan.xml?rev=1391665&r1=1391664&r2=1391665&view=diff
==============================================================================
--- xalan/c/branches/GSoC-2012/xdocs/sources/xalan.xml (original)
+++ xalan/c/branches/GSoC-2012/xdocs/sources/xalan.xml Fri Sep 28 21:26:05 2012
@@ -1,5 +1,5 @@
<?xml version="1.0"?>
-<!DOCTYPE book SYSTEM "sbk:/style/dtd/book.dtd">
+<!DOCTYPE book SYSTEM "../style/dtd/book.dtd">
<!--
* Licensed to the Apache Software Foundation (ASF) under one
@@ -19,20 +19,38 @@
* limitations under the License.
-->
-<book title="Xalan-C++ XSLT User's Guide" copyright="1999-2012 The Apache Software Foundation">
+<book title="Xalan-C/C++ Version 1.11" copyright="1999-2012 The Apache Software Foundation">
- <resources source="sbk:/sources/xalan/resources.xml"/>
-
- <external href="http:/xalan.apache.org/" label="Home"/>
-
+<!-- <hidden> -->
+ <resources source="../sources/xalan/resources.xml"/>
+<!-- </hidden> -->
+
+<!--
+ <external href="http://xalan.apache.org/" label="Home"/>
+-->
+
+ <external href="../index.html" label="Home"/>
+
<separator/>
-
+
<document id="index"
- label="Xalan-C++ 1.10"
+ label="Xalan-C++ 1.11"
source="xalan/index.xml"/>
-
- <separator/>
-
+
+ <document id="whatsnew"
+ label="What's New"
+ source="xalan/whatsnew.xml"/>
+
+ <document id="license"
+ label="Licenses"
+ source="xalan/license.xml"/>
+
+ <separator/>
+<!--
+ <document id="getstarted"
+ label="Getting Started"
+ source="xalan/getstarted.xml"/>
+-->
<document id="overview"
label="Overview"
source="xalan/overview.xml"/>
@@ -40,10 +58,6 @@
<document id="charter"
label="Charter"
source="xalan/charter.xml"/>
-
- <document id="whatsnew"
- label="What's New"
- source="xalan/whatsnew.xml"/>
<separator/>
@@ -51,16 +65,19 @@
label="Download"
source="xalan/download.xml"/>
- <document id="build_instruct"
- label="Building"
- source="xalan/build_instruct.xml"/>
+ <document id="buildlibs"
+ label="Build Libraries"
+ source="xalan/buildlibs.xml"/>
<document id="install"
label="Installation"
source="xalan/install.xml"/>
- <separator/>
+ <document id="builddocs"
+ label="Build Documents"
+ source="xalan/builddocs.xml"/>
+ <separator/>
<document id="samples"
label="Sample Apps"
@@ -88,19 +105,34 @@
label="Extensions Library"
source="xalan/extensionslib.xml"/>
- <external href="apiDocs/index.html" label="API Reference"/>
+ <external href="apiDocs/index.html"
+ label="API Reference"/>
- <separator/>
-
+ <separator/>
+<!--
+ <group id="faqgroup"
+ label="Faq Group">
+-->
<faqs id="faq"
- label="FAQs"
+ label="Xalan-C FAQs"
source="xalan/faq.xml" />
-
+<!--
+ <faqs id="test-faqs"
+ label="Test Faqs"
+ source="xalan/test-faqs" />
+ </group>
+-->
<separator/>
- <external href="whatsnew.html#bugs" label="Bugs"/>
+ <external href="whatsnew.html#bugs"
+ label="Bugs"/>
+
+ <external href="http://xalan.apache.org/old/xalan-j/test/run.html#how-to-run-c"
+ label="Testing"/>
- <external href="http://xml.apache.org/xalan-j/test/run.html#how-to-run-c" label="Testing"/>
+ <document id="secureweb"
+ label="Web Security"
+ source="xalan/secureweb.xml" />
</book>
-
+
Modified: xalan/c/branches/GSoC-2012/xdocs/sources/xalan/build_instruct.xml
URL: http://svn.apache.org/viewvc/xalan/c/branches/GSoC-2012/xdocs/sources/xalan/build_instruct.xml?rev=1391665&r1=1391664&r2=1391665&view=diff
==============================================================================
--- xalan/c/branches/GSoC-2012/xdocs/sources/xalan/build_instruct.xml (original)
+++ xalan/c/branches/GSoC-2012/xdocs/sources/xalan/build_instruct.xml Fri Sep 28 21:26:05 2012
@@ -19,6 +19,8 @@
-->
<s1 title="Building &xslt4c;">
<anchor name="build"/>
+<p>This section is obsolete and is being rewritten.
+See: <jump href="BUILD-LIBS.html">BUILD-LIBS.html</jump></p>
<p>This page was created for users who have downloaded the source distribution of &xslt4c; and are looking for guidance on how to
build the &xslt4c; libraries themselves.</p>
<ul>
@@ -79,9 +81,11 @@
lib directory to the list as well.</li>
</ol></li>
</ol>
-<!-- note>To recompile existing applications without changing your source code, be sure to modify your Project settings to pick up the
+<!-- -->
+<note>To recompile existing applications without changing your source code, be sure to modify your Project settings to pick up the
Xalan headers in its new location. (see image below)</note>
-<p><img src="options-sane.gif" alt="Visual C++ 6.0 Include Directories change"/></p -->
+<p><img src="options-sane.gif" alt="Visual C++ 6.0 Include Directories change"/></p>
+<!-- -->
</s3>
<anchor name="dotNet"/>
@@ -104,9 +108,11 @@
lib directory to the list as well.</li>
</ol></li>
</ol>
-<!-- note>To recompile existing applications without changing your source code, be sure to modify your Project settings to pick up the
+<!-- -->
+<note>To recompile existing applications without changing your source code, be sure to modify your Project settings to pick up the
Xalan headers in its new location. (see image below)</note>
-<p><img src="NET_options.jpg" alt="Visual Studio .NET Include Directories change"/></p -->
+<p><img src="NET_options.jpg" alt="Visual Studio .NET Include Directories change"/></p>
+<!-- -->
</s3>
<anchor name="unix"/>
Added: xalan/c/branches/GSoC-2012/xdocs/sources/xalan/builddocs.xml
URL: http://svn.apache.org/viewvc/xalan/c/branches/GSoC-2012/xdocs/sources/xalan/builddocs.xml?rev=1391665&view=auto
==============================================================================
--- xalan/c/branches/GSoC-2012/xdocs/sources/xalan/builddocs.xml (added)
+++ xalan/c/branches/GSoC-2012/xdocs/sources/xalan/builddocs.xml Fri Sep 28 21:26:05 2012
@@ -0,0 +1,328 @@
+<?xml version="1.0" standalone="no"?>
+<!--
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+-->
+
+<!DOCTYPE s1 SYSTEM "../../style/dtd/document.dtd">
+<s1 title="Building The Documents">
+
+<ul>
+<li><link anchor="buildweb">Building the Xalan-C Web Pages</link></li>
+ <ul>
+ <li><link anchor="b_web_1">Documentation Source Tree</link></li>
+ <li><link anchor="b_web_2">Destination Build Tree</link></li>
+ <li><link anchor="b_web_3">The Web Page Build Environment</link></li>
+ <li><link anchor="b_web_4">Preparing the Navigation File</link></li>
+ <li><link anchor="b_web_5">Creating the Web Pages</link></li>
+ </ul>
+<li><link anchor="buildapi">Building the Xalan-C API Reference</link></li>
+ <ul>
+ <li><link anchor="b_api_1">API Configuration Source Tree</link></li>
+ <li><link anchor="b_api_2">Destination Path for API Web Pages</link></li>
+ <li><link anchor="b_api_3">Build the API Web Pages</link></li>
+ </ul>
+<li><link anchor="integrateapi">Integrate API With Xalan-C Project Web Pages</link></li>
+</ul>
+
+<anchor name="buildweb"/>
+<s2 title="Building the Xalan-C Web Pages">
+
+<p>This section shows how to build the documentation products for Xalan-C/C++.
+This is a subproject of the ASF XALAN PMC.
+</p>
+<p>The XALAN PMC project web page [<jump
+href="http://xalan.apache.org">http://xalan.apache.org</jump>] is a top-level page
+with branches to the subprojects that include the Java and C/C++ code libraries.
+</p>
+<p>The Xalan-C/C++ home web page [<jump
+href="../old/xalan-c">http://xml.apache.org/xalan-c</jump>]
+is the content
+construction that is being described here.
+</p>
+<p>The Apache StyleBook Java program is no longer needed to create useful web pages.
+You should have a standard XSLT transform utility.
+The "Xalan" command-line program distributed with Xalan-C works just fine.
+</p>
+
+<anchor name="b_web_1"/>
+<s3 title="Documentation Source Tree">
+
+<source>
+xalan/c/trunk/xdocs/sources/
+ entities.ent -- Product specific entities
+ make-book.bat -- Build All Web Pages
+ make-xalan.bat -- Build Single Web Page
+ xalan-book.xslt -- Transformation for StyleBook XML
+ xalan.xml -- The Navigation Panel for Xalan-C Pages
+
+xalan/c/trunk/xdocs/sources/xslt-resources/
+ {Common components used by Xalan-C Web Pages}
+ apache-xalan.css -- The Web Page Presentation Style
+ asf_logo.png -- The ASF Trademark Logo
+ note.gif -- A (note:) graphic
+
+xalan/c/trunk/xdocs/sources/xalan/
+ {The StyleBook XML Sources for Xalan-C Web Pages}
+ index.xml -- This creates the root index.html
+ resources.xml -- A resources dispatch page
+
+xalan/c/trunk/xdocs/style/dtd/
+ {Resources for Apache StyleBook Validation}
+ blocks.ent
+ book.dtd
+ changes.dtd
+ characters.ent
+ document.dtd
+ faqs.dtd
+ links.ent
+ markup.ent
+</source>
+</s3>
+
+<anchor name="b_web_2"/>
+<s3 title="Destination Build Tree">
+
+<source>
+xalan/c/trunk/build/docs/html/
+ {The Xalan-C project html Web Pages go here}
+ index.html -- This is the root of the Xalan-C subproject
+
+xalan/c/trunk/build/docs/html/resources/
+ {Resources to support Xalan-C project html Web Pages}
+ apache-xalan.css
+ asf_logo.png
+ note.gif
+
+xalan/c/trunk/build/docs/html/apiDocs/
+ {The Xalan-C API Web Pages go here}
+ index.html -- This is the root of the Xalan-C API Documents
+</source>
+</s3>
+
+<anchor name="b_web_3"/>
+<s3 title="The Web Page Build Environment">
+
+<p>The examples here describe how to build the Xalan-C/C++ web pages when
+connected to the a copy of the (xdocs/sources) directory. So connect to it.
+</p>
+<p>The StyleBook DTD validation files are in the (xdocs/style/dtd) directory.
+</p>
+<p>The StyleBook XML sources for the web pages are in the (xdocs/sources/xalan) directory. Each web page is associated with an XML file in this directory. The transformed output is to be placed in the (build/docs/html) directory. The source XML file and the destination HTML file have the same base filename.
+</p>
+<p>The Web Page output directory is (build/docs/html).
+</p>
+<p>After creating the web pages, copy the (xdocs/sources/xslt-resources/*) files to the (build/docs/html/resources) directory.
+</p>
+<p>Graphic images for individual web pages are in the (xdocs/xalan-graphic) directory and later copied to the (build/docs/html) directory.
+</p>
+</s3>
+
+<anchor name="b_web_4"/>
+<s3 title="Preparing the Navigation File">
+
+<p>The (xdocs/sources/xalan.xml) is the project navigation file that is on
+the left side of each web page.
+The root element is <book>
+containing child elements of <hidden>, <external>,
+<document>, <resources>, <faqs>, and <separator>. The format of this navigation file is inherited from the StyleBook Java program. Our stylesheet uses the <book> to provide only a navigation panel. It does not control the production of the entire suite of web pages.
+</p>
+<p>The markup is validated by DTD and entity definitions in the (xdocs/style/dtd) directory.
+</p>
+<p>The "id=" attribute is the name of the web page file without extension.
+</p>
+<p>The "label=" attribute is the navigation text.
+</p>
+<p>The "source=" attribute is the name of the StyleBook XML source file.
+</p>
+<p>The "href=" attribute is a link to an external resource.
+</p>
+</s3>
+
+<anchor name="b_web_5"/>
+<s3 title="Creating the Web Pages">
+
+<p>The XSLT transformation utility must support top-level parameters.
+The <code>Xalan</code> command-line program built and distributed with the this project
+has sufficient capability to create the project web pages.
+The <code>xalan-book.xslt</code> stylesheet is designed to interpret StyleBook XML and create XHTML web pages for the Xalan-C project.
+</p>
+<p>Example: Create the <code>index.html</code> web page from <code>index.xml</code> source. The arguments are shown on separate lines for convenience of presentation.
+</p>
+<source>
+Xalan.exe
+ -p sectionid "'index'"
+ -p createdate "'Tue 08/09/2011'"
+ xalan\index.xml
+ xalan-book.xslt
+ > ..\..\build\docs\html\index.html
+</source>
+
+<p>Do the same for each web page replacing <code>index</code>,
+<code>index.xml</code>, and <code>index.html</code> in the above example.
+</p>
+<p>Other command-line XSLT processors would have a different calling syntax.
+Check your documentation.</p>
+<p>I use batch files or shell scripts to automate this process.
+The following batch files are what I use on Windows platforms.
+</p>
+<p>The <code>make-book.bat</code> file is used to create all web pages:
+</p>
+<source>
+ mkdir ..\..\build\docs\html\resources
+
+ call make-xalan usagepatterns
+ call make-xalan samples
+ call make-xalan resources
+ call make-xalan install
+ call make-xalan download
+ call make-xalan overview
+ call make-xalan charter
+ call make-xalan whatsnew
+ call make-xalan extensionslib
+ call make-xalan commandline
+ call make-xalan readme
+ call make-xalan releasenotes
+ call make-xalan programming
+ call make-xalan getstarted
+ call make-xalan index
+ call make-xalan extensions
+ call make-xalan faq
+ call make-xalan license
+ call make-xalan buildlibs
+ call make-xalan secureweb
+
+ copy xalan-graphic\*.* ..\..\build\docs\html
+ copy xslt-resources\*.* ..\..\build\docs\html\resources
+</source>
+
+<p>The <code>make-xalan.bat</code> file to create a single web page:
+</p>
+<source>
+ ::
+ :: Set the current path to include a stylesheet transformation utility
+ ::
+ :: %1 The document filename (without extension) to transform
+ ::
+ :: %XALANEXSLT% The exslt stylesheet transformation utility
+ ::
+ :: %XALANSTYLE% The XSLT stylesheet to convert STYLEBOOK markup
+ ::
+ :: %XALANXMLDIR% Source directory of STYLEBOOK markup XML documents
+ ::
+ :: %XALANOUTDIR% Target directory of XHTML web page documents
+ ::
+ :: %WEBCREATED% Web Page Creation Date
+ ::
+ :: sectionid Top-level stylesheet parameter (document file id)
+ ::
+ :: createdate Top-level stylesheet parameter (web page creation date)
+ ::
+
+ SET WEBCREATED=%DATE%
+ SET XALANEXSLT=..\..\bin\xalan.exe
+ SET XALANSTYLE=xalan-book.xslt
+ SET XALANXMLDIR=xalan
+ SET XALANOUTDIR=..\..\build\docs\html
+
+ "%XALANEXSLT%" -p sectionid "'%1'" -p createdate "'%WEBCREATED%'" \
+ %XALANXMLDIR%\%1.xml %XALANSTYLE% >% XALANOUTDIR%\%1.html
+</source>
+</s3>
+</s2>
+
+<anchor name="buildapi"/>
+<s2 title="Building the Xalan-C API Reference">
+
+<p>This section shows how to build the Xalan-C/C++ application program interface (API) documents using the <jump href="http://www.doxygen.org">Doxygen</jump> and
+<jump href="http://www.graphviz.org">GraphViz</jump> programs. These required software packages are available for most Unix systems.
+</p>
+
+<anchor name="b_api_1"/>
+<s3 title="API Configuration Source Tree">
+
+<source>
+xalan/c/trunk/src/xalanc/ -- [*.h, *.hpp] source code files
+
+xalan/c/trunk/xdocs/
+ DoxyfileXalan -- The doxygen configuration file
+
+xalan/c/trunk/xdocs/html/apiDocs/
+ asf_logo_wide.gif -- The wide ASF trademark logo
+ footer.html -- The footer html fragment for copyright
+ header.html -- Header html fragment for document title
+ header-local.html -- Header html fragment for optional title
+</source>
+
+<p>Note: (ApacheLogo.jpg) is replaced with (asf_logo_wide.gif).
+</p>
+<p>Note: (diagramnotes.html) is replaced with (graph_legend.html) created by doxygen.
+</p>
+</s3>
+
+<anchor name="b_api_2"/>
+<s3 title="Destination Path for API Web Pages">
+
+<p>The Xalan-C/C++ API pages are constructed here.</p>
+<source>
+ xalan/c/trunk/build/docs/apiDocs/html
+</source>
+</s3>
+
+<anchor name="b_api_3"/>
+<s3 title="Build the API Web Pages">
+
+<p>You must have usable "doxygen" and "dot" programs in your path. The "dot" program is part of the GraphViz distribution.
+</p>
+<p>Connect to your development sources or SVN snapshot.<br/>
+<source>
+xalan/c/trunk/xdocs/
+</source>
+Run the doxygen (or doxywizard) program.<br/>
+<source>
+doxygen DoxyfileXalan 2>errors.log | tee doxygen.log
+</source>
+Examine the (errors.log) file for any fatal errors. Lots of warnings are ok.
+You can examine the constructed web pages with your favorite browser.<br/>
+<source>
+% cd xalan/c/trunk/build/docs/apiDocs/html
+% iceweasel index.html &
+</source>
+</p>
+</s3>
+</s2>
+
+<anchor name="integrateapi"/>
+<s2 title="Integrate API With Xalan-C Project Web Pages">
+
+<p>Copy the contents of <br/>
+<source>
+xalan/c/trunk/build/docs/apiDocs/html/*
+</source>
+to the Xalan-C Project Web Pages found at <br/>
+<source>xalan/c/trunk/build/docs/html/apiDocs/
+</source>
+Copy the trademark logo <br/>
+<source>
+xalan/c/trunk/xdocs/html/apiDocs/asf_logo_wide.gif
+</source>
+to its final resting place <br/>
+<source>
+xalan/c/trunk/build/docs/html/apiDocs/
+</source>
+</p>
+</s2>
+</s1>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xalan.apache.org
For additional commands, e-mail: commits-help@xalan.apache.org