Merge pull request #85 from neilt/update_latexml_status

Update LaTeXML status and add some notes about lwarp
ehuelsmann · Mar 11, 2024 · ce7d137 · ce7d137
2 parents a063414 + 03bed0b
commit ce7d137
Show file tree

Hide file tree

Showing 2 changed files with 66 additions and 33 deletions.
diff --git a/README.md b/README.md
@@ -15,9 +15,11 @@ The source for the LedgerSMB Book can be found on [github](https://github.com/eh
 The book should build with any recent LaTeX installation. The book is expected to produce both HTML and PDF and is currently tested with:
 
 * LaTeXML version 0.8.7
-* TeX Live 2022
+* TeXLive 2022
 
-All documents can be built locally by running the script `local-build.sh --use-pdf-latex`. This will create a directory called `local-build` that contains the book in PDF, single page HTML, and multi-page HTML formats.
+Note: TexLive 2023 fails to build with LaTeXML 0.8.7.  However, LaTeXML 0.8.8 will work with TexLive 2023, it just takes 25 minutes to build. The long build time is an acknowledged bug, but it is not clear if that bug is in LaTeXML or LaTeX.
+
+All documents can be built locally by running the script `local-build.sh --use-latex-mk`. This will create a directory called `local-build` that contains the book in PDF, single page HTML, and multi-page HTML formats.
 
 The Book also builds in PDF format without using the `local-build.sh` script using: 
 

diff --git a/scripts/development-notes.md b/scripts/development-notes.md
@@ -37,21 +37,72 @@ sudo shutdown -r now
 
 ## Experimenting with alternative converters to HTML
 
+See [https://texfaq.org/FAQ-LaTeX2HTML](https://texfaq.org/FAQ-LaTeX2HTML)
+
+### TeX4ht
+
+Not tested.
+
 ### LaTeXML
 
-LaTeXML version 0.8.7 has problems with TeX Live 2023. The conversion hangs. The problem is known at LaTeXML upstream, but as of 19 Nov 2023 no solution has been released.
+LaTeXML version 0.8.7 has problems with TeX Live 2023. The conversion hangs. The problem is known at LaTeXML upstream, but as of 9 March 2024 no solution has been released.
+
+[Issue 2064](https://github.com/brucemiller/LaTeXML/issues/2064)
 
 [Issue 2109](https://github.com/brucemiller/LaTeXML/pull/2109)
 
+[Issue 2124](https://github.com/brucemiller/LaTeXML/issues/2124)
+
 [Issue 2151](https://github.com/brucemiller/LaTeXML/pull/2151)
 
-[Issue 2064](https://github.com/brucemiller/LaTeXML/issues/2064)
+Fixes have been merged, waiting on release. Release 0.8.8 did not complely fix the problem for LSMB.  Still takes a long time to run?
 
-[Issue 2124](https://github.com/brucemiller/LaTeXML/issues/2124)
+### lwarp
 
-Fixes have been merged, waiting on release.
+lwarp does not handle items like:
 
-### hevea (19 Nove 2023)
+```
+\begin{description}[style=nextline]
+\item[Balance Sheet] Provides a snapshot of the .....
+\end{description}
+```
+Does seem to work when when `style=standard`.
+
+Multipage HTML not working.
+
+### LaTeX2HTML (19 Nov 2023)
+
+[Github Source](https://github.com/latex2html/latex2html)
+
+[Home Page CTAN](https://www.ctan.org/pkg/latex2html)
+
+[Home Page](https://www.latex2html.org)
+
+```bash
+latex2html -help
+perldoc latex2html
+
+LaTeX2HTML ledgersmb-book.tex
+
+*********** WARNINGS ***********  
+No implementation found for style `lmodern'
+No implementation found for style `url'
+No implementation found for style `palatino'
+No implementation found for style `enumitem'
+No implementation found for style `makecell'
+No implementation found for style `glossaries'
+No implementation found for style `metalogo'
+
+Substitution of arg to newlabelxx delayed.
+
+? brace missing for \oldnewlabel
+
+Unknown commands: acrshort footref printglossary setlist makecell else makeglossaries protected_at_file_at_percent LaTeXML ifdefined protected cleardoublepage fi ifpdf bullet XeLaTeX newacronym glspl newglossaryentry gls hypersetup 
+Done.
+
+```
+
+### hevea (19 Nov 2023)
 
 [Github Source](https://github.com/maranget/hevea)
 
@@ -91,34 +142,14 @@ Adios
 
 ```
 
-### LaTeX2HTML (19 Nove 2023)
-
-[Github Source](https://github.com/latex2html/latex2html)
-
-[Home Page CTAN](https://www.ctan.org/pkg/latex2html)
-
-[Home Page](https://www.latex2html.org)
-
-```bash
-latex2html -help
-perldoc latex2html
-
-LaTeX2HTML ledgersmb-book.tex
+### TtH
 
-*********** WARNINGS ***********  
-No implementation found for style `lmodern'
-No implementation found for style `url'
-No implementation found for style `palatino'
-No implementation found for style `enumitem'
-No implementation found for style `makecell'
-No implementation found for style `glossaries'
-No implementation found for style `metalogo'
+However the resulting HTML does not really reach modern standards, and only very simple mathematics can be converted.
 
-Substitution of arg to newlabelxx delayed.
+### plasTeX
 
-? brace missing for \oldnewlabel
+Python based, not interested in adding python as a project requirement.
 
-Unknown commands: acrshort footref printglossary setlist makecell else makeglossaries protected_at_file_at_percent LaTeXML ifdefined protected cleardoublepage fi ifpdf bullet XeLaTeX newacronym glspl newglossaryentry gls hypersetup 
-Done.
+### TeXpider
 
-```
+Commercial, does not fit open source model