Skip to main content
The config/_default/params.toml file controls all theme-specific settings for the Congo theme. This is where you customize colors, layouts, and feature toggles.

​
Appearance

Control the visual appearance and color scheme of your site.
​
colorScheme
string
default:"congo"
The color scheme to use for the theme. Options include congo, avocado, cherry, fire, ocean, sapphire, and slate.
colorScheme = "congo"
​
defaultAppearance
string
default:"light"
The default appearance mode. Valid options are light or dark.
defaultAppearance = "light"
​
autoSwitchAppearance
boolean
default:"true"
Automatically switch between light and dark mode based on the user’s system preferences.
autoSwitchAppearance = true

​
Features

Enable or disable specific site features.
​
enableSearch
boolean
default:"false"
Enable the built-in search functionality.
enableSearch = false
​
enableCodeCopy
boolean
default:"false"
Add a copy button to code blocks for easy copying.
enableCodeCopy = false
​
enableImageLazyLoading
boolean
default:"true"
Enable lazy loading for images to improve page load performance.
enableImageLazyLoading = true
​
fingerprintAlgorithm
string
default:"sha256"
The algorithm to use for generating asset fingerprints (for cache busting).
fingerprintAlgorithm = "sha256"

​
Header layout

Configure the site header appearance.
​
header.layout
string
default:"basic"
The header layout style. Valid options are basic, hamburger, hybrid, or custom.
[header]
  layout = "basic"
Path to the logo image file (relative to the assets/ directory).
[header]
  logo = "img/logo.jpg"
​
header.showTitle
boolean
default:"true"
Whether to display the site title in the header.
[header]
  showTitle = true
Customize the footer appearance and content.
​
footer.showCopyright
boolean
default:"true"
Display the copyright notice in the footer.
[footer]
  showCopyright = true
​
footer.showThemeAttribution
boolean
default:"true"
Show attribution to the Congo theme in the footer.
[footer]
  showThemeAttribution = false
​
footer.showAppearanceSwitcher
boolean
default:"false"
Display a light/dark mode switcher in the footer.
[footer]
  showAppearanceSwitcher = false
​
footer.showScrollToTop
boolean
default:"true"
Show a scroll-to-top button in the footer.
[footer]
  showScrollToTop = true

​
Homepage layout

Configure how the homepage is displayed.
​
homepage.layout
string
default:"page"
The layout template for the homepage. Valid options are page, profile, or custom.
[homepage]
  layout = "profile"
​
homepage.showRecent
boolean
default:"false"
Display recent posts on the homepage.
[homepage]
  showRecent = true
​
homepage.recentLimit
integer
default:"5"
The number of recent posts to display on the homepage.
[homepage]
  recentLimit = 5

​
Article layout

Control the display of article pages.
​
article.showDate
boolean
default:"true"
Display the publication date on articles.
[article]
  showDate = true
​
article.showAuthor
boolean
default:"true"
Display the author information on articles.
[article]
  showAuthor = true
​
article.showReadingTime
boolean
default:"true"
Display estimated reading time for articles.
[article]
  showReadingTime = true
​
article.showTableOfContents
boolean
default:"false"
Automatically generate and display a table of contents.
[article]
  showTableOfContents = true
​
article.showHeadingAnchors
boolean
default:"true"
Display anchor links on headings for easy sharing.
[article]
  showHeadingAnchors = true
​
article.showPagination
boolean
default:"true"
Show next/previous article navigation at the bottom of articles.
[article]
  showPagination = true

​
List layout

Configure how content lists are displayed.
​
list.showSummary
boolean
default:"false"
Display post summaries in list views.
[list]
  showSummary = false
​
list.groupByYear
boolean
default:"true"
Group list items by year.
[list]
  groupByYear = true
​
list.paginationWidth
integer
default:"1"
The number of page links to show on each side of the current page in pagination.
[list]
  paginationWidth = 1

​
Complete example

Here’s a condensed version of the params.toml file:
config/_default/params.toml
colorScheme = "congo"
defaultAppearance = "light"
autoSwitchAppearance = true

enableSearch = false
enableCodeCopy = false
enableImageLazyLoading = true

fingerprintAlgorithm = "sha256"

[header]
  layout = "basic"
  showTitle = true

[footer]
  showCopyright = true
  showThemeAttribution = false
  showAppearanceSwitcher = false
  showScrollToTop = true

[homepage]
  layout = "profile"
  showRecent = true
  recentLimit = 5

[article]
  showDate = true
  showAuthor = true
  showReadingTime = true
  showTableOfContents = true
  showHeadingAnchors = true
  showPagination = true

[list]
  showSummary = false
  groupByYear = true
  paginationWidth = 1
The complete params.toml file includes many more options for analytics, verification, and advanced features. See the Congo theme documentation for all available parameters.

Build docs developers (and LLMs) love

Get started for freeTalk to us