Only working task so far is to generate a preview version of a
given article.

Some of the parameters defined in template_article.xsl already had
fallback values in imported stylesheets.

head.xsl can take an optional $assets-path.

The XSLT now passes parameters onto template_article.xsl, and
generates a mapping between source and static article directories.

Fix bug in head.xsl: when multiple <title>s are provided, only the
first is used.

The resulting build file is hard to read, but would hopefully make
the Ant tasks usable on Windows machines.

Since the xmlresolver JAR needs to be loaded when Ant starts up,
the new target tests for the required Java class and, if it's not
available, provides instructions for running Ant with the JAR. The
new task is a dependency for the targets which use Saxon HE.

Files are copied into the static site directory and static HTML is
wrapped in DHQ trappings.

When restored, `generateSite` will try to find a derived build file
"article-mapper.xml" which maps article directories from their
source to the expected web directories.

The new task is intended to create a standalone HTML preview of an
article, which can be sent to the article's author(s) for proofing.

Default Ant task is back to 'previewArticle'

To reduce confusion and duplication, "toDir.base" now refers to the
path to the "dhq-static" directory, which contains a directory of
static files AND the derived Ant file AND the compressed ZIP.
"toDir.static" refers more specifically to the directory of static
files within toDir.base.

Also, added an XSL message to show progress through the TOC.

…works EXCEPT that we have not generated the individual volume/issue index pages yet.

… Ash

… it does more than just articles

…generation to a function which cleverly generates a map entry)

With this change, article resources will be copied to all relevant
issue directories within the static site dir.

Copying article XML is now done by Ant rather than through the XSLT.

… Project staticSearch system

…umanities-Quarterly/dhq-journal into static_site_generation

Also, remove references to the "dir-separator" XSLT parameter, since
it isn't necessary for the stylesheet to know.

We found that the XSLT generating static HTML from the TOC is
sufficiently insulated from Windows-specific directory separators.

Personally, I think it makes more sense to store the XML in the same
directory as the article HTML. However, DHQ's links require the XML
to be in the issue directory instead.

Added `dhq:set-up-issue-transformation()` to reduce duplication and
hard-to-read variables in the template for <journal>.

The static site generation XSLT now checks for <dhq:revisionNote>
and tries to transform the previous version of the article. Not
sure yet what happens when there is more than one revision to an
article, however.

Now the Ant build file created by generate_static_issues.xsl also
includes a target for zipping up only those articles which can be
considered stable. The ZIP is stored at data/dhq-xml.zip and is
referenced by the DHQ About page.

 * Change hierarchy of common/lib/ directory to match what Saxon expects.
 * Update to Saxon 12.4.

…nge_library

Re-arrange library, updating to Saxon 12

…umanities-Quarterly/dhq-journal into static_site_generation

It seems that the preview index links to the articles in their
usual place, so there's no need to copy the article HTML to another
directory.

Also added a new template "transform-with-sorting" in order to
reduce redundancy when producing an HTML page requires two
transformations. The new template is not yet back-ported to older
instances of this pattern.

Currently includes placeholder explanations of different article recommendation approaches.

Expanded description of keywording approach

Added finalized language describing each recommendation method

…dhq-recs/

…umanities-Quarterly/dhq-journal into static_site_generation

…en <a> tag on documentation out to explore.html

The error pages are generated using the fallback logic in
template_article.xsl, just as Cocoon does it. However, I've edited
the XSLT because it will not be able to dynamically report what URL
the user tried to access.

…fit new tsv format

head.xsl introduces special CSS rules for the preview site, and
topnavigation.xsl adds a "Preview" to the header. A new parameter,
"previewable", determines whether these are added to the HTML
output.

Also, fixed the alt text for the banner and DHQ logos.

generate_static_issues.xsl now includes and passes on the
"doProofing" parameter when generating HTML for articles in the
TOC. The XSLT does not yet transform the "editorial" articles.