📚 Add table captions and figures for complete PDF navigation

- Add multiple LaTeX compilation passes (3 passes) for TOC/LOF/LOT generation
- Add captions to longtables for List of Tables functionality:
  - 'Complete BOOST Entity Summary with Thematic Areas'
  - 'BOOST Entity Relationship Foreign Key Mappings'
- Add placeholder figures for List of Figures functionality:
  - 'Complete BOOST Entity Relationship Diagram Overview'
  - 'BOOST Thematic Areas and Entity Organization'
- Add auxiliary file checking for debugging
- This should resolve missing TOC, List of Tables, and List of Figures

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: pwt-cd

.github/workflows/build-deploy.yml

@@ -179,7 +179,12 @@ jobs:
           # Try LaTeX build first
           if [ -f "boost-spec.tex" ]; then
             echo "🔧 Building PDF from LaTeX..."
-            pdflatex -shell-escape -interaction=nonstopmode boost-spec.tex || echo "LaTeX build failed, trying Pandoc..."
+            echo "📄 Running first LaTeX pass..."
+            pdflatex -shell-escape -interaction=nonstopmode boost-spec.tex || echo "LaTeX first pass failed"
+            echo "📄 Running second LaTeX pass (for TOC, LOF, LOT)..."
+            pdflatex -shell-escape -interaction=nonstopmode boost-spec.tex || echo "LaTeX second pass failed"
+            echo "📄 Running third LaTeX pass (for cross-references)..."
+            pdflatex -shell-escape -interaction=nonstopmode boost-spec.tex || echo "LaTeX third pass failed, trying Pandoc..."
           fi
           
           # Fallback to Pandoc HTML->PDF conversion

.github/workflows/build-dev-docs.yml

@@ -143,7 +143,16 @@ jobs:
           # Try LaTeX build first
           if [ -f "boost-spec.tex" ]; then
             echo "🔧 Attempting LaTeX PDF build with shell-escape..."
+            echo "📄 Running first LaTeX pass..."
             pdflatex -shell-escape -interaction=nonstopmode boost-spec.tex || true
+            echo "📄 Running second LaTeX pass (for TOC, LOF, LOT)..."
+            pdflatex -shell-escape -interaction=nonstopmode boost-spec.tex || true
+            echo "📄 Running third LaTeX pass (for cross-references)..."
+            pdflatex -shell-escape -interaction=nonstopmode boost-spec.tex || true
+            
+            # Check auxiliary files generated
+            echo "🔍 Checking generated auxiliary files..."
+            ls -la *.aux *.toc *.lof *.lot *.log 2>/dev/null || echo "Some auxiliary files missing"
             
             # Check if PDF was actually generated (ignore LaTeX warnings)
             if [ -f "boost-spec.pdf" ]; then

drafts/current/specifications/tex/entity-reference-generated.tex

@@ -5,10 +5,14 @@ \subsection{Entity Summary Table}
 \label{sec:entity-summary-generated}
 
 \begin{longtable}{@{}p{0.25\textwidth}p{0.15\textwidth}p{0.45\textwidth}p{0.1\textwidth}@{}}
+\caption{Complete BOOST Entity Summary with Thematic Areas}
+\label{tab:entity-summary}\\
 \toprule
 \textbf{Entity} & \textbf{Thematic Area} & \textbf{Description} & \textbf{Fields} \\
 \midrule
 \endfirsthead
+
+\multicolumn{4}{c}{\textbf{Table \thetable{} (continued): Complete BOOST Entity Summary with Thematic Areas}} \\
 \toprule
 \textbf{Entity} & \textbf{Thematic Area} & \textbf{Description} & \textbf{Fields} \\
 \midrule
@@ -56,10 +60,14 @@ \subsection{Entity Relationship Map}
 The following table shows all foreign key relationships between entities:
 
 \begin{longtable}{@{}p{0.2\textwidth}p{0.2\textwidth}p{0.2\textwidth}p{0.3\textwidth}@{}}
+\caption{BOOST Entity Relationship Foreign Key Mappings}
+\label{tab:entity-relationships}\\
 \toprule
 \textbf{Source Entity} & \textbf{Field} & \textbf{Target Entity} & \textbf{Description} \\
 \midrule
 \endfirsthead
+
+\multicolumn{4}{c}{\textbf{Table \thetable{} (continued): BOOST Entity Relationship Foreign Key Mappings}} \\
 \toprule
 \textbf{Source Entity} & \textbf{Field} & \textbf{Target Entity} & \textbf{Description} \\
 \midrule

drafts/current/specifications/tex/erd-diagrams.tex

@@ -17,9 +17,38 @@ \subsection{Complete Entity Relationship Overview}
 \end{itemize}
 
 % Static ERD diagrams will be inserted here
-% \includegraphics[width=\textwidth]{diagrams/boost-erd-complete.pdf}
+% Note: Placeholder figure for List of Figures functionality
+\begin{figure}[H]
+    \centering
+    \fbox{\parbox{0.8\textwidth}{\centering
+        \vspace{2cm}
+        \textbf{BOOST Entity Relationship Diagram}\\[0.5cm]
+        \textit{Complete ERD showing all 33 interconnected entities}\\
+        \textit{across 7 thematic areas}\\[0.5cm]
+        \textcolor{gray}{Interactive version available at:\\
+        \texttt{boost-spec.html\#erd-navigator}}\\
+        \vspace{2cm}
+    }}
+    \caption{Complete BOOST Entity Relationship Diagram Overview}
+    \label{fig:boost-erd-complete}
+\end{figure}
 
 \subsection{Thematic Area Diagrams}
 \label{sec:thematic-area-diagrams}
 
-% Individual thematic area diagrams will be inserted here
+% Individual thematic area diagrams will be inserted here
+\begin{figure}[H]
+    \centering
+    \fbox{\parbox{0.8\textwidth}{\centering
+        \vspace{2cm}
+        \textbf{BOOST Thematic Areas Structure}\\[0.5cm]
+        \textit{7 thematic areas organizing 33 entities}\\[0.5cm]
+        \coretraceability{Core Traceability} • \organizational{Organizational Foundation}\\
+        \materialsupply{Material \& Supply Chain} • \transaction{Transaction Management}\\
+        \sustainability{Measurement \& Verification} • \geographic{Geographic \& Tracking}\\
+        \reporting{Compliance \& Reporting}\\[0.5cm]
+        \vspace{1cm}
+    }}
+    \caption{BOOST Thematic Areas and Entity Organization}
+    \label{fig:boost-thematic-areas}
+\end{figure}