Theme Layout Options

The following options control theme layout.

Navbar Config

navbar Recommended

• Type: NavbarOptions | false
• Default: false
• Details:
  • Layout → Navbar → Navbar links
  • Layout → Navbar → Disable Navbar

Navbar config.

navbarLayout

• Type: NavbarLayoutOptions

  /**
   * Built-in Navbar component
   */
  type NavbarComponent =
    | "Brand"
    | "Links"
    | "Language"
    | "Search"
    | "Outlook"
    | "Repo";
  
  /**
   * Navbar layout options
   */
  interface NavbarLayoutOptions {
    start?: (NavbarComponent | string)[];
    center?: (NavbarComponent | string)[];
    end?: (NavbarComponent | string)[];
  }

• Default: { start: ["Brand"], center: ["Links"], end: ["Language", "Repo", "Outlook", "Search"] }

• Details:

  • Layout → Navbar → Navbar layout

Customize navbar layout.

logo Recommended

• Type: string
• Required: No
• Details:
  • Layout → Navbar → Site Logo

Navbar logo, should be absolute path relative to .vuepress/public folder.

logoDark

• Type: string
• Default: logo
• Details:
  • Layout → Navbar → Site Logo

Navbar logo in dark mode, should be absolute path relative to .vuepress/public folder.

navbarTitle

• Type: string
• Default: $siteLocale.title

Navbar title, you can set it to an empty string to hide it.

repo

• Type: string
• Required: No
• Details:
  • Layout → Navbar → Git Repository and Edit Links

Repository link

repoDisplay

• Type: boolean
• Default: true
• Details:
  • Layout → Navbar → Git Repository and Edit Links

Whether display repo link in navbar.

repoLabel

• Type: string
• Required: No
• Details:
  • Layout → Navbar → Git Repository and Edit Links

Repository aria label of navbar.

navbarAutoHide

• Type: "always" | "mobile" | "none"
• Default: "mobile"

Whether to hide navbar when scrolling down.

hideSiteNameOnMobile

• Type: boolean
• Default: true

Whether hide site title on mobile.

Sidebar Config

For guide, see Layout → Sidebar.

sidebar Recommended

• Type: SSidebarOptions
• Default: "structure"

Sidebar Config.

sidebarSorter Root only

• Type: SidebarSorter

  import type {
    ThemeNormalPageFrontmatter,
    ThemePageData,
  } from "vuepress-theme-hope";
  
  interface SidebarFileInfo {
    
  type
  : "file";
    
  filename
  : string;
  
    
  title
  : string;
    
  order
  : number | null;
    
  path
  ?: string | null;
  
    
  frontmatter
  : ThemeNormalPageFrontmatter;
    
  pageData
  : ThemePageData;
  }
  
  interface SidebarDirInfo {
    
  type
  : "dir";
    
  dirname
  : string;
    
  children
  : 
  SidebarInfo
  [];
  
    
  title
  : string;
    
  order
  : number | null;
  
    
  groupInfo
  : {
      
  icon
  ?: string;
      
  collapsible
  ?: boolean;
      
  link
  ?: string;
    };
  
    
  frontmatter
  : ThemeNormalPageFrontmatter | null;
    
  pageData
  : ThemePageData | null;
  }
  
  type 
  SidebarInfo
   = SidebarFileInfo | SidebarDirInfo;
  
  type 
  SidebarSorterKeyword
   =
    | "readme"
    | "order"
    | "date"
    | "date-desc"
    | "filename"
    | "title";
  
  type 
  SidebarSorterFunction
   = (
    
  infoA
  : 
  SidebarInfo
  ,
    
  infoB
  : 
  SidebarInfo
  ,
  ) => number;
  
  type 
  SidebarSorter
   =
    | 
  SidebarSorterFunction
  
    | 
  SidebarSorterFunction
  []
    | 
  SidebarSorterKeyword
  
    | 
  SidebarSorterKeyword
  [];

• Default: ["readme", "order", "title", "filename"]

Structure sidebar sorter.

You can:

• fill in a custom function
• provide one sorter keyword
• provide an array of custom function or sorter keyword

Available keywords are:

• readme: README.md or readme.md first
• order: positive order first with its value ascending, negative order last with its value descending
• date: sort by date ascending
• date-desc: sort by date descending
• title: alphabetically sort by title
• filename: alphabetically sort by filename

Headings

headerDepth

• Type: number
• Default: 2
• Details:
  • Layout → Page

Nested headings depth.

Route Navigation

breadcrumb

• Type: boolean
• Default: true

Whether enable route navigation globally.

breadcrumbIcon

• Type: boolean
• Default: true

Whether show icons in route navigation

prevLink

• Type: boolean
• Default: true

Whether show prevLink in bottom.

nextLink

• Type: boolean
• Default: true

Whether show nextLink in bottom.

Title

titleIcon

• Type: boolean
• Default: true

Whether display icon besides page title

pageInfo

• Type: ArticleInfo[] | false
• Default: ["Author", "Original", "Date", "Category", "Tag", "ReadingTime"]

Article information. The order of the items decides the display order. Fill in false to disable it.

Available items in ArticleInfo:

• "Author": author
• "Date": writing date
• "Original": is original
• "Category": category
• "Tag": tags
• "ReadingTime": expect reading time
• "Word": word number for the article
• "PageView": pageviews

Meta

lastUpdated

• Type: boolean
• Default: true

Whether to show "Last Updated" or not.

contributors

• Type: boolean
• Default: true

Whether to show "Contributors" or not.

changelog

• Type: boolean
• Default: true

Whether to show changelog.

editLink

• Type: boolean
• Default: true

Whether to show "Edit this page" or not.

editLinkPattern

• Type: string

Pattern of edit link. While :repo :branch :path will be automatically replaced by docsRepo docsBranch and docsDir + filePath。

docsRepo

• Type: string
• Default: repo

The repo of your docs

docsBranch

• Type: string
• Default: "main"

The branch of your docs

docsDir

• Type: string
• Default: ""

Docs dir location in repo

Footer

footer

• Type: string
• Required: No

The default content for the footer, can accept HTMLString.

copyright

• Type: string | false
• Default: "Copyright © <author>"

The default copyright info, set it to false to disable it by default.

displayFooter

• Type: boolean
• Default: false

Whether to display footer by default.

Others

home

• Type: string
• Default: Key of current locale

Home path of current locale, used as the link of back-to-home and navbar logo.

rtl

• Type: boolean
• Default: false

Whether to use RTL layout.

toc

• Type: boolean
• Default: true

Whether show toc list.