默认主题配置 |
您所在的位置：网站首页 › 华为nova7se自定义壁纸需要多大内存才够用 › 默认主题配置 |
|
默认主题配置 主题配置可以让你能够自定义主题。可以通过将 themeConfig 添加到配置文件来进行主题配置： tsexport default { lang: 'en-US', title: 'VitePress', description: 'Vite & Vue powered static site generator.', // 主题相关配置 themeConfig: { logo: '/logo.svg', nav: [...], sidebar: { ... } } }此页面上记录的选项仅适用于默认主题。不同的主题需要不同的主题配置。使用自定义主题时，主题配置对象将传递给主题，以便主题可以基于它作出不同表现。 i18nRouting 类型：boolean将本地语言更改为 zh 会将 URL 从 /foo（或 /en/foo/）更改为 /zh/foo。可以通过将 themeConfig.i18nRouting 设置为 false 来禁用此行为。 logo 类型：ThemeableImage导航栏上显示的 Logo，位于站点标题前。可以接受一个路径字符串，或者一个对象来设置在浅色/深色模式下不同的 Logo。 tsexport default { themeConfig: { logo: '/logo.svg' } }tstype ThemeableImage = | string | { src: string; alt?: string } | { light: string; dark: string; alt?: string }siteTitle 类型：string | false可以自定义此项以替换导航中的默认站点标题 (应用配置中的 title)。当设置为 false 时，导航中的标题将被禁用。这在当 logo 已经包含站点标题文本时很有用。 tsexport default { themeConfig: { siteTitle: 'Hello World' } }nav 类型：NavItem导航菜单项的配置。可以在默认主题: 导航栏 了解更多详情。 tsexport default { themeConfig: { nav: [ { text: 'Guide', link: '/guide' }, { text: 'Dropdown Menu', items: [ { text: 'Item A', link: '/item-1' }, { text: 'Item B', link: '/item-2' }, { text: 'Item C', link: '/item-3' } ] } ] } }tstype NavItem = NavItemWithLink | NavItemWithChildren interface NavItemWithLink { text: string link: string activeMatch?: string target?: string rel?: string noIcon?: boolean } interface NavItemChildren { text?: string items: NavItemWithLink[] } interface NavItemWithChildren { text?: string items: (NavItemChildren | NavItemWithLink)[] activeMatch?: string }sidebar 类型：Sidebar侧边栏菜单项的配置。可以在默认主题: 侧边栏了解更多详情。 tsexport default { themeConfig: { sidebar: [ { text: 'Guide', items: [ { text: 'Introduction', link: '/introduction' }, { text: 'Getting Started', link: '/getting-started' }, ... ] } ] } }tsexport type Sidebar = SidebarItem[] | SidebarMulti export interface SidebarMulti { [path: string]: SidebarItem[] } export type SidebarItem = { /** * 侧边栏项的文本标签 */ text?: string /** * 侧边栏项的链接 */ link?: string /** * 侧边栏项的子项 */ items?: SidebarItem[] /** * 如果未指定，侧边栏组不可折叠 * * 如果为 `true`，则侧边栏组可折叠并且默认折叠 * * 如果为 `false`，则侧边栏组可折叠但默认展开 */ collapsed?: boolean }aside 类型：boolean | 'left'默认值：true每个页面可以通过 frontmatter 覆盖将此值设置为 false 可禁用 aside 容器。 将此值设置为 true 将在页面右侧渲染。 将此值设置为 left 将在页面左侧渲染。 如果想对所有页面禁用它，应该使用 outline: false。 outline 类型：Outline | Outline['level'] | false每个页面可以通过 frontmatter 覆盖层级将此值设置为 false 可禁止渲染大纲容器。更多详情请参考该接口： tsinterface Outline { /** * outline 中要显示的标题级别。 * 单个数字表示只显示该级别的标题。 * 如果传递的是一个元组，第一个数字是最小级别，第二个数字是最大级别。 * `'deep'` 与 `[2, 6]` 相同，将显示从 `` 到 `` 的所有标题。 * * @default 2 */ level?: number | [number, number] | 'deep' /** * 显示在 outline 上的标题。 * * @default 'On this page' */ label?: string }socialLinks 类型：SocialLink[]可以定义此选项以在导航栏中展示带有图标的社交帐户链接。 tsexport default { themeConfig: { socialLinks: [ { icon: 'github', link: 'https://github.com/vuejs/vitepress' }, { icon: 'twitter', link: '...' }, // 可以通过将 SVG 作为字符串传递来添加自定义图标： { icon: { svg: 'Dribbble' }, link: '...', // 也可以为无障碍添加一个自定义标签 (可选但推荐): ariaLabel: 'cool link' } ] } }tsinterface SocialLink { icon: SocialLinkIcon link: string ariaLabel?: string } type SocialLinkIcon = | 'discord' | 'facebook' | 'github' | 'instagram' | 'linkedin' | 'mastodon' | 'npm' | 'slack' | 'twitter' | 'x' | 'youtube' | { svg: string }footer 类型：Footer可以通过 frontmatter 进行覆盖。页脚配置。可以添加 message 和 copyright。由于设计原因，仅当页面不包含侧边栏时才会显示页脚。 tsexport default { themeConfig: { footer: { message: 'Released under the MIT License.', copyright: 'Copyright © 2019-present Evan You' } } }tsexport interface Footer { message?: string copyright?: string }editLink 类型：EditLink每个页面可以通过 frontmatter 覆盖编辑链接可让显示链接以编辑 Git 管理服务 (例如 GitHub 或 GitLab) 上的页面。有关详细信息，请参阅默认主题：编辑链接。 tsexport default { themeConfig: { editLink: { pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path', text: 'Edit this page on GitHub' } } }tsexport interface EditLink { pattern: string text?: string }lastUpdated 类型：LastUpdatedOptions允许自定义上次更新的文本和日期格式。 tsexport default { themeConfig: { lastUpdated: { text: 'Updated at', formatOptions: { dateStyle: 'full', timeStyle: 'medium' } } } }tsexport interface LastUpdatedOptions { /** * @default 'Last updated' */ text?: string /** * @default * { dateStyle: 'short', timeStyle: 'short' } */ formatOptions?: Intl.DateTimeFormatOptions & { forceLocale?: boolean } }algolia 类型：AlgoliaSearch支持使用 Algolia DocSearch 搜索站点文档。在默认主题：搜索 中了解更多信息。 tsexport interface AlgoliaSearchOptions extends DocSearchProps { locales?: Record }在这里查看完整配置。 carbonAds 类型：CarbonAdsOptions一个配置即可展示 Carbon Ads。 tsexport default { themeConfig: { carbonAds: { code: 'your-carbon-code', placement: 'your-carbon-placement' } } }tsexport interface CarbonAdsOptions { code: string placement: string }在 Default Theme: Carbon Ads 中了解更多信息。 docFooter 类型：DocFooter可用于自定义出现在上一页和下一页链接上方的文本。如果不是用英语编写文档，这很有帮助。也可用于全局禁用上一页/下一页链接。如果想有选择地启用/禁用上一个/下一个链接，可以使用 frontmatter。 tsexport default { themeConfig: { docFooter: { prev: 'Pagina prior', next: 'Proxima pagina' } } }tsexport interface DocFooter { prev?: string | false next?: string | false }darkModeSwitchLabel 类型：string默认值：Appearance用于自定义深色模式开关标签，该标签仅在移动端视图中显示。 lightModeSwitchTitle 类型：string默认值：Switch to light theme用于自定义悬停时显示的浅色模式开关标题。 darkModeSwitchTitle 类型：string默认值：Switch to dark theme用于自定义悬停时显示的深色模式开关标题。 sidebarMenuLabel 类型：string默认值：Menu用于自定义侧边栏菜单标签，该标签仅在移动端视图中显示。 returnToTopLabel 类型：string默认值：Return to top用于自定义返回顶部按钮的标签，该标签仅在移动端视图中显示。 langMenuLabel 类型：string默认值：Change language用于自定义导航栏中语言切换按钮的 aria-label，仅当使用 i18n 时才使用此选项。 externalLinkIcon 类型：boolean默认值：false是否在 markdown 中的外部链接旁显示外部链接图标。 |
今日新闻 |
推荐新闻 |
| CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |