a11y: table

.devcontainer/docker-compose.yml

@@ -1,7 +1,7 @@
 services:
   app:
-    image: ghcr.io/ximeraproject/ximeralatex:v2.7.0
-    # image: ghcr.io/ximeraproject/ximeralatex:v2.7.0-full
+    image: ghcr.io/ximeraproject/ximeralatex:v2.7.2
+    # image: ghcr.io/ximeraproject/ximeralatex:v2.7.2-full
     volumes:
       # This is where VS Code should expect to find your project's source code and the value of "workspaceFolder" in .devcontainer/devcontainer.json
       - ..:/code:cached

.github/workflows/serve-ximera.yml

@@ -49,13 +49,13 @@ jobs:
           GPG_KEY_ID: ${{ secrets.GPG_KEY_ID }}
           XIMERA_URL: ${{ vars.XIMERA_URL }}
           XIMERA_NAME: ${{ vars.XIMERA_NAME }}*${{ github.ref_name }}
-          XOURSES: "."  # "./testXourses"
+          XOURSES: "29-a11y-table/xourse.tex"  # "./testXourses"
+          # XM_COMPILE_SEQUENCE: "pdf"
           XM_COMPILE_SEQUENCE: "pdf,handout.pdf,html"
         run: |
           ls -alrt
           chmod +x xmScripts/xmlatex   # Overleaf sync might reset it :-()
-          # ./xmScripts/xmlatex veryclean testXourses.TODO   # TO BE REMOVED
-          ./xmScripts/xmlatex ghaction $XOURSES
+          ./xmScripts/xmlatex ghaction -j 8 $XOURSES
           echo "✅ Published to $XIMERA_URL$XIMERA_NAME " >> $GITHUB_STEP_SUMMARY
 
       - name: Setup ximera serve cache (only .git)
@@ -93,7 +93,7 @@ jobs:
           XIMERA_NAME: ${{ vars.XIMERA_NAME }}
         run: |
           ./xmScripts/xmlatex name         
-          ./xmScripts/xmlatex serve -f
+          ./xmScripts/xmlatex serve -f 
           echo "✅ Published to $XIMERA_URL$XIMERA_NAME " >> $GITHUB_STEP_SUMMARY
       - name: Serve to ximera.osu.edu
         env:

.vscode/settings.json

@@ -59,7 +59,7 @@
             "alignment": "right",
             "task": "HTML",
             "description": "Create HTML of the current file.",
-            "tooltip": "Compile a HTML from the current file."
+            "tooltip": "Compile (and publish) HTML \nfrom the current file."
         },
         {
             "label": "SERVE",
@@ -91,52 +91,51 @@
                     "description": "Remove all generated files",
                     "problemMatcher": [],
                 },
-
-                {
-                    "label": "Bake",
-                    "alignment": "right",
-                    "task": "Bake",
-                    "description": "Bake this project (make .html files).",
-                    "tooltip": "Bake this project."
-                },
-                {
-                    "task": "Bake pdf",
-                    "label": "Bake PDF's (with answers)",
-                    "description": "Make PDF's.",
-                    "problemMatcher": [],
-                },
-                {
-                    "task": "Bake pdf (force rebuild)",
-                    "label": "Force (re-)Bake PDF's (with answers)",
-                    "description": "Make PDF's.",
-                    "problemMatcher": [],
-                },
-                {
-                    "task": "Bake handout",
-                    "label": "Bake handout PDF's (without answers)",
-                    "description": "Make handout PDF's.",
-                    "problemMatcher": [],
-                },
-                {
-                    "task": "Bake handout (fore rebuild)",
-                    "label": "Force (re-)Bake handout PDF's (without answers)",
-                    "description": "Make handout PDF's.",
-                    "problemMatcher": [],
-                },
-                {
-                    "label": "Frost",
-                    "alignment": "right",
-                    "task": "Frost",
-                    "description": "Frost this project.",
-                    "tooltip": "Frost this project."
-                },
-                {
-                    "label": "Serve",
-                    "alignment": "right",
-                    "task": "Serve",
-                    "description": "Serve this project.",
-                    "tooltip": "Serve this project."
-                },
+                // {
+                //     "label": "Bake",
+                //     "alignment": "right",
+                //     "task": "Bake",
+                //     "description": "Bake this project (make .html files).",
+                //     "tooltip": "Bake this project."
+                // },
+                // {
+                //     "task": "Bake pdf",
+                //     "label": "Bake PDF's (with answers)",
+                //     "description": "Make PDF's.",
+                //     "problemMatcher": [],
+                // },
+                // {
+                //     "task": "Bake pdf (force rebuild)",
+                //     "label": "Force (re-)Bake PDF's (with answers)",
+                //     "description": "Make PDF's.",
+                //     "problemMatcher": [],
+                // },
+                // {
+                //     "task": "Bake handout",
+                //     "label": "Bake handout PDF's (without answers)",
+                //     "description": "Make handout PDF's.",
+                //     "problemMatcher": [],
+                // },
+                // {
+                //     "task": "Bake handout (fore rebuild)",
+                //     "label": "Force (re-)Bake handout PDF's (without answers)",
+                //     "description": "Make handout PDF's.",
+                //     "problemMatcher": [],
+                // },
+                // {
+                //     "label": "Frost",
+                //     "alignment": "right",
+                //     "task": "Frost",
+                //     "description": "Frost this project.",
+                //     "tooltip": "Frost this project."
+                // },
+                // {
+                //     "label": "Serve",
+                //     "alignment": "right",
+                //     "task": "Serve",
+                //     "description": "Serve this project.",
+                //     "tooltip": "Serve this project."
+                // },
                 {
                     "task": "Update DevEnv",
                     "label": "Update the build environment",

.vscode/tasks.json

@@ -31,8 +31,7 @@
         {
             "label": "SERVE",
             "args": [
-                "all",
-                "-s",
+                "ghaction",
             ],
         },
         {

29-a11y-table/Tables_Testing.tex

@@ -0,0 +1,62 @@
+\documentclass{ximera}
+
+\title{Make Tables Accessible}
+
+\begin{document}
+\begin{abstract}\end{abstract}
+\maketitle
+
+Here is a table with two headers:
+
+\begin{center}
+\begin{tblr}{
+  colspec = {Q[l]Q[c]Q[c]}, 
+  rowhead=1, 
+  xmcolhead=1
+}
+%\toprule    %% THIS CAUSES COMPILATION TO HANG
+%\hline      %% THIS CAUSES COMPILATION TO HANG
+ & Grammy Wins & Grammy Nominations \\
+% \midrule
+Fearless & 4 & 8 \\
+1989 & 3 & 7 \\
+%\bottomrule
+\end{tblr}
+\end{center}
+
+Here is a table with only a row header:
+\begin{center}
+\begin{tblr}{
+  colspec = {Q[l]Q[l]Q[l]}, 
+  rowhead=1, 
+}
+%\toprule    %% THIS CAUSES COMPILATION TO HANG
+%\hline      %% THIS CAUSES COMPILATION TO HANG
+ Album & Release Date & Lead Single \\
+% \midrule
+Midnights & October 21, 2022   & Anti--Hero \\
+The Tortured Poets Department & April 19, 2024 & Fortnight \\
+%\bottomrule
+\end{tblr}
+\end{center}
+
+Here is a table with only a column header:
+
+\begin{center}
+\begin{tblr}{
+  colspec = {Q[l]Q[l]Q[l]}, 
+  xmcolhead=1, 
+}
+%\toprule    %% THIS CAUSES COMPILATION TO HANG
+%\hline      %% THIS CAUSES COMPILATION TO HANG
+ Album & 1989 & Folklore \\
+% \midrule
+Release Date & October 27, 2014   & Anti--Hero \\
+Lead Single & July 24, 2020 & Cardigan \\
+%\bottomrule
+\end{tblr}
+\end{center}
+
+\end{document}
+
+

29-a11y-table/TailorSwiftBotPublic.sty

@@ -0,0 +1,42 @@
+%%% % -*- coding: utf-8 -*-
+%%% ----------------------------------------------------------------------------
+%%% Caption     : Make your math WCAG2.1AA compliant
+%%% Author      : Jeffrey Kuan <[email protected]>
+%%% Collaborator: 
+%%% CTAN Page   : 
+%%% Repository  : 
+%%% License     : 
+%%% ----------------------------------------------------------------------------
+
+%%% --------------------------------------------------------
+%%> \section{}
+%%% --------------------------------------------------------
+
+%% \DeclareRelease and \DeclareCurrentRelease are added in LaTeX 2018-04-01
+\NeedsTeXFormat{LaTeX2e}[2018-04-01]
+\providecommand\DeclareRelease[3]{}
+\providecommand\DeclareCurrentRelease[2]{}
+%\DeclareRelease{}{}{}
+\DeclareCurrentRelease{}{2025-07-10}
+
+\ProvidesExplPackage{TailorSwiftBotPublic}{2025-07-10}{2025}
+  {Make your math WCAG2.1AA compliant}
+
+\__tblr_keys_define:nn { table/inner }
+  {
+    xmcolhead .code:n = \__tblr_keys_gput:nn { xmcolhead } {#1},
+  }
+
+\int_new:N \lTblrColHeadInt
+
+\cs_new_protected:Npn \__tblr_build_col_head_foot:
+  {
+    %% \lTblrColHeadInt can not be empty, so we append '+ 0'.
+    \int_set:Nn \lTblrColHeadInt
+      { \__tblr_prop_item:ne { inner } { xmcolhead } + 0 }
+    \int_compare:nNnTF { \lTblrColHeadInt } > { 0 }
+      {
+        \__tblr_build_one_table:nnNN {1} { \lTblrColHeadInt }
+          \c_true_bool \c_true_bool
+      }
+  }

29-a11y-table/tabularBasic.tex

@@ -0,0 +1,58 @@
+\documentclass{ximera}
+\title{Tabular and array}
+
+\begin{document}
+\begin{abstract}
+\end{abstract}
+\maketitle
+
+\section{Basic Usage}
+
+
+        With \verb|tabular| (and \verb|center|):
+        \begin{center}
+            \begin{tabular}{lr}
+                x & 1 \\
+                y & 2 \\
+                z & 1
+            \end{tabular}
+        \end{center}
+
+        With \verb|tabular and @{} | (and \verb|center|):
+        \begin{center}
+            \begin{tabular}{@{}l@{ }r@{.}}
+             x & 1 \\
+             y & 2 \\
+             z & 1
+            \end{tabular}
+            \end{center}
+
+    With \verb|tabular and p{} | (and \verb|center|):
+        \begin{center}
+            \begin{tabular}{|p{1cm}|p{2cm}|p{3cm}|}
+             x & 1 & 2\\
+             y & 2 & 3\\
+             z & 1 & 4
+            \end{tabular}
+        \end{center}
+
+    With \verb|array|:
+        $$
+        \begin{array}{l|r}
+         x & 1 \\
+         \hline
+         y & 2 \\
+         z & 1
+        \end{array}
+        $$
+    With \verb|array and @{} and p{}|:
+        $$
+        \begin{array}{@{X }l@{|}p{2cm}|}
+         x & 1 \\
+         \hline
+         y & 2 \\
+         z & 1
+        \end{array}
+        $$
+
+    \end{document}

29-a11y-table/tabularBasic_article.tex

@@ -0,0 +1,58 @@
+\documentclass{article}
+\title{Tabular and array (with 'article')}
+
+\begin{document}
+% \begin{abstract}
+% \end{abstract}
+\maketitle
+
+\section{Basic Usage}
+
+
+        With \verb|tabular| (and \verb|center|):
+        \begin{center}
+            \begin{tabular}{lr}
+                x & 1 \\
+                y & 2 \\
+                z & 1
+            \end{tabular}
+        \end{center}
+
+        With \verb|tabular and @{} | (and \verb|center|):
+        \begin{center}
+            \begin{tabular}{@{}l@{ }r@{.}}
+             x & 1 \\
+             y & 2 \\
+             z & 1
+            \end{tabular}
+            \end{center}
+
+    With \verb|tabular and p{} | (and \verb|center|):
+        \begin{center}
+            \begin{tabular}{|p{1cm}|p{2cm}|p{3cm}|}
+             x & 1 & 2\\
+             y & 2 & 3\\
+             z & 1 & 4
+            \end{tabular}
+        \end{center}
+
+    With \verb|array|:
+        $$
+        \begin{array}{l|r}
+         x & 1 \\
+         \hline
+         y & 2 \\
+         z & 1
+        \end{array}
+        $$
+    With \verb|array and @{} and p{}|:
+        $$
+        \begin{array}{@{X }l@{|}p{2cm}|}
+         x & 1 \\
+         \hline
+         y & 2 \\
+         z & 1
+        \end{array}
+        $$
+
+    \end{document}