配置 - Hugo Bootstrap

如示例站點所示，我們使用 Configuration Directory 為了維護更簡單的組織和特定於環境的設置，它在多語言站點上特別有用。

站點配置

站點配置文件默認為 config/_default/config.toml。

名稱	類型	默認值	說明
`title`	String	-	站點標題
`baseURL`	String	-	站點 URL
`copyright`	String	-	站點版權。`{year}` 占位符會被替換為當前年份。
`defaultContentLanguage`	String	`en`
`defaultContentLanguageInSubdir`	Boolean	`false`
`paginate`	Integer	`10`
`paginatePath`	String	`page`
`enableRobotsTXT`	Boolean	`true`
`disqusShortname`	String	-	Disqus shortname。
`googleAnalytics`	String	-	Google Analytics.
`social`	Object	-	社交鏈接。
`author`	Object	-	作者小部件。

請參閱 All Configuration Settings 。

站點參數

站點參數文件默認為 config/_default/params.toml。

名稱	類型	默認值	說明
Page
`mainSections`	Array	`["posts"]`	主要的 sections
`titleCase`	Boolean	`false`	標題首字母是否大寫
`titleSeparator`	String	`-`	標題分隔符
`backgroundImage`	Array	`[]`	背景圖，如：`['/images/bg.png']`, `['/images/bg-light.png', '/images/bg-dark.png']`。
`comment`	Boolean	`true`	是否開啟評論
`toc`	Boolean	`true`	是否開啟目錄
`tocPosition`	String	`sidebar`	可選值：`sidebar` 和 `content`，僅作用於 `post` 佈局。
`tocWordCount`	Integer	`280`	僅當文章的字數超過此值時，才會顯示目錄。
`breadcrumb`	Boolean	`true`	是否開啟面包屑導航
`breadcrumbDivider`	String	`/`	面包屑導航分隔符
`dateFormat`	String	`Jan 2, 2006`	日期格式。查閱 Hugo Date and Time Templating Reference 以獲取詳細信息。
`poweredBy`	Boolean	`true`	是否顯示技術支持。
`readingTime`	Boolean	`true`	是否顯示閱讀時間
`postDate`	Boolean	`true`	是否顯示發表日期
`math`	Boolean	`false`	是否開啟 `math`。
`diagram`	Boolean	`false`	是否開啟 `diagram`。
`logo`	String/Boolean	`images/logo.webp`	Logo。設置為 `false` 以禁用 Logo。
`brand`	String	-	Brand
`description`	String	-	站點描述
`keywords`	String	-	站點關鍵詞
`color`	String	-	顏色風格， `light`，`dark` 或者 dynamic（默認）。
`palette`	String	-	默認配色，清理 Cookie 後生效。
`palettes`	Array	ALL	可選配色，如需禁用此選項，可將其設為空值 `[]`。
`featuredPostCount`	Integer/Boolean	`5`	精選文章數，`false` 則隱藏。
`recentPostCount`	Integer/Boolean	`5`	最近文章數，`false` 則隱藏。
`relatedPostCount`	Integer/Boolean	`5`	相關文章數，`false` 則隱藏。
`categoryCount`	Integer/Boolean	`10`	分類數，`false` 則隱藏。
`tagCount`	Integer/Boolean	`10`	標簽數，`false` 則隱藏。
`seriesCount`	Integer/Boolean	`10`	專欄數，`false` 則隱藏。
`taxonomyPaginate`	Integer	`10`
`taxonomySortingMethod`	String	-	分類排序方式，默認以字母排序。可選值：`popularity`.
`taxonomyPostCount`	Integer	`3`	分類的列表文章數，`false` 則隱藏。
`countTaxonomyPosts`	Boolean	`false`	是否顯示分類的文章總數。
`sidebarTaxonomies`	Array	`["series", "categories", "tags"]`	側邊欄的分類。
`fullWidth`	Boolean/Object	`false`	是否全寬
`fullWidth.{section}`	Boolean	-	爲特定的 section 定義全寬，如：`posts`, `docs`。
`fixedHeader`	Boolean	`true`	是否固定頭部
`reward`	Object	-	打賞小部件，又稱 Buy Me a Coffee 小部件。
`share`	Object	-	分享按鈕
`share.addThis`	String	-	AddThis `pubid`。
`fontSize`	Object	字體大小	註釋或刪除此參數可以禁用字體大小切換器。
`fontSize.small`	String	`.9rem`	小字體
`fontSize.extraSmall`	String	`.8rem`	更小的字體
`fontSize.large`	String	`1.1rem`	大字體
`fontSize.extraLarge`	String	`1.2rem`	更大的字體
`socialShare`	Boolean	`true`	啟用/禁用內置的分享按鈕
`searchBar`	Boolean	`true`	啟用/禁用搜索欄
Archive
`archive`	Object	-	歸檔。
`search`	Object	-	搜索。
Webmaster Site Verification
`siteVerification`	Object	-
`siteVerification.google`	String	-	Google
`siteVerification.bing`	String	-	Bing
`siteVerification.baidu`	String	-	百度
`siteVerification.baiduUnion`	String	-	百度聯盟
`siteVerification.so`	String	-	360
`siteVerification.sogou`	String	-	搜狗
`siteVerification.shenma`	String	-	神馬
Analytics
`analytics`	Object	-	Analytics.
`analytics.baidu`	String	-	百度統計
Others
`googleAdsense`	String	-	Google Adsense。
`customCSS`	Array	-	自定義 CSS，主要用於導入外部。請查閱自定義資源。
`customJS`	Array	-	自定義 JS，主要用於導入外部 JS。請查閱自定義資源。
`utterances`	Object	-	Utterances 配置。
Creative Commons License
`creativeCommons`	Object	-
`creativeCommons.by`	Boolean	`true`	署名
`creativeCommons.nc`	Boolean	`true`	非商業
`creativeCommons.nd`	Boolean	`true`	禁止演繹
`creativeCommons.sa`	Boolean	`true`	相同方式共享
Code Block
`codeBlock`	Object	-
`codeBlock.maxLines`	Integer	`7`
`codeBlock.lineNos`	Boolean	`true`	`true`/`false` 表示默認情況下顯示/隱藏行號。
Post
`post`	Object	-
`post.excerpt`	String	`Summary`	可選項：`description`
`post.excerptMaxLength`	Integer	`320`
`post.copyright`	Boolean	`true`	是否在每個帖子上顯示版權部分
`post.plainifyExcerpt`	Boolean	`true`	`false` 則格式化摘要為 HTML。
`post.featuredImage`	Boolean	`false`	於內容上方顯示 Featured 圖片。
`post.numberifyHeadings`	Boolean	`false`	是否自動對標題進行編號。
`post.numberifyHeadingsEndLevel`	Number	`6`	自動編號的深度。
`post.numberifyHeadingsSeparator`	String	-	編號和標題之間的分隔符。
`post.tocStyleType`	String	`none`	目錄的 `list-style-type` CSS 屬性。
`viewer`	Boolean	true	圖片查看器
`pwa`	Object	-	漸進式 web 應用
Sidebar
`sidebar`	Object	-
`sidebar.fixed`	Boolean	`false`	固定默認側邊欄。
`sidebar.archive`	Boolean	`true`	於側邊欄顯示歸檔掛件。
Meta Tag
`metaRobots`	String	-	空字符串表示禁用。
`contact`	Object	-	聯系表單
`pinnedPost`	Boolean	`true`	開啟/禁用文章置頂。
`pinnedPostCount`	Integer	`1`	置頂的文章數量。
`rss`	String/Boolean	`true`	在社交鏈接中顯示 RSS 鏈接。`false` 為不顯示，`home` 則總是鏈接到主頁。

除了 Google 站長工具外，其他搜索引擎站長工具無法與 hugo --minify 同時使用，這是因為它們無法識別優化後的元標簽。

頁面參數

頁面參數位於 Front Matter 。

名稱	類型	默認值	說明
Page
`description`	String	-	頁面描述
`keywords`	Array	-	頁面關鍵詞
`comment`	Boolean	`true`	是否開啟評論，如果評論已被全局關閉，該參數無效
`toc`	Boolean	`true`	是否開啟目錄，如果目錄已被全局關閉，該參數無效
`math`	Boolean	`false`	是否開啟 `math`
`diagram`	Boolean	`false`	是否開啟 `diagram`
`reward`	Boolean	`true`	是否開啟打賞
`breadcrumb`	Boolean	`true`	是否開啟面包屑導航
`readingTime`	Boolean	`true`	是否顯示閱讀時間
`postDate`	Boolean	`true`	是否顯示發表日期
`copyright`	Boolean	`true`	是否顯示版權部分
`carousel`	Boolean	`false`	是否在 Carousel 顯示
Creative Commons License
`creativeCommons`	Object	-
`creativeCommons.by`	Boolean	`true`	署名
`creativeCommons.nc`	Boolean	`true`	非商業
`creativeCommons.nd`	Boolean	`true`	禁止演繹
`creativeCommons.sa`	Boolean	`true`	相同方式共享
Meta Tag
`metaRobots`	String	-	空字符串表示禁用。
`pinned`	Boolean	`false`	置頂文章。
`featuredPostCount`	Integer/Boolean	`5`	精選文章數，`false` 則隱藏。
`recentPostCount`	Integer/Boolean	`5`	最近文章數，`false` 則隱藏。
`relatedPostCount`	Integer/Boolean	`5`	相關文章數，`false` 則隱藏。

配置

站點配置

站點參數

頁面參數

版權

評論