1.4 FAQs

Q: Error: Warning: no .tex files with \documentclass found in this directory

  • A: The software cannot reach your files, this may be due to running the software in the wrong place, permissions, or a remote directory. Double check your file path, and try moving the files to a local directory and try again.

Q: Why aren’t my files converting at all, there is not an error, BookML simply states there are no files to convert.

  • A: This is likely due to the fact that the software cannot reach your files. This can be because your files are in a folder, or that your files have forbidden file characters or a space.

Q: The conversion process is taking a very long time.

  • A: The conversion process can take a while, especially for larger documents — but if it’s 30 minutes or more, then please flag this. Note that, if you are using a local installation (not Docker), there are some known issues related to this:

    • –
      ​

      There is a known issue with the package expl3 when used with TeXlive 2022 and older which can cause the conversion to take longer.

    • –
      ​

      There is a known issue with the “postprocessing XSLT” stage taking several minutes (instead of seconds) on Ubuntu 22.04.

Q: Will my .tex files be converted if I comment out \documentclass?

  • A: Yes, and it may cause errors. For files which you don’t want to be converted standalone (e.g. files which are \inputted into another file), delete the \documentclass command entirely or move them into a folder.