Templates (外部連結) JS and CSS assets (外部連結)
All configurations on docs content type. The blog and docs content types share most of their page and section fields, so the documented below are separate into unique fields and common fields. These are theme parameters so the fields should goes under params key.
Page configuration 此標題的連結
Unique fields 此標題的連結
Accepted fields for individual pages of type docs. All settings can be overridden in the front matter, unless explicitly noted as unsupported.
| Name | Type | Description |
|---|---|---|
docsNavCollapsed | boolean | Collapse this section by default in the sidebar navigation. Only applies to section pages. |
docsAutoCollapseCategories | boolean | Auto collapse other sections when expanding one. Cannot be overridden in the front matter. |
docsSidebarHidable | boolean | Show a button that hides the sidebar on desktop. Cannot be overridden in the front matter. |
docsIcon | string | Icon shown next to this page or section in the sidebar navigation. |
docsNavClass | string | Additional CSS class applied to the sidebar nav. |
註記
Previous/next links on docs pages only traverse other pages within the same docs section, unlike blog's previous/next links, which span the entire site.
Common fields 此標題的連結
| Name | Type | Description |
|---|---|---|
link | boolean | URL link to any internal or external page. |
breadcrumb | boolean | Show breadcrumb navigation above the page title. |
pageHeroStyle | string | Render a hero section above the page. Set to disable to turn it off for a specific page. |
pageTOCStyle | string | Where the table of contents is rendered. Accepts top, sidebar, or disable. On docs pages, top is treated the same as sidebar. |
pageKgStyle | string | Where the knowledge graph widget is rendered. See Knowledge Graph for what this widget does. |
pageShowActions | boolean | Show action buttons (e.g. share, copy link) next to the page title. |
pageShowMeta | boolean | Show publish date, last-updated date, and author info below the title. |
pageShowAuthors | boolean | Show author information. Only takes effect when pageShowMeta is enabled. |
pageShowCategories | boolean | Show the page's categories below the content. |
pageShowTags | boolean | Show the page's tags below the content. |
pageShowNext | boolean | Show previous/next page links at the bottom of the page. |
pageShowBacklinks | boolean | Show a list of pages that link back to this one. |
staleContentWarning | boolean | Show a warning when an article has not been updated in staleDays. |
staleDays | int | Number of days before an article is considered stale. |
pageNoList | boolean | Exclude this page from search indexing and from list views. |
Section configuration 此標題的連結
Unique fields 此標題的連結
| Name | Type | Description |
|---|---|---|
docsNavSort | string | Sort order for child pages in the sidebar navigation. Accepts Date, ExpiryDate, Lastmod, Length, LinkTitle, PublishDate, Title, Weight, or a page parameter prefixed with Param.. Defaults to Hugo's default page order if unset or invalid. |
Common fields 此標題的連結
| Name | Type | Description |
|---|---|---|
breadcrumb | boolean | Show breadcrumb navigation above the page title. |
listScope | string | Which pages to list. Set to site to list every regular page on the site, or leave unset to list only pages within the current section. |
sectionGroupBy | string | Group listed pages under headings. Accepts Date, ExpiryDate, Lastmod, PublishDate, or a page parameter prefixed with Param. (e.g. Param.category). Leave unset to disable grouping. |
sectionGroupLayout | string | Date format used for group headings when sectionGroupBy is a date field. See layout strings (外部連結). |
sectionGroupOrder | string | Order of groups. Accepts asc or desc. |
sectionSortBy | string | Sort key for listed pages within each group. Accepts Date, ExpiryDate, Lastmod, Length, LinkTitle, PublishDate, Title, Weight, or a page parameter prefixed with Param.. |
sectionSortOrder | string | Sort order. Accepts asc or desc. |