I now have a "stylebook.xslt" with added stylebook markup functionality in support of Apache Mirror Distribution. Here is a summary of the markup and its use.
mirrors.ent is a DTD validation file for the various general parameters and elements. It is included by reference in "markup.ent". The "stylebook.xslt" is a standard XSLT transform to create XHTML compatible web pages. The mirrors.xml file can use the following markup to easily compose pages for access to mirror artifacts and distribution protected validation files. &asfdist; = "http://www.apache.org/dist/" &asfarch; = "http://archive.apache.org/dist/" &asfsvn; = "https://svn.apache.org/repos/asf/" <asfmirror/> <!-- This element is a form to select another mirror --> <!-- Specify a grouping of package artifacts and their validators --> <packages location="relative asf distribution path"> <pkgfile validators="asc md5 sha">artifact filename</pkgfile> <keyfile>relative asf distribution path + filename</keyfile> </packages> Sincerely, Steven J. Hathaway -------------------------------------------------------------------- style/dtd/markup.ent ==================== <!-- import the asfmirror element --> <!ENTITY % externalAsfMirrors SYSTEM "mirrors.ent"> %externalAsfMirrors; style/dtd/mirrors.ent ===================== <!-- The <asfmirror> element causes the Stylebook.xslt to output the proper active comments to select a [preferred] mirror and gives the web user the opportunity to select another mirror. The entities &asfdist; &asfarch; &asfsvn; are shortcuts to three well-known ASF repository trees. --> <!ENTITY asfdist "http://www.apache.org/dist/"> <!ENTITY asfarch "http://archive.apache.org/dist/"> <!ENTITY asfsvn "https://svn.apache.org/repos/asf/"> <!ELEMENT asfmirror EMPTY> <!-- The <packages> element defines the distribution subdirectory. The <pkgfile> element defines the package artifact filename and validators. The <keyfile> element defines the relative path to the PGP keyfile. The path values are relative to the ASF distribution (asfdist). The following example shows a possible stylebook markup usage. <packages location="xalan/xalan-c/sources/"> <keyfile>xalan/xalan-c/KEYS</keyfile> <pkgfile> validators="asc md5 sha">release-file-name.gz</pkgfile> <pkgfile> validators="asc md5>next-release-file.zip</pkgfile> </packages> --> <!ELEMENT packages (pkgfile|keyfile)*> <!ATTLIST packages location CDATA #REQUIRED> <!ELEMENT pkgfile (#PCDATA)> <!ATTLIST pkgfile validators NMTOKENS #IMPLIED> <!ELEMENT keyfile (#PCDATA)> mirrors.cgi =========== #!/bin/sh # Wrapper script around mirrors.cgi script for ASF infra support for mirrors. # (We must change directories in order for python to pick up the includes) # Original: Stefan's page on mirrors cd /www/www.apache.org/dyn/mirrors /www/www.apache.org/dyn/mirrors/mirrors.cgi $* mirrors.xml =========== SAMPLE <p>This page is currently associated with the <em>[preferred]</em> mirror. If you encounter a problem with this mirror, please select another mirror. If all mirrors are failing, there are <em>backup</em> mirrors (at the end of the mirrors list) that should be available. </p> <asfmirror/> <p>You can get the <jump href="http://www.apache.org/dist/xalan/xalan-c/KEYS">PGP KEYS</jump> from our master distribution directory. The PGP validation KEY files are no longer available on the mirrors. </p> <s3 title="Source Packages"> <p>We are distributing the source package for the Xalan-C/C++ library, sample programs, and documentation. The source package has the StyleBook XML sources for the web pages and a Doxygen configuration file to construct the API Reference. </p> <packages name="xalan/xalan-c/sources/"> <pkgfile validators="asc md5 sha">Xalan-C-1.11.1.source.tar.gz</pkgfile> <pkgfile validators="asc md5 sha">Xalan-C-1.11.1.source.zip</pkgfile> <keyfile>xalan/xalan-c/KEYS</keyfile> </packages> </s3> <s3 title="Documentation Packages"> <p>We are distributing a package of html web pages for the User Guide and interactive API Reference. The documentation package describes how to build and use the library for Windows and UNIX platforms. </p> <packages name="xalan/xalan-c/docs/"> <pkgfile validators="asc md5 sha">Xalan-C-1.11.1.docs-html.tar.gz</pkgfile> <pkgfile validators="asc md5 sha">Xalan-C-1.11.1.docs-html.zip</pkgfile> <pkgfile validators="asc md5 sha">Xalan-C-1.11.1.docs-api.tar.gz</pkgfile> <pkgfile validators="asc md5 sha">Xalan-C-1.11.1.docs-api.zip</pkgfile> <keyfile>xalan/xalan-c/KEYS</keyfile> </packages> </s3> stylebook.xslt ============== https://svn.apache.org/repos/asf/xalan/c/branches/XalanDocs/xalan/c/trunk/xdocs/sources/stylebook.xslt mirrors.html ============ SAMPLE <?xml version="1.0" encoding="UTF-8" standalone="no"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html> <head> <title>ASF: Downloading Xalan-C++</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" /> </head> <!-- --> <div id="content"> <h2>Downloading Xalan-C++</h2> <a name="download">‌</a> <!-- --> <p>This page is currently associated with the <b>[preferred]</b> mirror. If you encounter a problem with this mirror, please select another mirror. If all mirrors are failing, there are <b>backup</b> mirrors (at the end of the mirrors list) that should be available. </p> <a name="SelectMirror">‌</a> <form action="[location]" method="get" id="SelectMirror">Other Mirrors: <select name="Preferred"> <!--[if-any http] [for http]--> <option value="[http]">[http]</option> <!--[end] [end]--> <!--[if-any ftp] [for ftp]--> <option value="[ftp]">[ftp]</option> <!--[end] [end]--> <!--[if-any backup] [for backup]--> <option value="[backup]">[backup] (backup)</option> <!--[end] [end]--> </select> <input type="submit" value="Change" /> </form> <p>You can get the <a href="http://www.apache.org/dist/xalan/xalan-c/KEYS">PGP KEYS</a> from our master distribution directory. The PGP validation KEY files are no longer available on the mirrors. </p> <p align="right" size="2"> <a href="#content">(top)</a> </p> <h4>Source Packages</h4> <p>We are distributing the source package for the Xalan-C/C++ library, sample programs, and documentation. The source package has the StyleBook XML sources for the web pages and a Doxygen configuration file to construct the API Reference. </p> <ul> <li> <a href="[preferred]/Xalan-C-1.11.1.source.tar.gz">Xalan-C-1.11.1.source.tar.gz</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.source.tar.gz.asc">[PGP]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.source.tar.gz.md5">[MD5]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.source.tar.gz.sha">[SHA]</a> </li> <li> <a href="[preferred]/Xalan-C-1.11.1.source.zip">Xalan-C-1.11.1.source.zip</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.source.zip.asc">[PGP]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.source.zip.md5">[MD5]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.source.zip.sha">[SHA]</a> </li> <li>Package Validation <a href="http://www.apache.org/dist/xalan/xalan-c/KEYS">[KEYS]</a> </li> </ul> <p align="right" size="2"> <a href="#content">(top)</a> </p> <h4>Documentation Packages</h4> <p>We are distributing a package of html web pages for the User Guide and interactive API Reference. The documentation package describes how to build and use the library for Windows and UNIX platforms. </p> <ul> <li> <a href="[preferred]/Xalan-C-1.11.1.docs-html.tar.gz">Xalan-C-1.11.1.docs-html.tar.gz</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.docs-html.tar.gz.asc">[PGP]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.docs-html.tar.gz.md5">[MD5]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.docs-html.tar.gz.sha">[SHA]</a> </li> <li> <a href="[preferred]/Xalan-C-1.11.1.docs-html.zip">Xalan-C-1.11.1.docs-html.zip</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.docs-html.zip.asc">[PGP]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.docs-html.zip.md5">[MD5]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.docs-html.zip.sha">[SHA]</a> </li> <li> <a href="[preferred]/Xalan-C-1.11.1.docs-api.tar.gz">Xalan-C-1.11.1.docs-api.tar.gz</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.docs-api.tar.gz.asc">[PGP]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.docs-api.tar.gz.md5">[MD5]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.docs-api.tar.gz.sha">[SHA]</a> </li> <li> <a href="[preferred]/Xalan-C-1.11.1.docs-api.zip">Xalan-C-1.11.1.docs-api.zip</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.docs-api.zip.asc">[PGP]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.docs-api.zip.md5">[MD5]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.docs-api.zip.sha">[SHA]</a> </li> <li>Package Validation <a href="http://www.apache.org/dist/xalan/xalan-c/KEYS">[KEYS]</a> </li> </ul> <p align="right" size="2"> <a href="#content">(top)</a> </p> <h4>Binary Packages</h4> <p>We are distributing compiled binary packages for several platforms. The Xalan-C/C++ documentation is provided as a separate package. We would like to distribute binary packages for platforms that have compiled Xerces-C/C++ distribution support. </p> <p>The following 32-bit binary packages are available for distribution.</p> <ul> <li> <a href="[preferred]/Xalan-C-1.11.1.windows-x86-vc71.zip">Xalan-C-1.11.1.windows-x86-vc71.zip</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86-vc71.zip.asc">[PGP]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86-vc71.zip.md5">[MD5]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86-vc71.zip.sha">[SHA]</a> </li> <li> <a href="[preferred]/Xalan-C-1.11.1.windows-x86-vc8.zip">Xalan-C-1.11.1.windows-x86-vc8.zip</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86-vc8.zip.asc">[PGP]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86-vc8.zip.md5">[MD5]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86-vc8.zip.sha">[SHA]</a> </li> <li> <a href="[preferred]/Xalan-C-1.11.1.windows-x86-vc9.zip">Xalan-C-1.11.1.windows-x86-vc9.zip</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86-vc9.zip.asc">[PGP]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86-vc9.zip.md5">[MD5]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86-vc9.zip.sha">[SHA]</a> </li> <li> <a href="[preferred]/Xalan-C-1.11.1.windows-x86-vc10.zip">Xalan-C-1.11.1.windows-x86-vc10.zip</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86-vc10.zip.asc">[PGP]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86-vc10.zip.md5">[MD5]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86-vc10.zip.sha">[SHA]</a> </li> <li> <a href="[preferred]/Xalan-C-1.11.1.windows-x86-vc11.zip">Xalan-C-1.11.1.windows-x86-vc11.zip</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86-vc11.zip.asc">[PGP]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86-vc11.zip.md5">[MD5]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86-vc11.zip.sha">[SHA]</a> </li> <li>Package Validation <a href="http://www.apache.org/dist/xalan/xalan-c/KEYS">[KEYS]</a> </li> </ul> <p> The following 64-bit binary packages are available for distribution.</p> <ul> <li> <a href="[preferred]/Xalan-C-1.11.1.windows-x86_64-vc8.zip">Xalan-C-1.11.1.windows-x86_64-vc8.zip</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86_64-vc8.zip.asc">[PGP]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86_64-vc8.zip.md5">[MD5]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86_64-vc8.zip.sha">[SHA]</a> </li> <li> <a href="[preferred]/Xalan-C-1.11.1.windows-x86_64-vc9.zip">Xalan-C-1.11.1.windows-x86_64-vc9.zip</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86_64-vc9.zip.asc">[PGP]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86_64-vc9.zip.md5">[MD5]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86_64-vc9.zip.sha">[SHA]</a> </li> <li> <a href="[preferred]/Xalan-C-1.11.1.windows-x86_64-vc10.zip">Xalan-C-1.11.1.windows-x86_64-vc10.zip</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86_64-vc10.zip.asc">[PGP]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86_64-vc10.zip.md5">[MD5]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86_64-vc10.zip.sha">[SHA]</a> </li> <li> <a href="[preferred]/Xalan-C-1.11.1.windows-x86_64-vc11.zip">Xalan-C-1.11.1.windows-x86_64-vc11.zip</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86_64-vc11.zip.asc">[PGP]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86_64-vc11.zip.md5">[MD5]</a> <a href="http://www.apache.org/dist/Xalan-C-1.11.1.windows-x86_64-vc11.zip.sha">[SHA]</a> </li> <li>Package Validation <a href="http://www.apache.org/dist/xalan/xalan-c/KEYS">[KEYS]</a> </li> </ul> <p>We currently have no one committed to release UNIX and Linux binary packages. If you have scripts to build these packages, your help would be appreciated. You can contribute by posting your comments to the <a href="mailto:[email protected]">xalan-dev</a> mailing list. </p> <!-- --> </div> </body> </html> --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
