https://v0-122-0--gohugoio.netlify.app/categories/troubleshooting/Recent content in troubleshooting on HugoHugo -- gohugo.ioenhttps://v0-122-0--gohugoio.netlify.app/troubleshooting/audit/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/troubleshooting/audit/There are several conditions that can produce errors in your published site which are not detected during the build. Run this audit before your final build. HUGO_MINIFY_TDEWOLFF_HTML_KEEPCOMMENTS=true HUGO_ENABLEMISSINGTRANSLATIONPLACEHOLDERS=true hugo && grep -inorE "<\!-- raw HTML omitted -->|ZgotmplZ|\[i18n\]|\(<nil>\)|(<nil>)|hahahugo" public/ Tested with GNU Bash 5.1 and GNU grep 3.7. Example output Explanation Environment variables HUGO_MINIFY_TDEWOLFF_HTML_KEEPCOMMENTS=true Retain HTML comments even if minification is enabled. This takes precedence over minify.tdewolff.html.keepComments in the site configuration. If you minify without keeping HTML comments when performing this audit, you will not be able to detect when raw HTML has been omitted.https://v0-122-0--gohugoio.netlify.app/troubleshooting/logging/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/troubleshooting/logging/Command line Enable console logging with the --logLevel command line flag. Hugo has four logging levels: error Display error messages only. hugo --logLevel error warn Display warning and error messages. hugo --logLevel warn info Display information, warning, and error messages. hugo --logLevel info debug Display debug, information, warning, and error messages. hugo --logLevel debug If you do not specify a logging level with the --logLevel flag, warnings and errors are always displayed.https://v0-122-0--gohugoio.netlify.app/troubleshooting/inspection/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/troubleshooting/inspection/Use the jsonify function to inspect a data structure: <pre>{{ jsonify (dict "indent" " ") .Params }}</pre> { "date": "2023-11-10T15:10:42-08:00", "draft": false, "iscjklanguage": false, "lastmod": "2023-11-10T15:10:42-08:00", "publishdate": "2023-11-10T15:10:42-08:00", "tags": [ "foo", "bar" ], "title": "My first post" } Hugo will throw an error if you attempt to use the construct above to display context that includes a page collection. For example, in a home page template, this will fail: {{ jsonify (dict "indent" " ") .https://v0-122-0--gohugoio.netlify.app/troubleshooting/deprecation/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/troubleshooting/deprecation/When a project deprecates something, they are telling its users: Don’t use Thing One anymore. Use Thing Two instead. We’re going to remove Thing One at some point in the future. Common reasons for deprecation: A feature has been replaced by a more powerful alternative. A feature contains a design flaw. A feature is considered extraneous, and will be removed in the future in order to simplify the system as a whole.https://v0-122-0--gohugoio.netlify.app/troubleshooting/performance/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/troubleshooting/performance/Template metrics Hugo is fast, but inefficient templates impede performance. Enable template metrics to determine which templates take the most time, and to identify caching opportunities: hugo --templateMetrics --templateMetricsHints The result will look something like this: Template Metrics: cumulative average maximum cache percent cached total duration duration duration potential cached count count template ---------- -------- -------- --------- ------- ------ ----- -------- 36.037476822s 135.990478ms 225.765245ms 11 0 0 265 partials/head.html 35.920040902s 164.https://v0-122-0--gohugoio.netlify.app/troubleshooting/faq/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/troubleshooting/faq/Hugo’s forum is an active community of users and developers who answer questions, share knowledge, and provide examples. A quick search of over 20,000 topics will often answer your question. Please be sure to read about requesting help before asking your first question. These are just a few of the questions most frequently asked by new users. An error message indicates that a feature is not available. Why? Hugo is available in two editions: standard and extended.