Basic Configuration

Here is the default configuration and basic parameters for your website. You can change those as per your requirements.

Default configuration

In this project folder, you will find a file called config/_default/config.toml. Open this file in any text editor or IDE.

For maintaining it from forestry, you can find it at the bottom of the left sidebar. The file called Configuration

  1. baseURL field for your website URL / domain. Add your site URL here. Remember, you need to add a trailing slash at the end of the URL.
  2. disableLanguages field is for disabling languages. If you don’t want to show one or multiple languages, then you can add the language name here. It will disable those languages from your site. For example, disableLanguages = ["fr"] will disable the french language from your site.
  3. title is for the main title of your website.
  4. theme sets up the used theme. If your theme is located in my-project/themes/theme-name folder, then the value for this parameter is theme-name.
  5. summaryLength decides how many words are in excerpts of your posts when they are displayed as a preview. The default summaryLength is 70 words.
  6. paginate set the number of posts shown on blog overview pages. If you have more than this amount of posts, pagination will be visible to navigate the next set of posts.
  7. disqusShortname add your Disqus shortname to enable comments on the blog section. To install Disqus please follow this tutorial.
  8. googleAnalytics add your Google Analytics ID to enable analytics on all pages. # example: UA-123-45. For more info, read the article. If you want another third-party analytics, you can contact us for custom service.

Default Parameters

In this project folder, you will find a file called config/_default/params.toml. Open this file in any text editor or IDE.

For maintaining it from forestry, you can find it at the bottom of the left sidebar. The file called Parameters

  1. favicon is for your website favicon. Place your favicon in the assets/images folder and put the path here.
  2. logo is for your website logo. Place your logo in the assets/images folder and put the path here.
  3. description is for your default meta description. It shows on your homepage and other pages that have no meta description on this page front-matter.
  4. author is for the website author name. It is used in the meta author tag.
  5. image is used as the fallback for open graph and twitter card if a page has no image of its own.
  6. contact_form_action is for activate your contact form. As Hugo generates a static site, so you need to activate this form by a third-party service. You can use any of them Airform, formspree, or Formsubmit. Go to any of the sites that you preferred, and get your form action from there. Then, paste it here. If you use Airform, your form action will be like this: https://airform.io/your@email.com.
  7. mainSections defines the section names that you want to show on your website. It’s an array, so you can add more sections to show. For more information, see Official docs.
  8. contact_info has some filed (like phone, email, and address) to show your contact information in the footer and contact page.
  9. preloader is for your website preloader, which means it will show up until your website loads properly in the background. You can enable or disable preloader by setting the value of enable as true or false. If you want to put any image, logo, or animation as your preloader, give the file location in the preloader = , ex: preloader = images/preloader.gif. If you don’t want any logo or image, leave the preloader field empty. So it will show just a white screen when every component is loading.
  10. social is a loop item for your website’s social icons. You can add a loop item by following the existing loop. We are using Font Awesome icon pack for this theme. You can choose more icons from here
  1. google_analitycs_id is to turn on google analytics on your site, give your won analytics ID here.
  2. navigation_button is for main navigation button, you can enable or disable it.
  3. 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).
  4. 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.
Improve this page on Github  — Last updated:  Thu, Sep 9, 2021