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 isthemename
.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 defaultsummaryLength
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. exampledisableLanguages = ["fr"]
it will desabled french language from your site.disqusShortname
- add your disqus shortname to enable comments on the blog section.googleAnalytics
- add your Google Analytics ID to enable analytics on all pages
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
Logo
field is for your site logo, you can set a default logo for your site, just give here the logo directory.logo_width
: define your logo width for perfect fit.menu_align
: You can set itleft
,right
, orcenter
.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.author
is for site author name.- Contact info has some filed to show your contact information in footer and contact page.
contact_form_action
is for contact form. it work’s with formspree.search
can be disabled, if it hasfalse
value.featured_post
: At the homepage, you can see a section at top, which is contain 3 types of post, This is the featured post section. If you don’t need it, you can set the value tofalse
.sidebar
has 3 different values, choose your favorite on from left, right or false. if you choose false, it will no longer visible.main_taxonomy
: You can choose the main taxonomy which is showing at the banner and post card also. Your optional value istag
andcategory
.post_layout
: You have three different value to choose for your post layout.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 inpreloader =
, likepreloader = 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.social
is for social icons. you can choose more icons from here- Language is for multilingual content. we used two languages here. you can add more language following this example content.
instafeed
: You can set the value tofalse
if you don’t want to show it. We provide some static image with the theme, but whenever you give theaccess token
it will automatically show up the original image from your instagram.[params.subscription]
is for user subscription database. We used mailchimp service for our theme development. Replace your own subscription form action URL inmailchimp_form_action
field, and your form name inmailchimp_form_name
field. You can get your action URL and form a name from here (after login or signup).widgets
: All sidebar widgets are customizable. Here is the available widgets that we provided with the themesearch
,about-me
,authors
,categories
,tags
,recent-post
,social
,promotion
,subscription
promotion
is a sidebar widget, you can change the content and link from here.about_me
is also a sidebar widget. It’s for single author user. You can change the content from here. [this section is under the language, because it could be multilingual]