Troubleshoot - joaomlourenco/novathesis GitHub Wiki

Troubleshoot

Focus: Fixing errors, warnings, and unexpected visual artifacts.

I see a black square/rectangle at the end of a line!

This is the Overfull hbox indicator. It appears because a line of text is slightly too long and "bleeding" into the margin.

  • Fix: Change the documentclass option from draft to final. However, it is better to fix the spacing or hyphenation in that specific line first!

The spacing in my glossary is not uniform!

If you find the vertical gaps between glossary groups inconsistent, add this to your preamble (before \begin{document}):

\renewcommand{\glsgroupskip}{}

Error: "geometry" package version mismatch

The template requires geometry v5.0 (2010) or later. If you see this error, your LaTeX distribution is likely very outdated. Solution: Run an update via MiKTeX Console or TeX Live Utility.

Cleaning up Mendeley/Zotero exports

Exported .bib files often contain "junk" fields (like abstract or file) that break compilation. See our guide on Cleaning the Bibliography for scripts to automate this.

Still stuck?