01/09/17

Permalink 02:15:39 pm, by mholmes, 349 words, 15 views   English (CA)
Categories: Academic; Mins. worked: 180

XHTML 5, vnu and validation

Today I worked through a stack of issues in building and validating the site, and I now have some recommendations and insights worth recording.

First, I determined that vnu was parsing our documents as HTML because they had the .html extension. The HTML parser does a bunch of pre-validation things (like lower-casing custom data attributes) which we would prefer to avoid. I also discovered that using the XHTML output method in Saxon was paradoxically adding a meta tag to the header specifying content type as text/html, which was also pushing vnu into treating the documents as HTML rather than XHTML. Solutions:

  1. Use this for the xsl:output element:
    <xsl:output method="xhtml" include-content-type="no" encoding="UTF-8" omit-xml-declaration="yes"
        exclude-result-prefixes="#all" normalization-form="NFC"/>
    
    The method attribute gives you correct results in terms of not producing things like self-closed empty div tags. The include-content-type="no" value suppresses the unwanted meta tag with the wrong content type.
  2. Do the HTML5 doctype like this:
    <xsl:text disable-output-escaping="yes"><!DOCTYPE html>
        </xsl:text>
    
    It's ugly but it works.
  3. Always include the charset meta tag:
    <meta charset="UTF-8"/>
    
  4. Before validating, copy only the HTML files to a fresh empty directory and validate them there. This is because of what is explained below.
  5. For validation using vnu.jar, use this command-line setting:
    -Dnu.validator.client.content-type=application/xhtml+xml
    
    In an ant task, it looks like this:
       <java jar="utilities/vnu/vnu.jar" failonerror="true" fork="true">
          <arg value="-Dnu.validator.client.content-type=application/xhtml+xml"/>
          <arg value="--format text"/>
          <arg value="--skip-non-html"/>
          <arg value="tmpValidation/"/>
        </java>
    
    The problem is that when you set the content type as in the first argument, the --skip-non-html flag no longer seems to work; it sets about validating every jpeg and javascript file in the tree. I think this must be a vnu bug, but I haven't tested thoroughly yet.

Following these steps should produce good XHTML5 (assuming your XSLT is right) and validate it as XHTML.

15/08/17

Permalink 09:01:29 am, by mholmes, 49 words, 15 views   English (CA)
Categories: Activity log; Mins. worked: 30

Problem with Sonnet 1609

Somehow the 1609 Sonnet file got completely trashed sometime in July; it's as if huge blocks of the XML were moved around randomly, with no attention paid to the hierarchy, and it's now completely invalid. It looks unfixable to me. CC agreed on resetting to the last known good rev 1770.

07/07/17

Permalink 12:50:07 pm, by mholmes, 22 words, 21 views   English (CA)
Categories: Activity log; Mins. worked: 30

eXist xar rebuilt and deployed

Just to bring it up to date. Noticed that eXide seems to be broken on Chromium. Seems to work OK on FF.

06/07/17

Permalink 03:47:52 pm, by mholmes, 60 words, 21 views   English (CA)
Categories: Activity log; Mins. worked: 120

EC now working on XML/svn; tweaking to Ville-Thierry

Got EC set up and working with svn, and doing basic linking from the VT doc to the references. Worked with CC to do a bunch of layout fixes for the VT text, which is looking a lot better; we found a block of badly-encoded rubbish right at the end, though, which we started on, and which CC will finish.

05/07/17

Permalink 04:48:21 pm, by mholmes, 69 words, 18 views   English (CA)
Categories: Activity log; Mins. worked: 360

Layout tweaks and fixes

CC provided a list of rendering issues in a lot of documents, which I've worked through. In the process, I've fixed some XSLT and CSS, abstracted some rendering rules into rendition elements for the longer documents, and done a lot of clean-up. All reported problems are I think fixed, but there are more to come. There's also more rationalization of styles that could be done on Espines and Maladies.

04/07/17

Permalink 05:30:12 pm, by mholmes, 57 words, 18 views   English (CA)
Categories: Activity log; Mins. worked: 300

Lots of progress on primary source and normalization

Added handlers for marginal labels in the normalized text (they show up always on the left, leaving the page numbers unencumbered on the right). Standardized all the marg labels in the Ville Thierry, and fixed a bunch of issues with untyped fws in Le Bon Mariage. Tested a freshly-built version of the site in the brand-new eXist 3.3.

30/06/17

Permalink 02:26:00 pm, by mholmes, 45 words, 16 views   English (CA)
Categories: Academic; Mins. worked: 90

EC starts, bugfix for refs, discussion on release

Got EC set up and working on names/refs; next week we'll start in on XML with her. Discussed the possible release schedule (next week?) with CC; we need a visible "beta" label first. Fixed a bug in sorting of references (articles not being ignored).

23/06/17

Permalink 02:56:35 pm, by mholmes, 19 words, 20 views   English (CA)
Categories: Activity log; Mins. worked: 45

Welcomed new team member

EC is joining the team. Set up access to svn, and a time/place for initial training next week.

05/06/17

Permalink 01:32:15 pm, by mholmes, 41 words, 21 views   English (CA)
Categories: Activity log; Mins. worked: 120

Fixes for style issues in Le Bon Mariage

Using the real copy of Le Bon Mariage, I've checked the TOCs I created and made some adjustments, as well as fixing a pile of other style problems with marginal labels and forme works. That one is looking pretty good now.

01/06/17

Permalink 03:16:19 pm, by mholmes, 48 words, 19 views   English (CA)
Categories: Activity log; Mins. worked: 120

Legacy URLs handled; svn info now in footer

Mariage didn't have any handling for the legacy URLs of documents which have been out in the wild for a decade. I've now fixed that, with a redirect.xql modelled on the Scancan one. I've also incorporated the same detailed SVN info into the footer that MoEML has.

:: Next Page >>

Mariage

Faut-il se marier? La question de Panurge s’avère incontournable en Occident, surtout à partir de la contre-réforme. Des débuts de la Concile de Trente en 1545 jusqu’à la fin du règne de Louis XIV, la tentative de renouveler le mariage se heurte en France à l’intervention croissante de la monarchie dans cette institution dominée auparavent par l’Église. La rencontre entre ces deux autorités fut tumultueuse mais propice au foisonnement des documents qui font l’objet de ce site : « l’imaginaire nuptial » se compose de divers genres textuels, chacun ayant son caractère propre, mais tous traitant des peurs, des désirs et des fantasmes de plus en plus visibles dans la société d’Ancien Régime grâce aux débats soulevés par la nouvelle problématique de l’union conjugale. L’accent pour le moment est sur les textes et images misogames qui font partie d’un renouveau de la Querelle des femmes pendant les 25 premières années du XVIIe siècle.

Reports

XML Feeds