<div dir="ltr">Hi Jonathan, <br>(and all TeX Hour enthusiasts)<br><br>Thank you for setting aside the time to do a deep dive in LaTeXML's log messages - and for making the recording public for interested eyes to follow along.<br><div><br></div><div>Designing log messages is a curious task. There is a balance between informing the users of a tool which part of their input caused a hiccup (and how to fix it), <br></div><div>while keeping enough information in for the developers to diagnose what really went on internally.</div><div><br> </div><div>We have (relatively recently) started separating the full log from the brief log we emit on the standard error stream (STDERR), but only the full log is currently available on ar5iv. <br></div><div>As you have noticed, some parts of that can be quite impenetrable for a casual user.</div><div>It may be beneficial to put some latexml effort in crafting a painless user-facing log file going forward, also to arXiv users' benefit. And separately, continue to keep an informative developer-facing log.</div><div><br></div><div>I felt everyone's pain when you tried demystifying the ALLCAPS math grammar category blocks. They used to be trendy back in the day! Less so in 2023 I'm afraid.</div><div><br></div><div>Let me extend an invitation I've made before to everyone reading here:</div><div>Feel welcome to send any finer points our way, and to bravely open GitHub issues on the latexml [1] and ar5iv [2] repositories, respectively. <br></div><div>As you may imagine, we are busily working on a variety of upgrades, but the extra clues from the community can be quite helpful for triage.</div><br><div>Greetings,</div><div>Deyan</div><div><br></div><div>P.S. I am hoping we will soon have at least a couple of tools which can proof-listen to ar5iv from one's web browser, which will allow us to do a latexml development sprint focused on improved audio renderings.</div><div><br></div><div>[1] <a href="https://github.com/brucemiller/LaTeXML/">https://github.com/brucemiller/LaTeXML/</a></div><div>[2] <a href="https://github.com/dginev/ar5iv/">https://github.com/dginev/ar5iv/</a></div><div><br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, May 10, 2023 at 3:42 PM Jonathan Fine <<a href="mailto:jfine2358@gmail.com">jfine2358@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_quote"><div dir="ltr"><div>Hi</div><div><br></div><div>The arXiv has about 2.5 million articles, most of which have been processed with LaTeX to produce PDF. In addition, most of these LaTeX articles have been processed with LaTeXML, to produce HTML. Recently the arXix has announced it will be making this HTML available, to improve accessibility. Tomorrow's TeX Hour is about using LaTeXML to
audit accessibility of the arXiv LaTeX source.</div><div><br></div><div>TeX Hour: Thursday 11 May, 6:30 to 7:30pm BST<br>More information: <a href="https://texhour.github.io/2023/05/11/latex-access-audit-latex/" target="_blank">https://texhour.github.io/2023/05/11/latex-access-audit-latex/</a><br>Zoom URL: <a href="https://us02web.zoom.us/j/78551255396?pwd=cHdJN0pTTXRlRCtSd1lCTHpuWmNIUT09" target="_blank">https://us02web.zoom.us/j/78551255396?pwd=cHdJN0pTTXRlRCtSd1lCTHpuWmNIUT09</a><br></div><div><br></div><div>LaTeXML produces a log file, containing warnings and errors. It provides to some degree an accessibility audit of the LaTeX source files on the arXiv. Tomorrow's TeX Hour is an informal preliminary report on my efforts to use thes log files to audit arXiv source for accessibility. Results so far are outnumbered by problems, but it's early days.<br></div><div><br></div><div>Going to <a href="https://ar5iv.labs.arxiv.org/feeling_lucky" target="_blank">https://ar5iv.labs.arxiv.org/feeling_lucky</a> will send you to a random arXiv article in HTML. At the bottom of that page there is a link to the LaTeX-to-HTML conversion report (the log file), and also the arXiv PDF. Getting the LaTeX source is more work. Automating all this is one of the early problems.<br></div><div><br></div><div>wishing you safe and accessible TeXing</div><div><br></div><div>Jonathan<br></div><div><a href="https://ar5iv.labs.arxiv.org/feeling_lucky" target="_blank"></a>
</div></div>
</div></div>
</blockquote></div>