TestTableFormatting 2025-06-03 05:24:11 2026-09-06 16:51:47 Definition It is semantically the same table-row operation, but it uses one backslash, so whatever copy/editor path converted \\ into \ cannot damage it. % this is the default PhysicsLibrary preamble. as your knowledge % of TeX increases, you will probably want to edit this, but % it should be fine as is for beginners. % almost certainly you want these \usepackage{amssymb} \usepackage{amsmath} \usepackage{amsfonts} % used for TeXing text within eps files %\usepackage{psfrag} % need this for including graphics (\includegraphics) %\usepackage{graphicx} % for neatly defining theorems and propositions %\usepackage{amsthm} % making logically defined graphics %\usepackage{xypic} % there are many more packages, add them here as you need them % define commands here % ============================================================ % PhysicsLibrary Table Rendering Test Suite % Stage 1: Standard LaTeX Tables % % IMPORTANT: % Do NOT add any packages to the existing PhysicsLibrary preamble % for this stage. % % This stage uses only standard tabular functionality plus the % AMS packages already present in the normal PhysicsLibrary preamble. % % The purpose is to establish a known-good rendering baseline % before adding color, hyperlinks, or specialized table packages. % ============================================================ \section*{LaTeX Table Rendering Test Suite} This entry provides progressively more complicated examples of LaTeX tables for Physics Library authors. It also serves as a regression test for the Physics Library rendering pipeline. The examples are intentionally introduced in stages. Stage 1 uses only ordinary LaTeX table functionality. Later stages will independently introduce colors, hyperlinks, specialized table packages, and other features. If a rendering problem occurs, the first failing example can help identify the feature responsible for the problem. \subsection*{Stage 1 Test Matrix} \begin{center} \begin{tabular}{|c|l|l|} \hline \textbf{Test} & \textbf{Feature} & \textbf{Purpose} \ \hline 1 & Simple table & Basic row and column conversion \ \hline 2 & Column alignment & Left, center, and right alignment \ \hline 3 & Horizontal rules & Standard \texttt{hline} rendering \ \hline 4 & Vertical rules & Vertical column separators \ \hline 5 & Full grid & Horizontal and vertical rules together \ \hline 6 & Mathematics & Mathematical expressions in cells \ \hline 7 & Units & Superscripts and mathematical text \ \hline 8 & Multicolumn & Horizontally merged cells \ \hline 9 & Grouped headings & Multiple merged column groups \ \hline 10 & Paragraph column & Wrapped text in a fixed-width cell \ \hline 11 & Table spacing & Row and column spacing adjustments \ \hline 12 & Empty cells & Incomplete table entries \ \hline 13 & Mixed content & Text, math, and numbers together \ \hline 14 & Combined table & Several standard features together \ \hline \end{tabular} \end{center} \subsection*{Test 1: Simplest Possible Table} This is close to the smallest useful \texttt{tabular} example. \begin{center} \begin{tabular}{ccc} A & B & C \ 1 & 2 & 3 \ 4 & 5 & 6 \end{tabular} \end{center} This test contains no table rules and no special formatting. \subsection*{Test 2: Column Alignment} The letters \texttt{l}, \texttt{c}, and \texttt{r} specify left, center, and right alignment. \begin{center} \begin{tabular}{lcr} \textbf{Left} & \textbf{Center} & \textbf{Right} \ Apple & 10 & 1.25 \ Orange & 125 & 12.50 \ Banana & 3 & 0.75 \end{tabular} \end{center} The different lengths of the entries make the alignment easier to see. \subsection*{Test 3: Horizontal Rules} The standard \texttt{hline} command creates horizontal table rules. \begin{center} \begin{tabular}{lcc} \hline \textbf{Object} & \textbf{Mass} & \textbf{Velocity} \ \hline A & 2.0 & 5.0 \ B & 4.0 & 3.0 \ C & 8.0 & 1.5 \ \hline \end{tabular} \end{center} \subsection*{Test 4: Vertical Rules} Vertical bars in the column specification create vertical separators. \begin{center} \begin{tabular}{l|c|r} Item & Quantity & Price \ Apple & 10 & $0.50 \ Banana & 15 & $0.30 \ Orange & 8 & $0.60 \end{tabular} \end{center} \subsection*{Test 5: Full Grid} This is the conventional fully bordered table. \begin{center} \begin{tabular}{|c|c|c|} \hline \textbf{ID} & \textbf{Name} & \textbf{Score} \ \hline 1 & Alice & 85 \ \hline 2 & Bob & 92 \ \hline 3 & Carol & 78 \ \hline \end{tabular} \end{center} This test is intentionally similar to the original Physics Library table-rendering example. \subsection*{Test 6: Mathematics Inside Cells} Physics Library tables frequently contain mathematical expressions. \begin{center} \begin{tabular}{|l|c|} \hline \textbf{Quantity} & \textbf{Equation} \ \hline Velocity & $v=\dfrac{dx}{dt}$ \ \hline Acceleration & $a=\dfrac{d^2x}{dt^2}$ \ \hline Force & $F=ma$ \ \hline Momentum & $p=mv$ \ \hline Kinetic energy & $T=\dfrac{1}{2}mv^2$ \ \hline \end{tabular} \end{center} This checks fractions, derivatives, superscripts, subscripts, and ordinary mathematical symbols. \subsection*{Test 7: Physical Units} This table tests mathematical notation combined with SI units. \begin{center} \begin{tabular}{|l|c|c|} \hline \textbf{Quantity} & \textbf{Symbol} & \textbf{SI Unit} \ \hline Distance & $x$ & $\mathrm{m}$ \ \hline Time & $t$ & $\mathrm{s}$ \ \hline Velocity & $v$ & $\mathrm{m,s^{-1}}$ \ \hline Acceleration & $a$ & $\mathrm{m,s^{-2}}$ \ \hline Force & $F$ & $\mathrm{kg,m,s^{-2}}$ \ \hline Energy & $E$ & $\mathrm{kg,m^2,s^{-2}}$ \ \hline \end{tabular} \end{center} \subsection*{Test 8: A Merged Heading} The standard \texttt{multicolumn} command can merge adjacent columns. \begin{center} \begin{tabular}{|l|c|c|} \hline \multicolumn{3}{|c|}{\textbf{Student Grades}} \ \hline \textbf{Student} & \textbf{Physics} & \textbf{Mathematics} \ \hline David & A & A- \ \hline Emma & B+ & A \ \hline Maria & A- & B+ \ \hline \end{tabular} \end{center} \subsection*{Test 9: Grouped Column Headings} Multiple \texttt{multicolumn} commands can be used within the same row. \begin{center} \begin{tabular}{|c|cc|cc|} \hline & \multicolumn{2}{c|}{\textbf{Position}} & \multicolumn{2}{c|}{\textbf{Velocity}} \ \hline \textbf{Time} & $x$ & $y$ & $v_x$ & $v_y$ \ \hline 0 & 0 & 0 & 10 & 20 \ \hline 1 & 10 & 15.1 & 10 & 10.2 \ \hline 2 & 20 & 20.4 & 10 & 0.4 \ \hline \end{tabular} \end{center} \subsection*{Test 10: Wrapped Paragraph Column} The standard \texttt{p} column type creates a fixed-width paragraph column. \begin{center} \begin{tabular}{|l|p{8cm}|} \hline \textbf{Feature} & \textbf{Description} \ \hline Tabular & The standard LaTeX environment used to arrange information into rows and columns. \ \hline Paragraph column & A column with a specified width allows longer text to wrap rather than forcing the table to continually expand horizontally. \ \hline Physics use & This is useful for definitions, experimental observations, assumptions, and explanations associated with equations or numerical results. \ \hline \end{tabular} \end{center} This is particularly useful as a make4ht test because PDF and HTML renderers may interpret fixed physical widths differently. \subsection*{Test 11: Table Spacing} Spacing can be modified locally without loading another package. \begin{center} { \renewcommand{\arraystretch}{1.5} \setlength{\tabcolsep}{12pt} \begin{tabular}{|c|c|c|} \hline \textbf{Parameter} & \textbf{Symbol} & \textbf{Value} \ \hline Mass & $m$ & $2.5\ \mathrm{kg}$ \ \hline Velocity & $v$ & $12.0\ \mathrm{m/s}$ \ \hline Acceleration & $a$ & $9.81\ \mathrm{m/s^2}$ \ \hline \end{tabular} } \end{center} The braces limit the spacing changes to this example. \subsection*{Test 12: Empty Cells} Real tables sometimes contain unavailable or intentionally blank data. \begin{center} \begin{tabular}{|l|c|c|} \hline \textbf{Sensor} & \textbf{Reading 1} & \textbf{Reading 2} \ \hline Sensor A & 12.4 & 12.7 \ \hline Sensor B & 8.1 & \ \hline Sensor C & & 4.6 \ \hline Sensor D & & \ \hline \end{tabular} \end{center} \subsection*{Test 13: Mixed Text, Mathematics, and Numbers} A realistic technical table often combines several different content types. \begin{center} \begin{tabular}{|l|c|c|l|} \hline \textbf{Parameter} & \textbf{Expression} & \textbf{Value} & \textbf{Description} \ \hline Mass & $m$ & 10.0 kg & Vehicle mass \ \hline Speed & $v$ & 25.0 m/s & Forward speed \ \hline Momentum & $p=mv$ & 250 kg m/s & Linear momentum \ \hline Energy & $T=\dfrac{1}{2}mv^2$ & 3125 J & Kinetic energy \ \hline \end{tabular} \end{center} \subsection*{Test 14: Combined Standard-LaTeX Table} This final Stage 1 example combines rules, mathematics, merged headings, units, and a paragraph column. \begin{center} \begin{tabular}{|l|c|c|p{6cm}|} \hline \multicolumn{4}{|c|}{\textbf{Projectile Motion Example}} \ \hline \textbf{Quantity} & \textbf{Symbol} & \textbf{Value} & \textbf{Description} \ \hline Initial speed & $v_0$ & $25\ \mathrm{m/s}$ & Magnitude of the projectile velocity at launch. \ \hline Launch angle & $\theta$ & $45^\circ$ & Angle of the initial velocity above the local horizontal. \ \hline Gravity & $g$ & $9.81\ \mathrm{m/s^2}$ & Constant gravitational acceleration used in the simple model. \ \hline Horizontal speed & $v_0\cos\theta$ & $17.68\ \mathrm{m/s}$ & The horizontal component remains constant when aerodynamic drag is neglected. \ \hline Vertical speed & $v_0\sin\theta$ & $17.68\ \mathrm{m/s}$ & The initial vertical component changes because of gravity. \ \hline \end{tabular} \end{center} \section*{Stage 1 Interpretation} If all fourteen examples render successfully, the Physics Library make4ht pipeline has demonstrated support for: \begin{itemize} \item ordinary \texttt{tabular} environments, \item left, center, and right column alignment, \item horizontal rules, \item vertical rules, \item mathematical notation inside cells, \item superscripts and subscripts, \item SI-unit notation, \item \texttt{multicolumn}, \item paragraph columns, \item local table spacing changes, \item empty cells, \item and combinations of these standard features. \end{itemize} \section*{Planned Rendering Stages} Once Stage 1 is known to render correctly, additional capabilities should be introduced one at a time. \begin{center} \begin{tabular}{|c|l|l|} \hline \textbf{Stage} & \textbf{New Capability} & \textbf{Proposed Package} \ \hline 1 & Standard tables & None \ \hline 2 & Colored text & \texttt{xcolor} \ \hline 3 & Hyperlinks & \texttt{hyperref} \ \hline 4 & Cell and row backgrounds & \texttt{colortbl} \ \hline 5 & Professional rules & \texttt{booktabs} \ \hline 6 & Vertical cell merging & \texttt{multirow} \ \hline 7 & Flexible-width tables & \texttt{tabularx} \ \hline 8 & Multi-page tables & \texttt{longtable} \ \hline 9 & Images inside cells & \texttt{graphicx} \ \hline 10 & Combined stress tests & Multiple packages \ \hline \end{tabular} \end{center} Each stage should first contain a minimal isolated example. Only after that example renders successfully should the new capability be combined with features from earlier stages.