内容

Gungnir
2021-03-31
3 min

# 博客

博客会在首页显示。所有博客都需要放在 posts/ 文件夹下,文件名格式为 ${年}-${月}-${日}-${随便什么名字}.md,如 2020-03-31-a-brief-history-of-time,然后该博客会被渲染在网站的 /post/2020/03/31/a-brief-history-of-time/ 路径下。

然后需要配置它的 front-matter

---
title: A Brief History of Time  # 博客标题(必须)
subtitle: From the Big Bang to Black Holes  # 博客副标题(可选)
date: 2020-03-31  # 博客日期,会显示在文章头部(可选)
author: Stephen Hawking  # 博客作者(可选,不填的话会使用 `themeConfig.personalInfo.name`)
header_style: image  # 是否在博客中显示封面图:`image`(显示) / `text`(不显示)(可选,默认为 `text`)
header_img: /img/test.jpg  # 博客封面图(必须,即使上一项选了 `text`,图片也需要在首页显示)
header_mask: rgba(40, 57, 101, .4)  # 封面图遮罩(可选)
catalog: true  # 是否启用右侧目录:false / true(可选,默认为 false)
tags:  # 博客标签
  - space
  - physics
---

注意

title 会作为一级标题在博客中显示,所以不需要在博客正文中写一级标题

提示

front-matter 中有 tags 项的博客会在标签页显示。

# 文档

同时本主题也保留了 VuePress 的文档功能,基本的使用方法及侧边栏配置方法请参考VuePress 文档

文档的 front-matter 格式为:

---
title: A Brief History of Time  # 文档标题(必须)
date: 2020-03-31  # 文档日期,会显示在文章头部(可选)
author: Stephen Hawking  # 文档作者(可选,不填的话会使用 `themeConfig.personalInfo.name`)
---

注意

同样,title 会作为一级标题在文档中显示,所以也不需要在文档正文中写一级标题

# Markdown 语法

请参考:

这里展示一下本主题默认支持的容器用法:

信息

This is an info message.

提示

This is a tip message.

注意

This is a warning message.

警告

This is a dangerous warning message.

Show me the code.
cout << "Hello World!" << "\n";