Troubleshooting

Share via

Review common issues and resolutions.

Review the table below for some common issues and their potential cause. Please file a bug report if you believe you have encountered an unknown issue.

Incorrect styling of your published website may have several causes:

The stylesheet refers to the incorrect location

Be sure to update the baseURL in config/_default/hugo.toml.

The certificate of your website has expired or is not set up correctly

Hinode adds an integrity check and crossorigin validation to protect against manipulation of the site’s stylesheet. Most browsers will refuse to load the stylesheet if the website’s certicate is invalid. Ensure your certificate is valid and properly loaded, for example by clicking on the lock icon in the address bar of your browser. Check with your hosting provider if the certificate is invalid.

The DNS is not updated yet

You typically need to update address the records of your DNS provider when using a custom domain. For example, the website demo.gethinode.com  uses CloudFlare  as DNS provider and Netlify  as hosting provider. The CloudFlare DNS records includes a CNAME record that links gethinode.com to the endpoint gethinode-docs.netlify.app. It may take some time for all DNS records to have been propagated properly.

The browser has cached a previous version of the website

Your browser might retain an older copy of your website and its resources in memory. Clear the browser cache if needed and reload your website. Google Chrome provides the option to empty the cache and perform a hard reload for a specific site when using the developer tools. You can add ?nocache=1 to your address in Safari to bypass the cache.

Hinode uses a strict content security policy, which may prevent your browser from downloading external resources. See the server configuration on how to configure your server headers.

Ensure your images are stored in the assets folder instead of the static folder. See the documentation about images and figures for more details.

Add the class value img-fluid to your vector image, for example <img src="/img/logo.svg" class="img-fluid">.

Hinode uses mounts to create a virtual file system. Be sure to include mounts for the base repository and the current repository. See the documentation about mounted folders for more details.

Setting purge = true in the style section of your site parameters instructs Hinode to purge any unused styles from your generated stylesheet. The purger requires several npm packages to be installed, else it will throw an error such as Cannot find module '@fullhuman/postcss-purgecss'. You can use the Hinode template  as a starting point to set up npm and the required packages. Refer to the optimization guide for more context.

Setting build.transpiler = "dartsass" in the main section of your site parameters instructs Hinode to use the Dart Sass transpiler. Unlike the default libsass transpiler, the dartsass binary needs to be installed seperately on your machine. This includes any production servers used for CI/CD automation and deployment. If Dart Sass is not required, you can revert back to build.transpiler = "libsass". Else follow the installation instructions  on how to install the binary.

Last updated: September 6, 2023 • Include Dart Sass (e389ac2)