From 4224dd0816348fd92bae70cd8f3a74b4fd49b679 Mon Sep 17 00:00:00 2001
From: Syd Bauman <s.bauman@northeastern.edu>
Date: Sun, 22 Oct 2023 22:26:47 -0400
Subject: [PATCH 1/3] Tweak README builder for TEI ticket 2070

---
 profiles/readme/html/to.xsl | 39 +++++++++++++++++++++++++++++++------
 1 file changed, 33 insertions(+), 6 deletions(-)

diff --git a/profiles/readme/html/to.xsl b/profiles/readme/html/to.xsl
index eaf2fd523..0aeb759d7 100644
--- a/profiles/readme/html/to.xsl
+++ b/profiles/readme/html/to.xsl
@@ -4,6 +4,7 @@
     xmlns:html="http://www.w3.org/1999/xhtml"
     xmlns:tei="http://www.tei-c.org/ns/1.0"
     xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+    xmlns:xs="http://www.w3.org/2001/XMLSchema"
     exclude-result-prefixes="#all"
     version="2.0">
     <!-- import base conversion style -->
@@ -60,36 +61,62 @@ of this software, even if advised of the possibility of such damage.</p>
       .../release/tei-p5-doc/share/doc/tei-p5-doc/
   -->
   <xsl:variable name="filename" select="tokenize( base-uri(/),'/')[last()]"/>
-  <xsl:param name="version" select="replace( $filename, '^readme-([0-9aαbβ.-]+)\.xml$','$1')"/>
+  <xsl:param name="version_from_filename" select="replace( $filename, '^readme-([0-9aαbβ.-]+)\.xml$','$1')"/>
   <xsl:param name="vault" select="'https://www.tei-c.org/Vault/P5'"/>
   <xsl:param name="docPath" select="'doc/tei-p5-doc/en/html'"/>
+  
+  <!--
+    The version # we grabbed from the filename might not have the patch level ".0" at the end.
+    But the Guidelines we are trying to point to always have it. So here if we find only major-
+    dot-minor (rather than major-dot-minor-dot-patch), we append a ".0".
+  -->
+  <xsl:variable name="version" as="xs:string">
+    <xsl:analyze-string select="$version_from_filename" regex="^([0-9]+\.[0-9]+)([aαbβ]?)$">
+      <xsl:matching-substring>
+        <xsl:sequence select="regex-group(1)||'.0'||regex-group(2)"/>
+      </xsl:matching-substring>
+      <xsl:non-matching-substring>
+        <xsl:sequence select="."/>
+      </xsl:non-matching-substring>
+    </xsl:analyze-string>
+  </xsl:variable>
+  <!-- $versionZero is true() iff the major number is '0'. -->
+  <xsl:variable name="versionZero" select="substring-before( $version, '.') eq '0'" as="xs:boolean"/>
   <xsl:variable name="testVersionedDocument" select="concat( $vault,'/',$version,'/VERSION')"/>
   <xsl:variable name="tagdocStart" select="concat( $vault,'/',$version,'/',$docPath,'/ref-')"/>
   
-  <xsl:template match="tei:gi|tei:ident[@type eq 'class']">
+  <xsl:template match="tei:gi | tei:name[ @type eq 'class']">
     <xsl:variable name="class" select="if (@type) then @type else local-name(.)"/>
     <!-- If this is the first one, check veresion number and warn iff needed -->
-    <xsl:if test="not( preceding::tei:gi | preceding::tei:ident[@type eq 'class'] )">
+    <xsl:if test="not( preceding::tei:gi | preceding::tei:name[ @type eq 'class'] )">
       <xsl:choose>
         <xsl:when test="$version eq ''">
           <xsl:message>WARNING: unable to parse version # from filename, so links will not work</xsl:message>
         </xsl:when>
         <xsl:when test="not( doc-available( $testVersionedDocument ) )">
-          <xsl:message>WARNING: file <xsl:value-of select="$testVersionedDocument"/> cannot be read, so links will probably be broken</xsl:message>
+          <xsl:message>INFO: file <xsl:value-of select="$testVersionedDocument"/> could not be read</xsl:message>
         </xsl:when>
         <xsl:when test="normalize-space( unparsed-text( $testVersionedDocument ) ) ne normalize-space( $version )">
           <xsl:message>WARNING: supplied version (<xsl:value-of select="$version"/>) is not equal to content of <xsl:value-of select="$testVersionedDocument"/>.</xsl:message>
         </xsl:when>
+        <xsl:when test="substring-before( $version, '.') eq '0'">
+          <xsl:message>INFO: version number is &lt; 1.0.0, so not generating links for element &amp; class names.</xsl:message>
+        </xsl:when>
       </xsl:choose>
     </xsl:if>
     <xsl:choose>
-      <xsl:when test="@scheme = ('TEI','tei') or not(@scheme)">
+      <!-- if this is prior to release 1.0.0, do not even bother trying to generate a link, just highlight it … -->
+      <xsl:when test="$versionZero">
+        <span class="{$class}"><xsl:apply-templates/></span>
+      </xsl:when>
+      <!-- else if it is a TEI element or class, make it into a link … -->
+      <xsl:when test="@scheme = ('TEI','tei') or not( @scheme )">
         <xsl:variable name="content" select="normalize-space(.)"/>
         <xsl:variable name="tagdoc" select="concat( $tagdocStart, $content, '.html' )"/>
         <a class="{$class}" href="{$tagdoc}"><xsl:apply-templates/></a>
       </xsl:when>
+      <!-- else this is not a TEI scheme element or identifier, also no link, just highlight it -->
       <xsl:otherwise>
-        <!-- This is not a TEI scheme element or identifier -->
         <span class="{$class}"><xsl:apply-templates/></span>
       </xsl:otherwise>
     </xsl:choose>

From 739d94b4c87b700d25375ba5ca5bcfd195838d47 Mon Sep 17 00:00:00 2001
From: Syd Bauman <s.bauman@northeastern.edu>
Date: Fri, 27 Oct 2023 15:29:35 -0400
Subject: [PATCH 2/3] tweak a comment

---
 profiles/readme/html/to.xsl | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/profiles/readme/html/to.xsl b/profiles/readme/html/to.xsl
index 0aeb759d7..d39aff335 100644
--- a/profiles/readme/html/to.xsl
+++ b/profiles/readme/html/to.xsl
@@ -115,7 +115,7 @@ of this software, even if advised of the possibility of such damage.</p>
         <xsl:variable name="tagdoc" select="concat( $tagdocStart, $content, '.html' )"/>
         <a class="{$class}" href="{$tagdoc}"><xsl:apply-templates/></a>
       </xsl:when>
-      <!-- else this is not a TEI scheme element or identifier, also no link, just highlight it -->
+      <!-- else this is not a TEI scheme element or name, also no link, just highlight it -->
       <xsl:otherwise>
         <span class="{$class}"><xsl:apply-templates/></span>
       </xsl:otherwise>

From d4b77e36b0a92cfecbe2a51949645cc211a0095d Mon Sep 17 00:00:00 2001
From: Syd Bauman <s.bauman@northeastern.edu>
Date: Sat, 28 Oct 2023 23:41:57 -0400
Subject: [PATCH 3/3] Simplify patching version number.

---
 profiles/readme/html/to.xsl | 12 ++----------
 1 file changed, 2 insertions(+), 10 deletions(-)

diff --git a/profiles/readme/html/to.xsl b/profiles/readme/html/to.xsl
index d39aff335..9fcd8a6e2 100644
--- a/profiles/readme/html/to.xsl
+++ b/profiles/readme/html/to.xsl
@@ -70,16 +70,8 @@ of this software, even if advised of the possibility of such damage.</p>
     But the Guidelines we are trying to point to always have it. So here if we find only major-
     dot-minor (rather than major-dot-minor-dot-patch), we append a ".0".
   -->
-  <xsl:variable name="version" as="xs:string">
-    <xsl:analyze-string select="$version_from_filename" regex="^([0-9]+\.[0-9]+)([aαbβ]?)$">
-      <xsl:matching-substring>
-        <xsl:sequence select="regex-group(1)||'.0'||regex-group(2)"/>
-      </xsl:matching-substring>
-      <xsl:non-matching-substring>
-        <xsl:sequence select="."/>
-      </xsl:non-matching-substring>
-    </xsl:analyze-string>
-  </xsl:variable>
+  <xsl:variable name="version" as="xs:string"
+                select="replace( $version_from_filename, '^([0-9]+\.[0-9]+)([aαbβ]?)$', '$1.0$2')"/>
   <!-- $versionZero is true() iff the major number is '0'. -->
   <xsl:variable name="versionZero" select="substring-before( $version, '.') eq '0'" as="xs:boolean"/>
   <xsl:variable name="testVersionedDocument" select="concat( $vault,'/',$version,'/VERSION')"/>