Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Integrating LaTeXML into TeX editors
On Linux/Mac, create a file latexmlc-html.sh with the following content:
#!/bin/sh latexmlc --dest "$1.html" "$1.tex"
and similarly a file latexmlc-epub.sh:
#!/bin/sh latexmlc --dest "$1.epub" "$1.tex"
On Windows, create two files latexmlc-html.bat and latexmlc-epub.bat:
@latexmlc --dest "%1.html" "%1.tex"
@latexmlc --dest "%1.epub" "%1.tex"
Now, in TeXworks go to Edit → Preference → Typesetting. In Processing Tools, add two new
LaTeXML HTML5 and
LaTeXML EPUB3 modes with the following configuration:
Name: LaTeXML HTML5 Program: latexmlc-html Arguments: $basename [ ] View PDF after running Name: LaTeXML EPUB3 Program: latexmlc-epub Arguments: $basename [ ] View PDF after running
These modes will then appear in the drop-down menu of the main toolbar. You can now generate HTML5 and EPUB3 files by selecting the new corresponding LaTeXML mode and clicking on the green "Typeset" button.
Note: LaTeXML does not have non-zero exit status code when a parsing error happens. If you wish to see the result of LaTeXML in the console ouput, you can add a line "exit 1" (Linux/Mac) at then end of the script files.
LaTeXML currently has a bug with the babel package. So if you want to use LaTeXML with LyX, first disable babel in Tools → Preferences → Languages Settings → Language Package.
Now in Tools → Preferences → File Handling → File Formats, create two new formats "HTML5" and "EPUB3" with respective short names html5/epub and extensions html/epub. Check the boxes "Document format" & "Show in export menu" and choose your favorite browser/reader as a viewer. For "HTML5", use the same copier as for the existing "HTML" format:
python -tt $$s/scripts/ext_copy.py -e html,png,css $$i $$o, so that the files will be copied into one directory.
In Tools → Preferences → File Handling → Converters add two converters from "LaTeX (plain)" to "HTML5" & "EPUB3" respectively. In the Converter field, use the command
latexmlc --dest $$o $$i. The LyX interface to export/preview the LaTeX document should now be able to handle the HTML5/EPUB3 formats!
Note: we are working on making these integrated in the default configuration of LyX when LaTeXML is detected on the system