STATIC WEBSITE GENERATORS
To start a development server and watch for file changes:
Sometimes when watching for changes the server will get out-of-sync with the current state of the files. If this is happening frequently, you can use the
--disableFastRender flag to force Hugo to rebuild from scratch each time there are changes.
However, this will slow down build times, which may become an issue for larger sites.
You can tell Hugo to automatically remove whitespace between HTML tags and template output by adding the hyphen
- next to the
will result in:
will result in (notice that whitespace is removed):
I recommend to add whitespace removing hyphens to all template delimiters
}} unless you explicitly need the whitespace. Leaving the whitespace in can cause unexpected issues when the markdown parser interprets it as special formatting (e.g. wraps everything in an unwanted code block due to indentation being present).
You can easily debug variables by printing them to the HTML and then viewing the output in your browser (by building the site).
You can print a variable by just doing:
However, it is not easy to print messages to the hugo command line, which would be helpful in cases where you can’t print to the page, e.g. when the page is failing to render.
Page Rendering Timeouts
Hugo has a built in per-page rendering timeout, which by default is set to
10s. This is designed to detect recursive error conditions for shortcodes and partials when they include themselves without proper terminating conditions, causing infinite recursion. However, this timeout can also be incorrectly triggered when pages have a lot of image resources that need processing. You may see an error similar to:
This may occur only on your build server but not locally due to typically lower performant hardware being available on build servers. This error occurred for me when building on Netlify but not when building locally.
Luckily, you can increase the timeout by adding/adjusting the
timeout parameter in
config.toml at the root directory of the Hugo project. As of v0.60.1, Hugo supports postfixes such as
s to the end of the timeout so you don’t have to specify it in milliseconds (v0.60.0 added this feature, but included a bug which caused it to work incorrectly).
Remove Build Cache
If you need remove build cache, make sure to delete both the
You will typically get this error when you forget to add a leading
> prefix to the closing
}} of a shortcode.
This work is licensed under a Creative Commons Attribution 4.0 International License .