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.
  • 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.
  • The summaryLength decides how many words are in excerpts of your posts when they are displayed as preview. The default summaryLength is 70 words.
  • DefaultContentLanguage - This field is for your site default language, which will load first with your site load.
  • disableLanguages field is for disable languages, if you don’t want to show one or more then one you can add the language name here, it will disabled those languages from your site. example disableLanguages = ["fr"] it will desabled french language from your site.
  • 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. 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.
  3. author is for site author name.
  4. Contact info has some filed to show your contact information in footer and contact page.
  5. contact_form_action is for contact form. it work’s with formspree.
  6. google_analitycs_id is for turn on google analytics on your site, give your won analytics ID here.
  7. search can be disabled, if it has false value.
  8. sidebar has 3 different values, choose your favorite on from left, right or false. if you choose false, it will no longer visible.
  9. layout has tow value, full or list. it changes the homepage style.
  10. 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.
  11. social is for social icons. you can choose more icons from here
  12. Language is for multilingual content. we used two languages here. you can add more language following this example content.
Improve this page on Github  — Last updated:  Thu, Mar 25, 2021