从零开始搭建个人博客（三）

Higanbana
409 阅读6分钟

Front-matter

Front-matter 是 markdown 文件最上方以 --- 分隔的区域，用于指定个别档案的变数。

  • Page Front-matter 用于页面配置
  • Post Front-matter 用于文章页配置

如果标注可选的参数，可根据自己需要添加，不用全部都写在 markdown 里

Page Front-matter

---
title:
date:
updated:
type:
comments:
description:
keywords:
top_img:
mathjax:
katex:
aside:
aplayer:
highlight_shrink:
random:
---
写法解释
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的配置)
random【可选】配置友情链接是否随机排序（默认为 false)

Post Front-matter

---
title:
date:
updated:
tags:
categories:
keywords:
description:
top_img:
comments:
cover:
toc:
toc_number:
toc_style_simple:
copyright:
copyright_author:
copyright_author_href:
copyright_url:
copyright_info:
mathjax:
katex:
aplayer:
highlight_shrink:
aside:
abcjs:
---
写法解释
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)
abcjs【可选】加载 abcjs (当设置 abcjs 的 per_page: false 时，才需要配置，默认 false )

标签页

  1. 前往你的 Hexo 博客的根目录

  2. 输入 hexo new page tags

  1. 你会找到 source/tags/index.md 这个文件

  2. 修改这个文件：

    记得添加 type: "tags"

---
title: 标签
date: 2023-07-12 05:18:10
type: "tags"
orderby: random
order: 1
---
参数解释
type【必须】页面类型，必须为 tags
orderby【可选】排序方式 ：random/name/length
order【可选】排序次序： 1, asc for ascending; -1, desc for descending

分类页

  1. 前往你的 Hexo 博客的根目录

  2. 输入 hexo new page categories

  1. 你会找到 source/categories/index.md 这个文件

  2. 修改这个文件：

    记得添加 type: "categories"

---
title: 分类
date: 2023-07-12 05:23:18
type: "categories"
---

友情链接

为你的博客创建一个友情链接！

创建友情链接页面

  1. 前往你的 Hexo 博客的根目录

  2. 输入 hexo new page link

  1. 你会找到 source/link/index.md 这个文件

  2. 修改这个文件：

    记得添加 type: "link"

---
title: 友情链接
date: 2023-07-12 05:24:56
type: "link"
---

友情链接添加

{% tabs test1 %}

在Hexo博客目录中的 source/_data（如果没有 _data 文件夹，请自行创建），创建一个文件 link.yml

- class_name: 本站
  class_desc: 交换友链可在下方评论，或者微信/QQ联系我
  link_list:
    - name: Higanbana
      link: https://higanbana-0.github.io
      avatar: http://higanbana-0/img/avatar.jpg
      descr: 希望成为一个有趣的人

- class_name: 友情链接
  class_desc: 那些人，那些事
  link_list: 
    - name: 唐志远の博客
      link: https://fe32.top/
      avatar: https://bu.dusays.com/2022/01/14/cd5ffd485f867.jpg
      descr: 古今之成大事者，不惟有超世之才，亦必有坚忍不拔之志。
      
    - name: 海拥
      link: https://haiyong.site
      avatar: https://haiyong.site/img/favicon.png
      descr: 一个乐于分享技术与快乐的博主

class_name 和 class_desc 支持 html 格式书写，如不需要，也可以留空。

从 4.0.0 开始，支持从远程加载友情链接，远程拉取只支持 json。

注意： 选择远程加载后，本地生成的方法会无效。

在 source/link/index.md 这个文件的 front-matter 添加远程链接

flink_url: xxxxx

Json 的格式

[
  {
    "class_name": "本站",
    "class_desc": "交换友链可在下方评论，或者微信/QQ联系我",
    "link_list": [
      {
        "name": "Higanbana",
        "link": "https://higanbana-0.github.io", 
        "avatar": "http://higanbana-0/img/avatar.jpg",
        "descr": "希望成为一个有趣的人"
      }
    ]
  },
  {
    "class_name": "友情链接",
    "class_desc": "那些人，那些事",
    "link_list": [
      {
        "name": "唐志远の博客",
        "link": "https://fe32.top/",
        "avatar": "https://bu.dusays.com/2022/01/14/cd5ffd485f867.jpg",
        "descr": "古今之成大事者，不惟有超世之才，亦必有坚忍不拔之志。"
      },
      {
        "name": "海拥",
        "link": "https://haiyong.site",
        "avatar": "https://haiyong.site/img/favicon.png",
        "descr": "一个乐于分享技术与快乐的博主"
      }
    ]
  }
]

{% endtabs %}

友情链接随机排序

主题支持友情链接随机排序，只需要在顶部 front-matter 添加 random: true

友情链接界面设置

由 2.2.0 起，友情链接界面可以由用户自己自定义，只需要在友情链接的link.md设置就行，以普通的Markdown格式书写。

图库

图库页面只是普通的页面，你只需要 hexo new page xxxxx 创建你的页面就行

然后使用标签外挂 galleryGroup，具体用法请查看对应的内容。

<div class="gallery-group-main">
{% galleryGroup '壁纸' '收藏的一些壁纸' '/Gallery/wallpaper' https://i.loli.net/2019/11/10/T7Mu8Aod3egmC4Q.png %}
{% galleryGroup '漫威' '关于漫威的图片' '/Gallery/marvel' https://i.loli.net/2019/12/25/8t97aVlp4hgyBGu.jpg %}
{% galleryGroup 'OH MY GIRL' '关于OH MY GIRL的图片' '/Gallery/ohmygirl' https://i.loli.net/2019/12/25/hOqbQ3BIwa6KWpo.jpg %}
</div>
{% galleryGroup '壁纸' '收藏的一些壁纸' '/Gallery/wallpaper' https://i.loli.net/2019/11/10/T7Mu8Aod3egmC4Q.png %} {% galleryGroup '漫威' '关于漫威的图片' '/Gallery/marvel' https://i.loli.net/2019/12/25/8t97aVlp4hgyBGu.jpg %} {% galleryGroup 'OH MY GIRL' '关于OH MY GIRL的图片' '/Gallery/ohmygirl' https://i.loli.net/2019/12/25/hOqbQ3BIwa6KWpo.jpg %}

子页面

子页面也是普通的页面，你只需要 hexo n page xxxxx 创建你的页面就行

然后使用标签外挂 gallery，具体用法请查看对应的内容。

{% gallery %}
![](https://i.loli.net/2019/12/25/Fze9jchtnyJXMHN.jpg)
![](https://i.loli.net/2019/12/25/ryLVePaqkYm4TEK.jpg)
![](https://i.loli.net/2019/12/25/gEy5Zc1Ai6VuO4N.jpg)
![](https://i.loli.net/2019/12/25/d6QHbytlSYO4FBG.jpg)
![](https://i.loli.net/2019/12/25/6nepIJ1xTgufatZ.jpg)
![](https://i.loli.net/2019/12/25/E7Jvr4eIPwUNmzq.jpg)
![](https://i.loli.net/2019/12/25/mh19anwBSWIkGlH.jpg)
![](https://i.loli.net/2019/12/25/2tu9JC8ewpBFagv.jpg)
{% endgallery %}

{% gallery %} {% endgallery %}

如果你想要使用 /photo/ohmygirl 这样的链接显示你的图片内容 你可以把创建好的 ohmygirl 整个文件夹移到 photo 文件夹里去

404页面

主题内置了一个简单的 404 页面，可在设置中开启

本地预览时，访问出错的网站是不会跳到 404 页面的。

如需本地预览，请访问 http://localhost:4000/404.html

# A simple 404 page
error_404:
  enable: true
  subtitle: "页面没有找到"
  background:
````
avatar
文章
阅读
粉丝