Basic Configuration

In this root folder you will find a file called config.toml open this file in any text editor or IDE.

If your theme is not launched in your localhost, then check the theme name is correct in config.toml file. Then run hugo server command again.

Sitewide configuration

  • At the very top you will see a baseURL field for your site URL. Add your sites URL here.
  • languageCode - define your global site language. This setting is independent from the i18n-setup you might add later on.
  • The summaryLength decides how many words are in excerpts of your posts when they are displayed as preview. The default summaryLength is 70 words.
  • theme sets up the used theme. If your theme is located in /themes/themename then the value for this parameter is themename.

    If you use theme components you can change this parameter to the following format:

    themes = ["theme1", "theme2", "themename"]
    

    Make sure, that your theme is the last item in this list. Hugo will load these themes and module from the left and files with identical names will be overwritten subsequently.

  • title is for your site’s title.
  • paginate - set the amount of posts shown on blogoverview pages. If you have more than this amount of posts a pagination will be shown to navigate to the next set of posts.
  • disqusShortname - add your disqus shortname to enable comments on the blog section.

Plugins

You can add third party plugins from here very easily, We create a loop for plugins, you will see two plugins loop here, first one is for css and last one is for js. just copy a loop item that you need and paste it in the bottom of the loop. and link correctly, after added a plugins, you maybe need to close the hugo server and run it again for rendered correctly.

Default Parameters

  1. Logo field is for your site logo, you can set a default logo for your site, just give here the logo directory.
  2. Home is for home in your navigation.
  3. description field is for your default meta description, it will show on your homepage and other page that have not any meta description on this page front-matter.
  4. author is for site author name.
  5. gmapAPI field is for google map API key, replace your won gmap API key with it.
  6. mapLatitude and mapLongitude field is for your google map location. you can find this here http://maps.google.com
  7. mapMarker is for your map pointer, you can set your won map pointer that you want to shaow, just maintain the png image size with ( 45*45) px.
  8. googleAnalitycsID is for turn on google analytics on your site, give your won analytics ID here.
  9. Contact Information is for contact page and footer. you can set your phone, email and location here.
  10. copyright is for copyright text in the very bottom of the page.
  11. preloader is for site preloader, you can enable or disable preloader by enable = true or false, then if you want any image, logo, or animation in preloader then give the location in preloader = , like preloader = images/preloader.gif or if you don’t want any logo or image then leave the preloader field empty, then it will show just a white screen when every component is loading. that’s simple.
  12. Rating is for product rating, you can enable or disable it. you need websiteID and publicKey for enable this feature. and you can get those keys from here : https://rating-widget.com/
Improve this page on Github  — Last updated:  Mon, Jan 25, 2021