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.
  • title is for your site’s title.
  • 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.

  • The summaryLength decides how many words are in excerpts of your posts when they are displayed as preview. The default summaryLength is 70 words.
  • disqusShortname - add your disqus shortname to enable comments on the blog section.
  • 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.

Plugins

You can add third party plugins from here. We created a loop for plugins. You will see two plugins loop already implemented. The first one is for css and second one is for js. Copy a loop item that you need and paste it in the bottom of the loop. After you added a plugin, you need to restart the hugo server to render properly.

Default Parameters

  1. Logo field is for your site logo, you can set a default logo for your site, 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 works with formspree.
  6. google_analitycs_id is to turn on google analytics on your site, give your won analytics ID here.
  7. 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 a white screen when every component is loading.
  8. navigation_button is for main navigation button, you can enable or disable it.
  9. subscription is for user subscription, give your won subscription form action url in mailchimp_form_action field, and your form name in mailchimp_form_name field. You can get your action url and form name from here (after login or signup).
  10. map field is for google map , replace your won gmap API key with gmap_api. map_latitude and map_longitude field is for your google map location. you can find this here http://maps.google.com map_marker is for your map pointer, you can set your own map pointer that you want to show, maintain the png image size with ( 46*58) px.
  11. social is for footer social icon. it’s a loop. and we use font awesome 4.7.0: https://fontawesome.com/v4.7.0/icons/ for the icon.
  12. Language is for multilingual content. we used two language here. you can add more language following this example content.
Improve this page on Github  — Last updated:  Mon, Jan 25, 2021