1

We use xsl-fo to generate pdf.

We want the pdf to be pdf-ua-compliant.

We use veraPDF for validation this standard.

When there is a table-header that has horizontal spanned cells, it complains about rule 7.5-1:

"In a table not organized with Headers attributes and IDs, a TH cell does not contain a Scope attribute"

Normally each header cell has an id, that we can refer to in body-cells by using rx:header-idref (a renderx-xep specific solution, see comments in this question for more context)

But with spanned header cells this fails because there are body-cells that have no corresponding header-cell.

See i.e this screenshot: TableIssuePdfUa.png

the second cell of the first body-row with "R ≤ 10 (hb +hw)" is missing it's header-cell to reference it's id.

How can this be resolved?

EDIT: for better understanding this is the source xml:

<table>
  <tgroup cols="4" align="left">
    <colspec colnum="1" colwidth="28.1*" colname="col1"/>
    <colspec colnum="2" colwidth="34.3*" colname="col2"/>
    <colspec colnum="3" colwidth="20*" colname="col3"/>
    <colspec colnum="4" colwidth="17.7*" colname="col4"/>
    <thead valign="bottom">
      <row rowsep="1">
        <entry namest="col1" nameend="col2" valign="top" align="center" colname="col1" rotate="0" morerows="1" colsep="1">
          <Al>afstand</Al>
        </entry>
        <entry namest="col3" nameend="col4" valign="top" align="left" colname="col3" rotate="0" colsep="1">
          <Al>minimum aantal metingen <i>N</i></Al>
        </entry>
      </row>
      <row rowsep="1">
        <entry valign="top" align="left" colname="col3" rotate="0" colsep="1">
          <Al>zonder afscherming</Al>
        </entry>
        <entry valign="top" align="left" colname="col4" rotate="0" colsep="1">
          <Al>met afscherming</Al>
        </entry>
      </row>
    </thead>
    <tbody valign="top">
      <row rowsep="1">
        <entry valign="top" align="left" colname="col1" rotate="0" colsep="1"/>
        <entry valign="top" align="left" colname="col2" rotate="0" colsep="1">
          <Al><i>R</i> ≤ 10 (<i>h<sub>b</sub></i> + <i>h<sub>w</sub></i>)</Al>
        </entry>
        <entry valign="top" align="left" colname="col3" rotate="0" colsep="1">
          <Al>1</Al>
        </entry>
        <entry valign="top" align="left" colname="col4" rotate="0" colsep="1">
          <Al>1</Al>
        </entry>
      </row>
      <row rowsep="1">
        <entry valign="top" align="left" colname="col1" rotate="0" colsep="1">
          <Al>10 (<i>h<sub>b</sub></i> + <i>h<sub>w</sub></i>) &lt;</Al>
        </entry>
        <entry valign="top" align="left" colname="col2" rotate="0" colsep="1">
          <Al><i>R</i> ≤ 20 (<i>h<sub>b</sub></i> + <i>h<sub>w</sub></i>)</Al>
        </entry>
        <entry valign="top" align="left" colname="col3" rotate="0" colsep="1">
          <Al>1</Al>
        </entry>
        <entry valign="top" align="left" colname="col4" rotate="0" colsep="1">
          <Al>2</Al>
        </entry>
      </row>
      <row rowsep="1">
        <entry valign="top" align="left" colname="col1" rotate="0" colsep="1">
          <Al>20 (<i>h<sub>b</sub></i> + <i>h<sub>w</sub></i>) &lt;</Al>
        </entry>
        <entry valign="top" align="left" colname="col2" rotate="0" colsep="1">
          <Al>
            <i>R</i>
          </Al>
        </entry>
        <entry valign="top" align="left" colname="col3" rotate="0" colsep="1">
          <Al>2</Al>
        </entry>
        <entry valign="top" align="left" colname="col4" rotate="0" colsep="1">
          <Al>3</Al>
        </entry>
      </row>
    </tbody>
  </tgroup>
</table>

And this is a snippet of the current xslt:

<xsl:template match="row/entry" mode="content">
  <xsl:param name="inThead"  as="xs:boolean"        tunnel="yes"/>
  <fo:table-cell>
    <xsl:choose>
      <xsl:when test="$inThead">
        <!-- In de thead delen we aleeen id's uit aan die entries die als eerste voorkomen met hun betreffende colname, zodat id uniek is. -->
        <xsl:variable name="colname" select="@colname"/>
        <xsl:if test="not(parent::row/preceding-sibling::row/entry[@colname=$colname])">
          <xsl:attribute name="id" select="@colname"/>
        </xsl:if>
      </xsl:when>
      <xsl:otherwise>
        <xsl:attribute name="rx:header-idref" select="@colname"/>
      </xsl:otherwise>
    </xsl:choose>
    <!-- here some other logic -->
  </fo:table-cell>
</xsl:template>
Siebe Jongebloed
  • 3,906
  • 2
  • 14
  • 19
  • I do not understand the question I guess. The body cell you mention has a header cell, it is "afstand" and hence you would reference the "id" of that cell. Similarly, the third column would reference BOTH "minimum aantal ..." and "zonder ..." by using a space separated list of id's in header-idref. – Kevin Brown Jun 07 '23 at 16:56

2 Answers2

2

To me the question without markup is a bit unclear however note that there is nothing that stops multiple body cells from referencing the same header cell. So the second cell should reference the spanned header cell. As should all the body cells in columns 1 and 2.

Note that the rx:header-idref can be a comma separated list of id's. This is the order in which they should be read. So in the third cell in that first row, you would reference the id's of the spanned top header and the one below that does not span. This same technique would apply to row headers. As in you could have:

@rx:header-idref="col3-4head1spanned, col3head2"

and

 @rx:header-idref="col3-4head1spanned, col4head2"

as an image of what I mean:

enter image description here

Kevin Brown
  • 8,805
  • 2
  • 20
  • 38
  • Very nice explanation. And a nice challenge to get this right for all sorts of tables. – Siebe Jongebloed Jun 08 '23 at 07:16
  • I solved the issue but at the moment veraPdf does not cope with multiple id's inside @header-idref. So for now I just use the first id that in the thead is actually the last one – Siebe Jongebloed Jun 08 '23 at 11:55
  • Quite surprising that VeraPDF cannot handle multiple id's referenced in a single body cell. This would mean it could not even check a common, simple table like one that has column and row headers (let alone spanning in body cells). – Kevin Brown Jun 08 '23 at 16:51
  • The 'Headers' table attribute (ISO 32000-1:2008, Clause 14.8.5.7, Table 349, page 610) is an array of byte strings "where each string shall be the element identifier ... for a TH structure element that shall be used as a header associated with this cell." I have no idea whether XEP is converting comma-separated values into separate strings. A header cell (a 'TH' in PDF-speak) can have a 'Headers' attribute referring to its own headers, so a cell in the third column could refer to `col3head2`, and that `fo:table-cell` could refer to `col3-4head1spanned` and satisfy the PDF/UA checkers. – Tony Graham Jun 09 '23 at 11:30
  • Yes a byte array with one or more id's. @TonyGraham is correct except as stated, you could not do TH row and col headers that way and and checker should support that – Kevin Brown Jun 09 '23 at 16:26
  • I don't understand the 'could not'. From the same table in the standard: "This attribute may apply to header cells (TH) as well as data cells (TD) (see Table 337). Therefore, the headers associated with any cell shall be those in its Headers array plus those in the Headers array of any TH cells in that array, and so on recursively." – Tony Graham Jun 09 '23 at 21:01
1

Using the answer of @Kevin Brown I came up with the following code:

  <!--
    functie: f:getColspecsMetTbodyNaarTheadLinks
    param: colspecs
    param: thead
    Adds  attribute @bodyNaarTheadLinks to every colspec with the @id's of thead-entries where every entry with the same @colname in the tbody belongs to
  -->
  <xsl:function name="f:getColspecsMetTbodyNaarTheadLinks">
    <xsl:param name="colspecs" as="element(colspec)*"/>
    <xsl:param name="thead" as="element(thead)?"/>
    <xsl:for-each select="$colspecs">
      <xsl:variable name="colnumColspec" as="xs:integer" select="xs:integer(@colnum)"/>
      <xsl:copy copy-namespaces="false">
        <xsl:copy-of select="@*"/>
        <xsl:variable name="linksToHeaderCells" as="xs:string*">
          <xsl:for-each select="$thead/row">
            <!-- de links should go from bottom to top -->
          <xsl:sort select="position()" order="descending" />
          <xsl:for-each select="entry">
            <xsl:variable name="theadEntryId" as="xs:string" select="xs:string(@id)"/>
            <xsl:variable name="colnumEntry" as="xs:integer" select="index-of($colspecs/@colname,@colname)"/>
              <xsl:choose>
                <xsl:when test="@namest and @nameend">
                  <xsl:variable name="colnumStart" as="xs:integer" select="index-of($colspecs/@colname,@namest)"/>
                  <xsl:variable name="colnumEnd" as="xs:integer"   select="index-of($colspecs/@colname,@nameend)"/>
                  <xsl:for-each select="$colnumStart to $colnumEnd">
                    <xsl:if test="$colnumColspec = .">
                      <xsl:value-of select="$theadEntryId"/>
                    </xsl:if>
                  </xsl:for-each>
                </xsl:when>
                <xsl:when test="$colnumColspec eq $colnumEntry">
                  <xsl:value-of select="$theadEntryId"/>       
                </xsl:when>
              </xsl:choose>
            </xsl:for-each>
          </xsl:for-each>
        </xsl:variable>
        <!-- 
          veraPdf cannot find relations (issue?) when there are more than one links to thead-entries. Therefore we use just only the first for now: $linksToHeaderCells[1]
        -->
        <xsl:attribute name="bodyNaarTheadLinks" select="$linksToHeaderCells[1]" separator=", "/>
      </xsl:copy>
    </xsl:for-each>
  </xsl:function>

In below tgroup match I call the function

  <xsl:template match="tgroup" mode="content">
    <xsl:apply-templates mode="#current">
      <xsl:with-param name="colspecs" as="element(colspec)*" tunnel="yes" select="if(thead) then f:getColspecsMetTbodyNaarTheadLinks(colspec,thead) else colspec" />
    </xsl:apply-templates>
  </xsl:template>

Btw: the tunnel-param colspecs is used in other places as well

And in below entry-match

  <xsl:template match="row/entry" mode="content">
    <xsl:param name="inThead"       as="xs:boolean"         tunnel="yes"/>
    <xsl:param name="colspecs"      as="element(colspec)*"  tunnel="yes"/>
    <fo:table-cell>
        <xsl:variable name="colspec" as="element()" select="$colspecs[@colname= current()/@colname]"/>
        <xsl:if test="not($inThead) and $colspec/@bodyNaarTheadLinks">
          <xsl:attribute name="rx:header-idref" select="$colspec/@bodyNaarTheadLinks"/>
        </xsl:if>
      <!-- some more logic -->
    </fo:table-cell>
  </xsl:template>
Siebe Jongebloed
  • 3,906
  • 2
  • 14
  • 19