xalan-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From shath...@e-z.net
Subject Stylebook Markup - XalanDocs
Date Tue, 24 Dec 2013 01:56:15 GMT
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">&#8204;</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">&#8204;</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:dev@xalan.apache.org">xalan-dev</a> mailing list.
</p>

<!-- -->
</div>
</body>
</html>



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@xalan.apache.org
For additional commands, e-mail: dev-help@xalan.apache.org


Mime
View raw message