Gareth,
Thanks for your comments and review!
Your comments and suggestions are appreciated. Constructive
criticism is always welcome.
If you have used the XALAN-J command-line utility, I would appreciate
information to integrate into the documentation toolkit.
My work is currently using Windows and batch files. I plan to have
an XSLT stylesheet that will automatically create usable Windows (bat)
files and UNIX (sh) script files that can be executed to create project
web pages.
The XALAN PMC is in need of a documentation face-lift to accommodate
the Apache Software Foundation project branding requirements. The
sample web site documentation, available on JIRA is my submission
for review and comment. I wish to comply with the ASF branding
requirements.
The Documentation Toolkit
https://issues.apache.org/jira/browse/XALANC-712
Proposed Xalan Logos (TM)
https://issues.apache.org/jira/browse/XALANC-714
The work is still dynamic. My documentation efforts are posted to JIRA.
After some review, I plan to commit the documentation developers
toolkit to SVN repository branches of xalan. If proven useful, the
toolkit will replace the old Java StyleBook dependency. The toolkit
currently works with the StyleBook XML markup without any Java
StyleBook runtime requirements.
My goal is to have usable web pages that automatically re-size to
browser windows on small-screen tablets and large-format workstations.
https://issues.apache.org/jira/browse/XALANC-712
readme-20110902.txt
build-xalan-docs-20110902.zip = the constructed web pages
build/docs/xalan = http://xalan.apache.org
build/docs/xalan/xalan-c = http://xml.apache.org/xalan-c
build/docs/xalan/xalan-j = http://xml.apache.org/xalan-j
xdocs-xalan-docs-20110902.zip = the documentation toolkit
xalan/java/trunk/xdocs/sources = the merged documentation sources
make-all-sites.bat = builds all three web sites
(except for API pages requiring doxygen et.al.)
bin-win32-20110902.zip = the command-line executable
The Xalan-C documentation project for http://xml.apache.org/xalan-c
is my primary focus, getting ready for a version 1.11 release.
I am still fine-tuning the "stylebook.xslt" used to generate the
new look-and-feel web pages, and the apache-xalan.css used by
browsers to render the web pages.
The following is already available, but not yet posted.
1. Use logos with (TM) identifiers (See JIRA XALANC-714)
2. Simulate the header buttons found on the xml.apache.org/* web pages.
3. Use logos of various sizes and provide size indicators as
top-level parameters to the stylebook.xslt for <div name=title>
construction.
To Do: (What I am working on)
1. Prepare an XSLT that will generate Windows (.bat) files and
UNIX (.sh) files to automatically construct web pages from
the XALAN StyleBook XML markup.
2. Edit the stylebook.xslt to accommodate the <group> element
as a child of <book> in a manner illustrated by the web page:
http://xerces.apache.org/xerces-c
With separate navigation for two distribution versions.
3. Prepare and publish a documentors style guide. Many of my
style guide notes are already available, but the tools are
not yet stable.
The web pages published by Xerces and Xalan have features that
are not supported by the old Java StyleBook (DTD) validations.
Xalan-C Documentation Validation
I could use some input regarding Xerces-C transcoding modules from
version 3.1.1 and their impact on Xalan-C version 1.11. Can the IBM
ICU be used for transcoding modules in Xerces-C version 3.1.1?
The use of IBM ICU for internationalization is supported for Xerces-C
version 2.8 and is reflected in the current documentation.
Sincerely,
Steven J. Hathaway
On 9/5/2011 12:47 AM, Gareth Reakes wrote:
Hey,
Great progress Steven. Is there anything you would like me to do to
check these?
Cheers,
Gareth
On 3 Sep 2011, at 20:33, shath...@e-z.net wrote:
Xalan PMC
The JIRA XALANC-712 has a toolkit for Windows 32-bit that I use
to evaluate the documentation efforts for the three XALAN
web sites.
See the attached files:
bin-win32-20110902.zip
build-xalan-docs-20110902.zip
xdocs-xalan-docs-20110902.zip
and the manifest (also copied with this email):
readme-20110902.txt
The current postings also have a merge of all three web sites
and scripts that will automate the build of the web sites
except for some of the API documentation (i.e. doxygen based).
Sincerely,
Steven J. Hathaway
---------------------------------------------------------------------
To unsubscribe, e-mail: xalan-dev-unsubscr...@xml.apache.org
For additional commands, e-mail: xalan-dev-h...@xml.apache.org
