初入茅庐-第一篇博文
初入茅庐-第一篇博文
White Black文章写作介绍
Front-matter 是平时写文章时使用的 markdown 格式文件顶部以 ——- 分隔区域的内容，这部分内容包含一些关键信息，主要用于指定文章或者页面的属性特征，其中又分为两种，文章配置和页面配置，首先介绍一下文章页配置 ：
一、Post Front-matter-文章页顶部区域可选内容
| 字段名 | 说明 |
|---|---|
| title | 【必需】文章标题 |
| date | 【必需】文章创建日期 |
| updated | 【可选】文章更新日期 |
| tags | 【可选】文章标签 |
| categories | 【可选】文章分类 |
| keywords | 【可选】文章关键字 |
| description | 【可选】文章描述 |
| top_img | 【可选】文章顶部图片 |
| cover | 【可选】文章缩略图（如果没有设置 top_img，文章页顶部将显示缩略图；可设为 false、图片地址或留空） |
| comments | 【可选】显示文章评论模块（默认 true） |
| toc | 【可选】显示文章 TOC（默认为设置中 toc 的 enable 配置） |
| toc_number | 【可选】显示 toc_number（默认为设置中 toc 的 number 配置） |
| toc_style_simple | 【可选】显示 toc 简洁模式 |
| copyright | 【可选】显示文章版权模块（默认为设置中 post_copyright 的 enable 配置） |
| copyright_author | 【可选】文章版权模块的文章作者 |
| copyright_author_href | 【可选】文章版权模块的文章作者链接 |
| copyright_url | 【可选】文章版权模块的文章链接 |
| copyright_info | 【可选】文章版权模块的版权声明文字 |
| mathjax | 【可选】显示 mathjax（当设置 mathjax 的 per_page: false 时，才需要配置，默认 false） |
| katex | 【可选】显示 katex（当设置 katex 的 per_page: false 时，才需要配置，默认 false） |
| aplayer | 【可选】在需要的页面加载 aplayer 的 js 和 css，请参考文章下面的音乐配置 |
| highlight_shrink | 【可选】配置代码框是否展开（true/false）（默认为设置中 highlight_shrink 的配置） |
| aside | 【可选】显示侧边栏（默认 true） |
| swiper_index | 【可选】首页轮播图配置 index 索引，数字越小越靠前 |
| top_group_index | 【可选】首页右侧卡片组配置，数字越小越靠前 |
| ai | 【可选】文章ai摘要 |
| main_color | 【可选】文章主色，必须是16进制颜色且有6位，不可缩减，例如#ffffff 不可写成#fff |
根据上面表格，其中 title、date分别代表文章标题和日期，是必须要填写的内容，但是平时一般也会选择增加tags、cover、categories内容，其中cover 代表文章封面展示图，只需要输入图片链接即可，但是 tags（标签） 和 categories（分类） 的设置需要根据具体情况，接下来将详细介绍。
1、tags-文章标签
写文章时可以在tags注明文章标签，同一篇文章可以设置一个或者多个标签，比如 tags: 你好，如果有多个标签，需要这样表示：**tags: [实用工具,初入茅庐]*；填写标签后，这些标签会显示在文章预览封面的底部，比如 # 实用工具、# 初入茅庐* ，同时会在界面右侧公告的下方显示这些标签。
2、categories-文章分类
在categories中可以填写文章的分类，比如 categories: 分享，categories: 学习，填写后，这些分类标签将会显示在主界面文章上方的分类栏中。同时点击顶部的分类将会进入一个新的页面，在这个新的页面里会显示目前所有的分类标签。
（1）目前主界面顶部导航栏包含开源项目、网站集，随笔、资源四个子目录，我将一个一个介绍如果想要将文章归到其中一类，该如何去书写文章的 categories 标签：
- 开源项目：categories: 开源
- 网站集：categories: 网站
- 随笔：categories: 随笔
- 资源：categories: 资源
（2）除此之外，主界面左侧技能点轮播图下方包含三个额外分类，分别为：热爱分享、求知学习、闲记随笔。接下来介绍一下这三个分类的 categories该如何书写：
- 热爱分享：categories: 分享
- 求知学习：categories: 学习
- 闲记随笔：categories: 闲记
点击不同的分类入口，将会进入新的界面，此界面将会展示该分类下所有文章，因此在写作时注意分类标签的正确填写。
二、Page Front-matter 用于页面配置
以下为进行页面配置时需要填写的一些标签，仅供参考。
| 字段名 | 说明 |
|---|---|
| title | 【必需】页面标题 |
| date | 【必需】页面创建日期 |
| type | 【必需】页面类型，用于标签、分类、关于、音乐馆、友情链接、相册、相册详情、朋友圈、即刻等页面 |
| updated | 【可选】页面更新日期 |
| description | 【可选】页面描述 |
| keywords | 【可选】页面关键字 |
| comments | 【可选】显示页面评论模块（默认 true） |
| top_img | 【可选】页面顶部图片 |
| mathjax | 【可选】显示 MathJax（当设置 mathjax 的 per_page: false 时才需配置；默认 false） |
| katex | 【可选】显示 KaTeX（当设置 katex 的 per_page: false 时才需配置；默认 false） |
| aside | 【可选】显示侧边栏（默认 true） |
| aplayer | 【可选】在需要的页面加载 aplayer 的 js 和 css，请参考文章下面的音乐配置 |
| highlight_shrink | 【可选】配置代码框是否展开（true/false）（默认为设置中 highlight_shrink 的配置） |
| top_single_background | 【可选】部分页面的顶部模块背景图片 |
