博客首页
大约 1 分钟
vuepress-theme-hope
允许你启用博客风格的首页。
博客类型主页
你需要在相应的页面的 frontmatter 中,设置 home: true
和 layout: BlogHome
来使用博客主页。
你可以使用 heroText
设置主标题,并通过 tagline
设置副标题。
如果你有一个 Logo,你可以将其放置在 public
文件夹中,并通过 heroImage
设置它,如果你在夜间模式希望展示另一个 Logo, 可以使用 heroImageDark
。为了更好的 A11y,我们建议你设置 Logo 的描述到 heroAlt
。
你可以通过 bgImage
和 bgImageDark
设置背景图片,但需要注意必须填入完整 URL 或绝对路径。如果你希望信息全屏展示,你可以设置 heroFullScreen: true
。
如果你需要定制一些样式,你可以通过 heroImageStyle
和 bgImageStyle
设置 Logo 与背景图片的样式。
通常情况下,你可能希望在主页中展示一些项目、书籍、文章、链接、友链等。你可以通过 projects
设置它们,它是一个数组,每个元素都是一个对象,包含以下键值:
name
: 项目名称,必填link
: 项目链接,必填,填入外部链接或绝对路径。desc
: 项目描述,选填icon
: 图标,可填入完整路径或绝对路径的图片链接、图标 FontClass 等。同时提供了如下内置图标支持:
"link"
、"project"
、"book"
、"article"
、"friend"
相关信息
关于完整的配置项目,请参见 博客主页 Frontmatter 配置。