TestTableFormatting 2025-06-03 05:24:11 2026-09-06 19:14:57 Definition % 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 \usepackage{hyperref} \usepackage{xcolor} % define commands here \section*{LaTeX Table Rendering Test Suite} This entry tests LaTeX table rendering in the Physics Library make4ht pipeline. For these examples, table rows are terminated with \texttt{\textbackslash tabularnewline} rather than the traditional double-backslash notation. This avoids ambiguity introduced by text processing or editor escaping of repeated backslash characters. The tests are intentionally introduced in stages. Each stage adds only a small number of new LaTeX features so that rendering failures can be isolated. \subsection*{Test 1: Minimal Table} \begin{center} \begin{tabular}{ccc} A & B & C \tabularnewline 1 & 2 & 3 \tabularnewline 4 & 5 & 6 \tabularnewline \end{tabular} \end{center} \subsection*{Test 2: Horizontal Rules} \begin{center} \begin{tabular}{ccc} \hline A & B & C \tabularnewline \hline 1 & 2 & 3 \tabularnewline 4 & 5 & 6 \tabularnewline \hline \end{tabular} \end{center} \subsection*{Test 3: Full Grid} \begin{center} \begin{tabular}{|c|c|c|} \hline \textbf{ID} & \textbf{Name} & \textbf{Score} \tabularnewline \hline 1 & Alice & 85 \tabularnewline \hline 2 & Bob & 92 \tabularnewline \hline 3 & Carol & 78 \tabularnewline \hline \end{tabular} \end{center} \subsection*{Test 4: Alignment} \begin{center} \begin{tabular}{lcr} \hline \textbf{Left} & \textbf{Center} & \textbf{Right} \tabularnewline \hline Apple & 10 & 1.25 \tabularnewline Orange & 125 & 12.50 \tabularnewline Banana & 3 & 0.75 \tabularnewline \hline \end{tabular} \end{center} \subsection*{Test 5: Mathematics} \begin{center} \begin{tabular}{|l|c|c|} \hline \textbf{Quantity} & \textbf{Equation} & \textbf{SI Unit} \tabularnewline \hline Velocity & $v=\dfrac{dx}{dt}$ & $\mathrm{m,s^{-1}}$ \tabularnewline \hline Acceleration & $a=\dfrac{d^2x}{dt^2}$ & $\mathrm{m,s^{-2}}$ \tabularnewline \hline Force & $F=ma$ & $\mathrm{N}$ \tabularnewline \hline Energy & $E=\dfrac{1}{2}mv^2$ & $\mathrm{J}$ \tabularnewline \hline \end{tabular} \end{center} \subsection*{Test 6: Multicolumn} \begin{center} \begin{tabular}{|l|c|c|} \hline \multicolumn{3}{|c|}{\textbf{Student Grades}} \tabularnewline \hline \textbf{Student} & \textbf{Physics} & \textbf{Mathematics} \tabularnewline \hline David & A & A- \tabularnewline \hline Emma & B+ & A \tabularnewline \hline Maria & A- & B+ \tabularnewline \hline \end{tabular} \end{center} \subsection*{Test 7: Paragraph Column} \begin{center} \begin{tabular}{|l|p{8cm}|} \hline \textbf{Feature} & \textbf{Description} \tabularnewline \hline Tabular & The standard LaTeX environment for arranging information into rows and columns. \tabularnewline \hline Paragraph column & A fixed-width paragraph column allows longer text to wrap inside the table cell. \tabularnewline \hline Rendering test & This tests how make4ht converts a fixed-width LaTeX table column into HTML. \tabularnewline \hline \end{tabular} \end{center} \subsection*{Test 8: Grouped Headings} \begin{center} \begin{tabular}{|c|cc|cc|} \hline & \multicolumn{2}{c|}{\textbf{Position}} & \multicolumn{2}{c|}{\textbf{Velocity}} \tabularnewline \hline \textbf{Time} & $x$ & $y$ & $v_x$ & $v_y$ \tabularnewline \hline 0 & 0 & 0 & 10 & 20 \tabularnewline \hline 1 & 10 & 15.1 & 10 & 10.2 \tabularnewline \hline 2 & 20 & 20.4 & 10 & 0.4 \tabularnewline \hline \end{tabular} \end{center} \section*{Stage 1A Result} If all of the tables above render correctly, the basic table system is working and the earlier failure can be attributed to corruption of the traditional double-backslash table row terminator. The rendering suite therefore continues using \texttt{\textbackslash tabularnewline} so that the source remains robust when copied through the Physics Library editing pipeline. \section*{Stage 1B: Hyperlink Rendering} This stage introduces the \texttt{hyperref} package. The preamble for this stage should contain \begin{verbatim} \usepackage{hyperref} \end{verbatim} No color package is required for this stage. Hyperlinks are first tested outside a table. A second test then places the same type of hyperlink inside a table cell. This allows the general hyperlink renderer and the interaction between hyperlinks and tables to be tested separately. \subsection*{Test 9: Hyperlink Outside a Table} The following text should appear as a clickable external hyperlink: \href{https://physicslibrary.org/}{Visit Physics Library} A second hyperlink points to the LaTeX Project: \href{https://www.latex-project.org/}{Visit the LaTeX Project} If both pieces of text appear as working hyperlinks, then basic \texttt{hyperref} conversion is functioning. \subsection*{Test 10: Hyperlinks Inside Table Cells} The same hyperlink command is now placed inside ordinary table cells. \begin{center} \begin{tabular}{|l|p{8cm}|} \hline \textbf{Resource} & \textbf{Hyperlink} \tabularnewline \hline Physics Library & \href{https://physicslibrary.org/}{Open Physics Library} \tabularnewline \hline Physics Library Encyclopedia & \href{https://physicslibrary.org/encyclopedia/} {Open the Physics Library Encyclopedia} \tabularnewline \hline LaTeX Project & \href{https://www.latex-project.org/}{Open the LaTeX Project} \tabularnewline \hline \end{tabular} \end{center} \subsection*{Test 11: Hyperlink Mixed With Mathematics} This test places mathematical notation and a hyperlink in the same table without placing them in the same cell. \begin{center} \begin{tabular}{|l|c|p{6cm}|} \hline \textbf{Topic} & \textbf{Example} & \textbf{Resource} \tabularnewline \hline Velocity & $v=\dfrac{dx}{dt}$ & \href{https://physicslibrary.org/encyclopedia/Velocity.html} {Physics Library velocity entry} \tabularnewline \hline Force & $F=ma$ & \href{https://physicslibrary.org/encyclopedia/Force.html} {Physics Library force entry} \tabularnewline \hline Wave number & $k=\dfrac{2\pi}{\lambda}$ & \href{https://physicslibrary.org/} {Physics Library} \tabularnewline \hline \end{tabular} \end{center} \section*{Stage 1B Result} There are three useful outcomes from this stage. \begin{enumerate} \item If Test 9 and Tests 10--11 all work, then ordinary external hyperlinks and hyperlinks inside tables are supported by the current make4ht pipeline. \item If Test 9 works but Tests 10--11 fail, then the problem is specifically associated with hyperlinks inside the \texttt{tabular} environment. \item If Test 9 itself fails, then the problem should be investigated at the \texttt{hyperref} or make4ht configuration level before table interaction is considered. \end{enumerate} \section*{Next Rendering Stage} After the hyperlink tests are verified, the next stage will introduce color. The first color test should use only \begin{verbatim} \usepackage{xcolor} \end{verbatim} and ordinary commands such as \begin{verbatim} \textcolor{red}{Critical} \end{verbatim} It should initially avoid \begin{verbatim} \usepackage[table]{xcolor} \rowcolor \cellcolor \end{verbatim} because those commands alter table-row processing and therefore require a separate rendering test. \subsection*{Test 12: Comparing \texttt{\textbackslash PMlinkexternal} and \texttt{\textbackslash href}} This test compares the Physics Library native external-link command \texttt{\textbackslash PMlinkexternal} with the standard LaTeX \texttt{\textbackslash href} command from the \texttt{hyperref} package. The same URLs and visible labels are used in both columns. \begin{center} \begin{tabular}{|l|p{4.5cm}|p{4.5cm}|} \hline \textbf{Destination} & \textbf{\texttt{\textbackslash PMlinkexternal}} & \textbf{\texttt{\textbackslash href}} \tabularnewline \hline Physics Library & \PMlinkexternal{Physics Library}{https://physicslibrary.org/} & \href{https://physicslibrary.org/}{Physics Library} \tabularnewline \hline Physics Library Encyclopedia & \PMlinkexternal{Physics Library Encyclopedia}{https://physicslibrary.org/encyclopedia/} & \href{https://physicslibrary.org/encyclopedia/}{Physics Library Encyclopedia} \tabularnewline \hline LaTeX Project & \PMlinkexternal{LaTeX Project}{https://www.latex-project.org/} & \href{https://www.latex-project.org/}{LaTeX Project} \tabularnewline \hline \end{tabular} \end{center} \subsection*{Test 13: Colored Text Inside a Table} This test introduces the \texttt{xcolor} package. Only ordinary text color is tested here. Colored cells and colored rows are intentionally deferred to a later test because those features modify table internals. \begin{center} \begin{tabular}{|l|c|l|} \hline \textbf{Status} & \textbf{Value} & \textbf{Meaning} \tabularnewline \hline \textcolor{green}{Nominal} & 1.00 & Normal operation \tabularnewline \hline \textcolor{orange}{Warning} & 1.25 & Check system \tabularnewline \hline \textcolor{red}{Critical} & 1.75 & Immediate attention \tabularnewline \hline \textcolor{blue}{Information} & 0.50 & Informational state \tabularnewline \hline \end{tabular} \end{center} \subsection*{Test 14: Colored Mathematics} This test applies color to mathematical expressions inside table cells. \begin{center} \begin{tabular}{|l|c|} \hline \textbf{Quantity} & \textbf{Expression} \tabularnewline \hline Velocity & \textcolor{blue}{$v=\dfrac{dx}{dt}$} \tabularnewline \hline Force & \textcolor{red}{$F=ma$} \tabularnewline \hline Energy & \textcolor{green}{$E=\dfrac{1}{2}mv^2$} \tabularnewline \hline Wave number & \textcolor{orange}{$k=\dfrac{2\pi}{\lambda}$} \tabularnewline \hline \end{tabular} \end{center} \subsection*{Test 15: Colored Hyperlinks} This test combines the hyperlink capability established in the previous tests with ordinary text color. \begin{center} \begin{tabular}{|l|p{8cm}|} \hline \textbf{Method} & \textbf{Example} \tabularnewline \hline Physics Library native & \textcolor{blue}{\PMlinkexternal{Physics Library}{https://physicslibrary.org/}} \tabularnewline \hline Standard LaTeX hyperlink & \textcolor{red}{\href{https://physicslibrary.org/}{Physics Library}} \tabularnewline \hline \end{tabular} \end{center} \subsection*{Test 16: Hyperlink Color Precedence} This test determines whether hyperlink styling from the generated HTML overrides an enclosing LaTeX text color. \begin{center} \begin{tabular}{|l|p{8cm}|} \hline \textbf{Method} & \textbf{Example} \tabularnewline \hline Normal hyperlink & \href{https://physicslibrary.org/}{Physics Library} \tabularnewline \hline Color outside hyperlink & \textcolor{red}{\href{https://physicslibrary.org/}{Physics Library}} \tabularnewline \hline Color inside hyperlink label & \href{https://physicslibrary.org/}{\textcolor{red}{Physics Library}} \tabularnewline \hline Normal PM link & \PMlinkexternal{Physics Library}{https://physicslibrary.org/} \tabularnewline \hline Color outside PM link & \textcolor{green}{\PMlinkexternal{Physics Library}{https://physicslibrary.org/}} \tabularnewline \hline Color inside PM link label & \PMlinkexternal{\textcolor{green}{Physics Library}}{https://physicslibrary.org/} \tabularnewline \hline \end{tabular} \end{center} \subsection*{PDF Hyperlink Appearance} When the \texttt{hyperref} package is used with its default PDF settings, external hyperlinks may be surrounded by a colored rectangular border. For example, external URLs commonly receive a cyan border. These borders are PDF hyperlink annotations rather than table borders. They may be disabled while preserving hyperlink functionality with \begin{verbatim} \hypersetup{ pdfborder={0 0 0} } \end{verbatim} The corresponding HTML output is styled independently by the web browser and Physics Library CSS.