tth-ivoa.xslt

<?xml version="1.0"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  xmlns="http://www.w3.org/1999/xhtml"
  version="1.0">

  <!-- The parameter docbase is the location where the final document
       will be served from.  This is computed in the Makefile (and
       can be overridden by setting DOCREPO_BASEURL -->
  <xsl:param name='docbase' select="''"/>

  <xsl:param name="CSS_HREF" select="''"/>

  <xsl:output method="xml" encoding="utf-8"/>
  <xsl:output cdata-section-elements="pre"/>

  <xsl:template match="*">
    <xsl:copy>
      <xsl:apply-templates select="*|@*|text()"/>
    </xsl:copy>
  </xsl:template>

  <xsl:template match="@*">
    <xsl:copy/>
  </xsl:template>

  <xsl:template match="head">
    <xsl:copy>
      <title><xsl:value-of select="//h1[1]"/></title>
      <xsl:element name="link">
        <xsl:attribute name="rel">stylesheet</xsl:attribute>
        <xsl:attribute name="type">text/css</xsl:attribute>
        <xsl:attribute name="href">
          <xsl:value-of select="$CSS_HREF"/>
        </xsl:attribute>
      </xsl:element>
      <xsl:call-template name="selectDoctypeStyle"/>

      <xsl:apply-templates select="//span[@class='customcss']"/>

      <style type="text/css">
        <xsl:text disable-output-escaping="yes">
        div#versionstatement, div#dateline {
          color: #005A9C;
          font-size: 150%;
        }

        p.parsep {
          overflow: hidden;
          height: 0pt;
          margin-top:0.5ex;
          margin-bottom:0.5ex;
        }

        div.generated {
          padding-left: 5mm;
          border-left: 4pt solid #dddddd;
        }

        div.admonition {
          width: 38%;
          position: relative;
          float: right;
          background-color: #dddddd;
          font-size: 80%;
          margin: 1ex;
          padding: 3pt;
          overflow: auto;
        }

        p.admonition-type {
          background-color: #444444;
          color: #ffffff;
          margin-top: 0px;
          padding-left: 5pt;
          padding-top: 5pt;
          padding-bottom: 5pt;
          font-weight: bold;
        }

        a.tth_citation, a.tth_citeref {
          color: #002A5C;
          text-decoration: none;
        }

        .xmlel {
          font-family: monospace;
          font-style: italic;
        }

        .vorent {
          font-variant: small-caps;
        }

        table {
          border-collapse: collapse;
          border-spacing: 0px;
        }

        table.tabular {
          margin-top: 2ex;
          margin-bottom: 1ex;
          margin-left: 0.5em;
        }

        table.tabular > * > tr > td, table.tabular > tr > td {
          border-top: 1pt solid gray;
          border-bottom: 1pt solid gray;
          padding: 2pt;
        }

        dt {
          margin-top: 0.5ex;
        }

        .redaction {
          background-color: #ffff33;
        }

        span.nolinkurl {
          font-family: monospace;
        }

        .basicstyle__footnotesize {
          font-size: 80%;
        }

        pre {
            counter-reset: pre_line;
        }

        pre span {
            counter-increment: pre_line;
        }

        div.numbers_left pre span:before {
            content: counter(pre_line);
            text-align: right;
            user-select: none;
            min-width: 1.5em;
            display: inline-block;
            padding-right: 1em;
        }

        img.archdiag {
          display: block;
          width: 90%;
          margin-left: auto;
          margin-right: auto;
          max-width: 19cm;
        }

        ul.authors, ul.previousversions, ul.editors {
          list-style-type: none;
          padding-left: 0pt;
          margin-top: 2pt;
          margin-bottom: 2pt;
        }

        div.caption {
          font-style: italic;
          margin-top: 3mm;
          margin-bottom: 6mm;
        }

        body div {
          max-width: 21cm;
        }
      </xsl:text></style>

      <xsl:apply-templates/>
    </xsl:copy>
  </xsl:template>

  <xsl:template match="div[@id='titlepage']">
    <xsl:copy>
      <table cellspacing="0" cellpadding="0" width="450">
      <tr>
        <td><a href="https://www.ivoa.net/"><img height="169" alt="IVOA" src="https://www.ivoa.net/icons/IVOA_wb_300.jpg" width="300" border="0"/></a></td>
        <td>
        <div style="padding: 3.6pt 7.2pt;">
        <p><b><i><span style="font-size: 14pt; color: rgb(0, 90, 156);"><span>&#xa0;</span>I</span></i></b><i><span style="font-size: 14pt; color: rgb(0, 90, 156);">nternational</span></i></p>
        <p><b><i><span style="font-size: 14pt; color: rgb(0, 90, 156);"><span>&#xa0;&#xa0;&#xa0;</span>V</span></i></b><i><span style="font-size: 14pt; color: rgb(0, 90, 156);">irtual</span></i></p>
        <p><b><i><span style="font-size: 14pt; color: rgb(0, 90, 156);"><span>&#xa0;</span><span>&#xa0;&#xa0;</span>O</span></i></b><i><span style="font-size: 14pt; color: rgb(0, 90, 156);">bservatory</span></i></p>
        <p><b><i><span style="font-size: 14pt; color: rgb(0, 90, 156);">A</span></i></b><i><span style="font-size: 14pt; color: rgb(0, 90, 156);">lliance</span></i><i>
        </i></p>
        </div>
        <i></i></td>
      </tr>
      </table>
      <br/>
    </xsl:copy>

    <h1><xsl:value-of select="h1[@align='center']"/></h1>
    <div id="versionstatement">
      Version <xsl:value-of select="span[@id='version']"/>
    </div>
    <div id="dateline">
      <xsl:apply-templates select="span[@id='doctype']" mode="humanreadable"/>
      <xsl:text> </xsl:text>
      <xsl:apply-templates select="span[@id='docdate']"/>
    </div>
    <dl id="docmeta">

      <xsl:apply-templates select="dd[@id='ivoagroup']"/>

      <dt>This Version</dt>
      <dd>
        <xsl:call-template name="currentlink"/>
      </dd>

      <dt>Latest Version</dt>
      <dd>
        <xsl:call-template name="latestlink"/>
      </dd>

      <dt>Previous Versions</dt>
      <dd>
        <ul class="previousversions">
          <xsl:apply-templates select="li[@class='previousversion']"/>
        </ul>
      </dd>

      <dt>Author(s)</dt>
      <dd>
        <ul class="authors">
          <xsl:apply-templates select="li[@class='author']"/>
        </ul>
      </dd>

      <dt>Editor(s)</dt>
                        <dd>
        <ul class="editors">
          <xsl:apply-templates select="li[@class='editor']"/>
        </ul>
      </dd>

      <xsl:if test="span[@id='vcsRev']">
        <dt>Version Control</dt>
        <dd>Revision <xsl:value-of select="span[@id='vcsRev']"
          /><xsl:if test="span[@id='vcsDate']">, last change
            <xsl:value-of select="span[@id='vcsDate']"/>
        </xsl:if>
        <xsl:if test="span[@id='vcsURL']"><br/>
          <a>
            <xsl:attribute name="href">
              <xsl:value-of select="span[@id='vcsURL']"/>
            </xsl:attribute>Source file in VCS</a>
        </xsl:if>
        </dd>
      </xsl:if>
    </dl>
  </xsl:template>

  <xsl:template match="a/@name">
    <xsl:if test="not(starts-with(., 'CITE'))">
      <xsl:copy/>
    </xsl:if>
  </xsl:template>

  <xsl:template match="a/@href">
    <xsl:if test="not(starts-with(., '#CITE'))">
      <xsl:copy/>
    </xsl:if>
  </xsl:template>

  <xsl:template match="style[./@type='text/css']">
  </xsl:template>

  <xsl:template match="span[@class='customcss']">
    <link type="text/css" rel="stylesheet">
      <xsl:attribute name="href"><xsl:value-of select="@ref"/></xsl:attribute>
    </link>
  </xsl:template>

  <xsl:template match="dd/div[./@class='p']">
  </xsl:template>

  <xsl:template match="span[@id='doctype']" mode="humanreadable">
    <xsl:variable name="doctype" select="."/>
    <xsl:choose>
      <xsl:when test="$doctype='WD'">
        <xsl:text>IVOA Working Draft </xsl:text>
      </xsl:when>
      <xsl:when test="$doctype='PR'">
        <xsl:text>IVOA Proposed Recommendation </xsl:text>
      </xsl:when>
      <xsl:when test="$doctype='REC'">
        <xsl:text>IVOA Recommendation </xsl:text>
      </xsl:when>
      <xsl:when test="$doctype='NOTE'">
        <xsl:text>IVOA Note </xsl:text>
      </xsl:when>
      <xsl:when test="$doctype='PEN'">
         <xsl:text>Proposed Endorsed Note </xsl:text>
      </xsl:when>
      <xsl:when test="$doctype='EN'">
         <xsl:text>Endorsed Note </xsl:text>
      </xsl:when>
      <xsl:otherwise>
        <xsl:message terminate='yes'>doctype must be one of
                  WD, PR, REC, NOTE, EN, PEN not
                  '<xsl:value-of select="$doctype"/>'</xsl:message>
      </xsl:otherwise>
    </xsl:choose>
  </xsl:template>

  <xsl:template match="div[@id='statusOfThisDocument']">
    <xsl:variable name="doctype" select="."/>
      <p id="statusdecl"><em>
          <xsl:choose>
              <xsl:when test="$doctype='NOTE'">
                  This is an IVOA Note expressing suggestions from and
                  opinions of the authors. It is intended to share best
                  practices, possible approaches, or other perspectives on
                  interoperability with the Virtual Observatory. It should
                  not be referenced or otherwise interpreted as a standard
                  specification.
              </xsl:when>
              <xsl:when test="$doctype='WD'">
                  This is an IVOA Working Draft for review by IVOA members
                  and other interested parties.  It is a draft document and
                  may be updated, replaced, or obsoleted by other documents
                  at any time. It is inappropriate to use IVOA Working Drafts
                  as reference materials or to cite them as other than "work
                  in progress".
              </xsl:when>
              <xsl:when test="$doctype='PR'">
                  This is an IVOA Proposed Recommendation made available for
                  public review. It is appropriate to reference this document
                  only as a recommended standard that is under review and
                  which may be changed before it is accepted as a full
                  Recommendation.
              </xsl:when>
              <xsl:when test="$doctype='REC'">
                  This document has been reviewed by IVOA Members and other
                  interested parties, and has been endorsed by the IVOA
                  Executive Committee as an IVOA Recommendation. It is a
                  stable document and may be used as reference material or
                  cited as a normative reference from another document.
                  IVOA's role in making the Recommendation is to draw
                  attention to the specification and to promote its
                  widespread deployment. This enhances the functionality and
                  interoperability inside the Astronomical Community.
              </xsl:when>
              <xsl:when test="$doctype='PEN'">
                This is an IVOA Proposed Endorsed Note for review by IVOA
                members and other interested parties. It is appropriate to
                reference this document only as a Proposed Endorsed Note that
                is under review and may change before it is endorsed or may
                not be endorsed.
              </xsl:when>
              <xsl:when test="$doctype='EN'">
                This document is an IVOA Endorsed Note. It has been reviewed
                and endorsed by the IVOA Technical Coordination Group as a
                stable, citable document which constitutes valuable information
                for the IVOA community and beyond.
              </xsl:when>
              <xsl:otherwise>
                  <xsl:message terminate='yes'>Invalid document
                      status (this cannot happen).</xsl:message>
              </xsl:otherwise>
          </xsl:choose>
      </em></p>

      <p>A list of current IVOA Recommendations and other technical documents
        can be found in the <a href="https://www.ivoa.net/documents">IVOA
        document repository</a>.</p>
  </xsl:template>

  <xsl:template match="dd[@id='ivoagroup']">
    <xsl:choose>
      <xsl:when test="@class='IG'">
        <dt>Interest Group</dt>
      </xsl:when>
      <xsl:otherwise>
        <dt>Working Group</dt>
      </xsl:otherwise>
    </xsl:choose>
     <xsl:copy-of select="."/>
  </xsl:template>

  <xsl:template name="selectDoctypeStyle">
    <xsl:variable name="doctype" select="//span[@id='doctype']"/>
    <link rel="stylesheet" type="text/css">
      <xsl:attribute name="href">
        <xsl:choose>
         <xsl:when test="$doctype='WD'"
            >https://www.ivoa.net/misc/ivoa_wd.css</xsl:when>
         <xsl:when test="$doctype='PR'"
            >https://www.ivoa.net/misc/ivoa_pr.css</xsl:when>
         <xsl:when test="$doctype='REC'"
            >https://www.ivoa.net/misc/ivoa_rec.css</xsl:when>
         <xsl:when test="$doctype='NOTE'"
            >https://www.ivoa.net/misc/ivoa_note.css</xsl:when>
         <xsl:when test="$doctype='PEN'"
            >https://www.ivoa.net/misc/ivoa_pen.css</xsl:when>
         <xsl:when test="$doctype='EN'"
            >https://www.ivoa.net/misc/ivoa_en.css</xsl:when>
       </xsl:choose>
     </xsl:attribute>
     </link>
  </xsl:template>

  <!-- To somewhat support keyval-style arguments (as in, e.g., listings)
    this allows translating them into css classes.  Essentially,
    generate a div with a keyvals attribute; see lstlisting in tthdefs -->

  <xsl:template match="*[@keyvals]">
    <div>
      <xsl:attribute name="class">
        <xsl:value-of select="translate(@keyvals, ',=\\', ' __')"/>
      </xsl:attribute>
      <xsl:apply-templates/>
    </div>
  </xsl:template>

  <!-- In verbatim listings, we may want to play tricks with lines.
       So, let's mark them up with spans. -->

  <xsl:template name="split-into-lines">
    <xsl:param name="arg"/>
    <span class="verbline"><xsl:value-of
      select="substring-before($arg, '&#xa;')"/>
      <xsl:text>&#xa;</xsl:text>
    </span>

    <xsl:if test="substring-after($arg, '&#xa;')">
      <xsl:call-template name="split-into-lines">
        <xsl:with-param name="arg" select="substring-after($arg, '&#xa;')"/>
      </xsl:call-template>
    </xsl:if>
  </xsl:template>

  <xsl:template match="pre">
    <pre>
      <xsl:copy-of select="@*"/>
      <xsl:call-template name="split-into-lines">
        <xsl:with-param name="arg" select="."/>
      </xsl:call-template>
    </pre>
  </xsl:template>

  <!-- Make a link to the current version on the ivoa doc server.
       The format of the URI here is as mandated by the IVOA
       Document Standards Standard Document (ahem). -->
  <xsl:template name="currentlink">
    <xsl:variable name="docdate" select="span[@id='docdate']"/>
    <xsl:variable name="currenturl">
      <xsl:value-of select="$docbase"/>
      <xsl:text>/</xsl:text>
      <xsl:value-of select="concat(
        substring($docdate, 1, 4),
        substring($docdate, 6, 2),
        substring($docdate, 9, 2))"/>
    </xsl:variable>
    <xsl:element name="a">
      <xsl:attribute name="class">currentlink</xsl:attribute>
      <xsl:attribute name="href">
        <xsl:value-of select="$currenturl"/>
      </xsl:attribute>
      <xsl:value-of select="$currenturl"/>
     </xsl:element>
  </xsl:template>

  <!-- Make a link to the LATEST version on the ivoa doc server.
       This is a URL without a version, which will redirect, on the
       doc server, to the versioned URL. -->
  <xsl:template name="latestlink">
    <xsl:variable name="currenturl">
      <xsl:value-of select="$docbase"/>
    </xsl:variable>
    <xsl:element name="a">
       <xsl:attribute name="class">latestlink</xsl:attribute>
       <xsl:attribute name="href">
          <xsl:value-of select="$currenturl"/>
       </xsl:attribute>
       <xsl:value-of select="$currenturl"/>
    </xsl:element>
  </xsl:template>

  <!-- I want to style the role diagram; ideally, we'd add a class
    through LaTeX, but TTH doesn't have a straightforward facility
    for doing this.  Hence, I'm adding a class manually. -->
  <xsl:template match="img[@src='role_diagram.svg']">
    <xsl:copy>
      <xsl:attribute name="class">archdiag</xsl:attribute>
      <xsl:apply-templates select="@*|node()"/>
    </xsl:copy>
  </xsl:template>

  <!-- tth has given up detecting p elements in TeX source and hacks in
       div class="p" elements as paragraph separators.  These
       are potentially very confusing to browsers.  We hence
       replace them with hopefully less confusing constructs -->
  <xsl:template match="div[@class='p']">
    <p class="parsep"><span> </span></p>
  </xsl:template>

  <xsl:template match="body">
    <body>
      <xsl:apply-templates/>
    </body>
  </xsl:template>

</xsl:stylesheet>