DCAD Digital Help Guides

This can be quite common due to the variety of ways that LaTeX documents can be authored. Based upon early testing, we’ve found that this can be caused by one of the following issues:

1. Using unsupported LaTeX packages – Chirun supports many LaTeX packages, but it may be that you’re using something that isn’t yet supported. To check, visit the LaTeX compatibility — Chirun 0.8.0 documentation web page.
2. Commands specific to PDF output – Your document may have a very long preamble, containing commands which change the layout of the page or font sizes and styles. While these are important for the PDF output, they will not have any effect in HTML output. To get around this, you can create short conditional statements using \ifplastex.
3. Multi-file naming issue – In LaTeX, the \input{name} command is used to include the content of another file into your main file. However, Chirun only works correctly if the file name.tex does not exist. If it finds name.tex, Chirun expects it to include a special LaTeX command called \begin{document}, which is typically only in the main LaTeX file, not in files meant for \input. To fix this issue, rename all input files to remove the .tex extension. This ensures Chirun doesn’t try to process the input files incorrectly.

Visit the diagnosing errors in Chirun packages section of the staff guide for further information.