It is possible to carry out many customizations without editing any code in the themes/hugo-nsd/ folder, making it easier to update the framework in the future.
Menu The [[menu.main]] entries towards the bottom of config.toml define the navigation links at the top of the website. They can be added or removed as desired.
To create a dropdown sub-menu, add identifier = "something" to the parent item and parent = "something" to the child item.
This quick tutorial will show you how to setup and use Hugo-nsd.
Core parameters The core parameters for the website can be edited in the config.toml configuration file:
Set baseurl to your website URL (we recommend GitHub Pages for free hosting) Set title to your desired website title such as your name The example Disqus commenting variable should be cleared (e.g. disqusShortname = "") or set to your own Disqus shortname to enable commenting Edit your details under [params]; these will be displayed mainly in the homepage about and contact widgets (if used).
Both the interface and content language can be changed to suit your needs.
Interface The Interface Language is used to change the language throughout your site. The following interface languages are currently available: English, 中文 (简体), Español, Português, Deutsch, Euskara, Français, Italiano, 한국어, Nederlands, Polski, Русский, Türkçe, and Tiếng Việt.
The interface text is stored in language files which are collected in the themes themes/hugo-nsd/i18n/ folder, as well as an i18n/ folder at the root of your project.
Sitescan be deployed in a large variety of ways due to the static nature of the generated website. The recommended deployment method alongside a few of the other most popular techniques are described below.
If using Netlify, your site will be built automatically, otherwise run the hugo command in your terminal to generate your site in the public/ folder - now it is ready to copy across to your host.
If you installed by Git cloning hugo-nsd Before updating for the first time, the remote origin repository should be renamed to upstream:
$ cd themes/hugo-nsd $ git remote rename origin upstream To list available updates:
$ cd themes/hugo-sd $ git fetch upstream $ git log –pretty=oneline –abbrev-commit –decorate HEAD..upstream/master Then, update by running:
$ git pull upstream Troubleshooting Check out the release notes for the version that you are updating to, paying attention to the breaking changes.
Content can be written using Markdown, LaTeX math, and Hugo Shortcodes. Additionally, HTML may be used for advanced formatting. This article gives an overview of the most common formatting options.